Android 使用高德地图

一、获取高德平台key

【1】基于application包名&sha1值在高德控制台获取key值，详情参考：获取Key-创建工程-开发指南-Android 地图SDK | 高德地图API

【2】在manifest中声明权限

【3】将拿到的key值在manifest中进行声明

<!--允许程序打开网络套接字-->
<uses-permission android:name="android.permission.INTERNET" />
<!--允许程序设置内置sd卡的写权限-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />   
<!--允许程序获取网络状态-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 
<!--允许程序访问WiFi网络信息-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 
<!--允许程序访问CellID或WiFi热点来获取粗略的位置-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<meta-data
            android:name="com.amap.api.v2.apikey"
            android:value="xxxxxxxxxxxx" />

二、集成依赖

在app build.gradle文件中增加高德地图依赖

implementation("com.amap.api:3dmap:9.8.2")

三、显示地图

概述-Android 地图SDK | 高德地图API

在xml文件中声明MapView控件，并在class中重写 onCreate 方法（此方法必须重写），注意生命周期的管理

<com.amap.api.maps.MapView
        android:id="@+id/map"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

private var mapView: MapView? = null

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.test_activity)
    mapView = findViewById(R.id.map)
    mapView?.onCreate(savedInstanceState)
}

override fun onResume() {
    super.onResume()
    mapView?.onResume()
}

override fun onPause() {
    super.onPause()
    mapView?.onPause()
}

override fun onDestroy() {
    super.onDestroy()
    mapView?.onDestroy()
}

override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)
    mapView?.onSaveInstanceState(outState)
}

地图默认中心点为北京天安门

四、高德地图具体使用

以下对于地图的控制使用之前需要拿到AMap对象

map = mapView?.map

1、切换城市中心点

private fun moveCenterTo(latLng: LatLng) {
    val cameraUpdate = CameraUpdateFactory.newLatLng(latLng)
    map?.moveCamera(cameraUpdate)
}

Android高德地图切换城市中心点展示

2、设置缩放级别

moveCamera(CameraUpdateFactory.zoomTo(14.0f))

3、绘制marker

companion object {
    private val MARKER1 = LatLng(40.02855349893361, 116.3052948784071)
    private val MARKER2 = LatLng(41.093445392798934, 116.11030767409169)
}


val marker1: MarkerOptions = MarkerOptions().apply {
    position(MARKER1)
}
val marker2: MarkerOptions = MarkerOptions().apply {
    position(MARKER2)
}

val list = ArrayList<MarkerOptions>()
list.add(marker1)
list.add(marker2)
map?.addMarkers(list, false)

如下图所示，不设置icon默认展示蓝色定位图标。

针对marker可以设置的属性：

position	在地图上标记位置的经纬度值，必填参数
title	点标记的标题
snippet	点标记的内容
draggable	点标记是否可拖拽
visible	点标记是否可见
anchor	点标记的锚点
alpha	点的透明度

public final java.util.ArrayList<Marker> addMarkers(java.util.ArrayList<MarkerOptions> options, boolean moveToCenter)
在地图上添一组图片标记（marker）对象，并设置是否改变地图状态以至于所有的marker对象都在当前地图可视区域范围内显示。

参数:

options - 多个markerOptions对象，它们分别定义了对应marker的属性信息。

moveToCenter - 是否改变地图状态，默认为false。

返回:

返回一组被添加的marker对象。

4、绘制折线

val latLngList = ArrayList<LatLng>()
latLngList.add(MARKER1)
latLngList.add(MARKER2)
map?.addPolyline(
    PolylineOptions().addAll(latLngList).width(3f).color(Color.RED)
)

5、轨迹

SmoothMoveMarker(map).apply {
setDescriptor(BitmapDescriptorFactory.fromResource(R.drawable.smooth))
                setPoints(latLngList)
                setTotalDuration(5)
                startSmoothMove()
            }

6、两点之间距离计算

AMapUtils.calculateLineDistance(latLng1,latLng2)

7、切换地图图层

【1】预设模式

mapType = AMap.MAP_TYPE_NIGHT

【2】在线自定义模式

val options = CustomMapStyleOptions().apply {
    isEnable = true
    styleId = ""
}
map?.setCustomMapStyle(options)

8、手势交互

map?.uiSettings.let {
    it.isRotateGesturesEnabled = false
    it.isZoomControlsEnabled = false
    it.isTiltGesturesEnabled = false
}

更多设置可参考：https://a.amap.com/lbs/static/unzip/Android_Map_Doc/3D/index.html?overview-summary.html

9、地图状态监听

            setOnMapLoadedListener(object : AMap.OnMapLoadedListener {
                override fun onMapLoaded() {
                    Log.e(TAG, "onMapLoaded...")
                }

            })
            //自带放大缩小接口
            setOnCameraChangeListener(object : AMap.OnCameraChangeListener {
                override fun onCameraChange(p0: CameraPosition?) {
                    //Log.e(TAG, "onCameraChange + ${p0?.toString()}")
                }

                override fun onCameraChangeFinish(p0: CameraPosition?) {
                    Log.e(TAG, "onCameraChangeFinish + ${p0?.toString()}")
                }

            })
            //map point点击事件
            addOnMapClickListener(object : AMap.OnMapClickListener {
                override fun onMapClick(p0: LatLng?) {
                    Log.e(TAG, "onMapClick + ${p0?.toString()}")
                }

            })
            //地图自带poi点击事件
            addOnPOIClickListener(object : AMap.OnPOIClickListener {
                override fun onPOIClick(p0: Poi?) {
                    Log.e(TAG, "onPOIClick + ${p0?.toString()}")
                }

            })
            addOnMarkerClickListener(object : AMap.OnMarkerClickListener {
                override fun onMarkerClick(p0: Marker?): Boolean {
                    Log.e(TAG, "onMarkerClick + ${p0?.id}")
                    return true
                }
            })

10、截图功能

拿到bitmap对象进行处理

map?.getMapScreenShot(object : AMap.OnMapScreenShotListener {
    override fun onMapScreenShot(p0: Bitmap?) {
        TODO("Not yet implemented")
    }

    override fun onMapScreenShot(p0: Bitmap?, p1: Int) {
        TODO("Not yet implemented")
    }

})

五、代码

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <com.amap.api.maps.MapView
        android:id="@+id/map"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="20dp"
        android:gravity="center"
        android:orientation="horizontal">

        <TextView
            android:id="@+id/bj"
            android:layout_width="60dp"
            android:layout_height="wrap_content"
            android:background="@drawable/button_bg"
            android:gravity="center"
            android:padding="10dp"
            android:text="北京"
            android:textSize="18dp" />

        <TextView
            android:id="@+id/gz"
            android:layout_width="60dp"
            android:layout_height="wrap_content"
            android:layout_marginLeft="20dp"
            android:background="@drawable/button_bg"
            android:gravity="center"
            android:padding="10dp"
            android:text="广州"
            android:textSize="18dp" />

        <TextView
            android:id="@+id/xa"
            android:layout_width="60dp"
            android:layout_height="wrap_content"
            android:layout_marginLeft="20dp"
            android:background="@drawable/button_bg"
            android:gravity="center"
            android:padding="10dp"
            android:text="西安"
            android:textSize="18dp" />

        <ImageView
            android:id="@+id/share"
            android:layout_width="40dp"
            android:layout_height="40dp"
            android:layout_marginLeft="20dp"
            android:scaleType="fitXY"
            android:src="@drawable/screenshot" />

    </LinearLayout>

</FrameLayout>

package com.example.myapplication

import android.graphics.Bitmap
import android.graphics.Color
import android.location.Location
import android.os.Bundle
import android.util.Log
import android.widget.ImageView
import android.widget.TextView
import androidx.activity.ComponentActivity
import com.amap.api.maps.AMap
import com.amap.api.maps.CameraUpdateFactory
import com.amap.api.maps.MapView
import com.amap.api.maps.model.BitmapDescriptorFactory
import com.amap.api.maps.model.CameraPosition
import com.amap.api.maps.model.LatLng
import com.amap.api.maps.model.Marker
import com.amap.api.maps.model.MarkerOptions
import com.amap.api.maps.model.Poi
import com.amap.api.maps.model.PolylineOptions
import com.amap.api.maps.utils.overlay.SmoothMoveMarker

class TestActivity : ComponentActivity() {

    private var mapView: MapView? = null
    private var map: AMap? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.test_activity)
        initMap(savedInstanceState)
        initView()
    }

    private fun initView() {
        findViewById<TextView>(R.id.bj).setOnClickListener { moveCenterTo(LATLNG_BJ) }
        findViewById<TextView>(R.id.gz).setOnClickListener { moveCenterTo(LATLNG_GZ) }
        findViewById<TextView>(R.id.xa).setOnClickListener { moveCenterTo(LATLNG_XA) }

        findViewById<ImageView>(R.id.share).setOnClickListener {
            map?.getMapScreenShot(object : AMap.OnMapScreenShotListener {
                override fun onMapScreenShot(p0: Bitmap?) {
                    TODO("Not yet implemented")
                }

                override fun onMapScreenShot(p0: Bitmap?, p1: Int) {
                    TODO("Not yet implemented")
                }

            })
        }
    }

    private fun initMap(savedInstanceState: Bundle?) {
        mapView = findViewById(R.id.map)
        mapView?.onCreate(savedInstanceState)
        mapView?.let {
            map = it.map
        }
        map?.apply {
            uiSettings.let {
                it.isRotateGesturesEnabled = false
                it.isZoomControlsEnabled = false
                it.isTiltGesturesEnabled = false
            }
            moveCamera(CameraUpdateFactory.zoomTo(8.0f))

            //自定义图层
//            val options = CustomMapStyleOptions().apply {
//                isEnable = true
//                styleId = ""
//            }
//            setCustomMapStyle(options)

//            mapType = AMap.MAP_TYPE_NIGHT

            setOnMapLoadedListener(object : AMap.OnMapLoadedListener {
                override fun onMapLoaded() {
                    Log.e(TAG, "onMapLoaded...")
                    //AnimatorUtil.obtainLinePointF(mapView, MARKER1, MARKER2)
//                    Handler().postDelayed(object : Runnable{
//                        override fun run() {
//                            AnimatorUtil.obtainLinePointF(mapView, MARKER2, MARKER3)
//                        }
//                    }, 500)
                }

            })
            //自带放大缩小接口
            setOnCameraChangeListener(object : AMap.OnCameraChangeListener {
                override fun onCameraChange(p0: CameraPosition?) {
                    //Log.e(TAG, "onCameraChange + ${p0?.toString()}")
                }

                override fun onCameraChangeFinish(p0: CameraPosition?) {
                    Log.e(TAG, "onCameraChangeFinish + ${p0?.toString()}")
                }

            })
            //map point点击事件
            addOnMapClickListener(object : AMap.OnMapClickListener {
                override fun onMapClick(p0: LatLng?) {
                    Log.e(TAG, "onMapClick + ${p0?.toString()}")
                }

            })
            //地图自带poi点击事件
            addOnPOIClickListener(object : AMap.OnPOIClickListener {
                override fun onPOIClick(p0: Poi?) {
                    Log.e(TAG, "onPOIClick + ${p0?.toString()}")
                }

            })
            addOnMarkerClickListener(object : AMap.OnMarkerClickListener {
                override fun onMarkerClick(p0: Marker?): Boolean {
                    Log.e(TAG, "onMarkerClick + ${p0?.id}")
                    return true
                }
            })

            setOnMyLocationChangeListener(object : AMap.OnMyLocationChangeListener {
                override fun onMyLocationChange(p0: Location?) {
                    Log.e(TAG, "setOnMyLocationChangeListener + ${p0?.toString()}")
                    p0?.let {
                        moveCamera(CameraUpdateFactory.newLatLng(LatLng(it.latitude, it.longitude)))
                    }
                }

            })
            //绘制marker点
            val marker1: MarkerOptions = MarkerOptions().apply {
                position(MARKER1)
            }
            val marker2: MarkerOptions = MarkerOptions().apply {
                position(MARKER2)
            }
            val list = ArrayList<MarkerOptions>()
            list.add(marker1)
            list.add(marker2)
            addMarkers(list, false)


//            val builder = LatLngBounds.builder().apply {
//                include(MARKER1)
//                include(MARKER2)
//                include(MARKER3)
//                include(MARKER4)
//            }
//            val bounds = builder.build()
//            moveCamera(CameraUpdateFactory.newLatLngBounds(bounds, 300))

            //绘制marker折线
            val latLngList = ArrayList<LatLng>()
            latLngList.add(MARKER1)
            latLngList.add(MARKER2)
            addPolyline(
                PolylineOptions().addAll(latLngList).width(3f)
                    .color(Color.RED)
            )

            //轨迹
            SmoothMoveMarker(map).apply {
                setDescriptor(BitmapDescriptorFactory.fromResource(R.drawable.smooth))
                setPoints(latLngList)
                setTotalDuration(5)
                startSmoothMove()
            }

        }

    }

    private fun moveCenterTo(latLng: LatLng) {
        val cameraUpdate = CameraUpdateFactory.newLatLng(latLng)
        map?.moveCamera(cameraUpdate)
    }

    override fun onResume() {
        super.onResume()
        mapView?.onResume()
    }

    override fun onPause() {
        super.onPause()
        mapView?.onPause()
    }

    override fun onDestroy() {
        super.onDestroy()
        mapView?.onDestroy()
    }

    override fun onSaveInstanceState(outState: Bundle) {
        super.onSaveInstanceState(outState)
        mapView?.onSaveInstanceState(outState)
    }

    companion object {
        private const val TAG = "TestActivity"
        private val MARKER1 = LatLng(40.02855349893361, 116.3052948784071)
        private val MARKER2 = LatLng(41.093445392798934, 116.11030767409169)
        private val LATLNG_BJ = LatLng(39.90508988475248, 116.4083842390264)
        private val LATLNG_GZ = LatLng(23.11523439186301, 113.24706837513949)
        private val LATLNG_XA = LatLng(34.321288624880815, 108.94042782381482)
    }
}