项目地址：[Niko2727/Amap: A simple map demo, using Amap sdk (github.com)](https://github.com/Niko2727/Amap) # 1. 概述一个简单的地图演示，使用高德地图SDK实现。目前有两个页面，定位和导航。在定位页面，您可以在地图上查看您当前的位置，并在2D和3D视图之间切换。当您在地图上选择一个位置时，页面底部会出现三个按钮，用于步行、驾车和骑行。通过点击它们，您可以选择如何导航到您选择的位置。 location page

在导航页面，您可以跟随地图上的路线到达目的地。 location page

# 2. Android 高德SDK 如果您想了解高德SDK的完整内容，可以查看[官方网站](https://lbs.amap.com/api/android-sdk/summary)。 ## 2.1 获取高德key 点击[链接](https://lbs.amap.com/dev/#/)申请高德key 1. 点击页面左侧的"**我的应用**" ![image.png](https://p1-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/68135369cc854b4fa54b1efe715decb5~tplv-k3u1fbpfcp-jj-mark:0:0:0:0:q75.image#?w=458&h=584&s=30015&e=png&b=ffffff) 2. 点击页面右侧的"**创建新应用**" ![image.png](https://p6-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/852ad54568d34da0ac2ec7a195cb1358~tplv-k3u1fbpfcp-jj-mark:0:0:0:0:q75.image#?w=534&h=142&s=10398&e=png&b=fafbfc) 创建应用后，点击添加key并填写应用信息。 ![image.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/9ece8b05bd824edc98ac766362480efa~tplv-k3u1fbpfcp-jj-mark:0:0:0:0:q75.image#?w=1412&h=1368&s=199188&e=png&b=fefefe) ## 2.2 在主项目的build.gradle文件中配置依赖 ```gradle implementation("com.amap.api:3dmap:latest.integration") ``` ## 2.3 添加高德key 为了确保高德Android SDK功能的常规使用，您需要申请高德Key并将其配置到项目中。在项目的"AndroidManifest.xml"文件中，添加以下代码： ``` xml

……

``` ## 2.4 配置权限在AndroidManifest.xml中配置权限： ``` xml

``` ## 2.5 隐私合规接口在构建MapView之前必须执行合规性检查。在设置接口之前，确保隐私政策合规。检查接口如下： ```kotlin MapsInitializer.updatePrivacyShow(context,true,true); MapsInitializer.updatePrivacyAgree(context,true); ``` # 3. 定位页面 ## 3.1 初始化地图容器 MapView是AndroidView类的子类，用于在Android视图中放置地图。MapView是地图容器。使用MapView加载地图的方法与其他由Android提供的视图相同。具体使用步骤如下：首先在布局xml文件中添加地图控件： ```xml ``` 在使用项目中的地图时，需要注意合理管理地图生命周期，这非常重要。以下示例简要概述了地图生命周期管理： ``` java public class MainActivity extends Activity { MapView mMapView = null; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); mMapView = (MapView) findViewById(R.id.map); mMapView.onCreate(savedInstanceState); } @Override protected void onDestroy() { super.onDestroy(); mMapView.onDestroy(); } @Override protected void onResume() { super.onResume(); mMapView.onResume(); } @Override protected void onPause() { super.onPause(); mMapView.onPause(); } @Override protected void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); mMapView.onSaveInstanceState(outState); } } ``` ## 3.2 显示地图 AMap类是地图的控制器类，用于操作地图。它承担的任务包括：切换地图图层（如卫星图像、夜间地图）、更改地图状态（地图旋转角度、俯仰角度、中心点坐标和缩放级别）、添加点标记（Marker）、绘制几何图形（Polyline、Polygon、Circle）、各种事件监控（点击、手势等），AMap是地图SDK最重要的核心类，许多操作都依赖它来完成。 MapView对象初始化后，构建AMap对象。示例代码如下： ```java mapView = (MapView) findViewById(R.id.map); mapView.onCreate(savedInstanceState); AMap aMap; if (aMap == null) { aMap = mapView.getMap(); } ``` ## 3.3 显示定位蓝点 ```kotlin val locationStyle = MyLocationStyle() //Initialize positioning blue dot style class locationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE) // Positioning blue dot display mode with(map) { myLocationStyle = locationStyle //Set the Style for positioning the blue dot isMyLocationEnabled = true // Set to true to start displaying the positioning blue dot, false to hide the positioning blue dot and not perform positioning. The default is false. setOnMapLoadedListener { showMapText(true) showIndoorMap(true) showBuildings(true) } moveCamera(CameraUpdateFactory.zoomTo(defaultZoomLevel)) } with(map.uiSettings) { isMyLocationButtonEnabled = false // Sets whether to display the default positioning button. This setting is not required. isZoomControlsEnabled = true } ``` ## 3.4 定位按钮点击定位按钮，您可以切换到定位和跟随模式。 ```kotlin locationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE) // positioning mode locationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_MAP_ROTATE) // following mode map.myLocationStyle = locationStyle map.moveCamera(newCameraPosition(CameraPosition(getUserLatlng(), zoomLevel, tilt, 0f))) // change zoom level and tilt ``` ## 3.5 投影按钮点击定位按钮，您可以切换到2D和3D模式。 ```kotlin private val tilt2D = 0f private val tilt3D = 45f val degree = if (it == MainViewModel.ProjectionStyle.ThreeD) tilt3D else tilt2D map.animateCamera(CameraUpdateFactory.changeTilt(degree)) ``` ## 3.6 选择目的地地图上可点击的位置以POIs的形式存在于代码中。选择目的地的代码如下： ```kotlin map.addOnPOIClickListener {onClickPOI(it)} private fun onClickPOI(poi: Poi) { markerOption.position(poi.coordinate) // display marker on selected position map.addMarker(markerOption).apply { setAnimation(markerAnimation) startAnimation() } } ``` # 4. 导航页面 ## 4.1 启动导航页面启动导航页面需要传入起点和终点位置信息、导航类型以及是否使用真实GPS信号。 ```kotlin fun start(context: Context, start: NaviLatLng, end: NaviLatLng, naviType: AmapNaviType, isGps: Boolean) { val intent = Intent(context, NaviActivity::class.java) intent.putExtra(EXTRA_START, start) intent.putExtra(EXTRA_END, end) intent.putExtra(EXTRA_NAVI_TYPE, naviType.name) intent.putExtra(EXTRA_IS_GPS, isGps) context.startActivity(intent) } ``` ## 4.2 初始化地图容器定义布局，导航需要使用AmapNaviView，而不是定位使用的MapView ```xml ``` 实现AMapNaviView的生命周期 ```java @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mAMapNaviView.onCreate(savedInstanceState); mAMapNaviView.setAMapNaviViewListener(this); } @Override public void onResume() { super.onResume(); mAMapNaviView.onResume(); } @Override public void onPause() { super.onPause(); mAMapNaviView.onPause(); } @Override public void onDestroy() { super.onDestroy(); mAMapNaviView.onDestroy(); } ``` ## 4.3 配置AMapNavi AMapNavi是一个导航控制单元，可以计算两个点之间的路径，并在到达目的地时提供回调。 ```kotlin mapNavi = AMapNavi.getInstance(applicationContext) mapNavi.addAMapNaviListener(naviListener) mapNavi.setEmulatorNaviSpeed(30) mapNavi.setUseInnerVoice(true, true) ``` ## 4.4 计算路线 AMapNavi提供了一个接口，让我们计算步行、骑行和驾车路线。然而，摩托车和电动单车目前是收费的。如果未支付费用，调用时将不会返回结果。 ```kotlin private fun calculateRoute(start: NaviLatLng, end: NaviLatLng, naviType: AmapNaviType) { when (naviType) { AmapNaviType.WALK -> { mapNavi.calculateWalkRoute(start, end) } AmapNaviType.RIDE -> { mapNavi.calculateRideRoute(start, end) } AmapNaviType.MOTORCYCLE -> { mapNavi.calculateEleBikeRoute(start, end) } else -> { calculateDriveRoute(start, end) } } } ``` ## 4.5 开始导航当路径计算成功时，绘制路径并开始导航 1. 绘制路径 ``` kotlin private val naviListener = object : DefaultAmapNaviListener() { override fun onCalculateRouteSuccess(p0: AMapCalcRouteResult?) { super.onCalculateRouteSuccess(p0) // 当重新规划路线时，移除之前的路线 routeOverLay?.removeFromMap() routeOverLay?.destroy() // 获取返回的路线的数组routIDs aMapCalcRouteResult将返回一个或多个路线。 // ps: 多条路线用于选择多条路线，但这里我们只做简单导航。所以我们只绘制一个。 val routIds = p0!!.routeid val routeId = routIds[0] val path = mapNavi.naviPaths[routeId] routeOverLay = RouteOverLay(map, path, this@NaviActivity) routeOverLay?.addToMap() this@NaviActivity.onCalculateRouteSuccess() } override fun onLocationChange(p0: AMapNaviLocation?) { super.onLocationChange(p0) //绘制灰色行驶路线 routeOverLay?.updatePolyline(p0) } } ``` 2. 开始导航 ```kotlin fun onCalculateRouteSuccess() { if (isGps) { mapNavi.startNavi(NaviType.GPS) } else { mapNavi.startNavi(NaviType.EMULATOR) } } ``` ## 4.6 到达目的地到达目的地时显示距离和时间 ```kotlin private val naviListener = object : DefaultAmapNaviListener() { override fun onArriveDestination() { super.onArriveDestination() Log.d(TAG, "onArriveDestination() called") vm.onNaviEnd(this@NaviActivity) } override fun onEndEmulatorNavi() { super.onEndEmulatorNavi() vm.onNaviEnd(this@NaviActivity) } } fun onNaviEnd(context: Context) { val realDuration = getTimeDisplayString(((System.currentTimeMillis() - naviStartTime) / 1000).toInt(), context) val duration = getTimeDisplayString(naviPath!!.allTime, context) val distanceDisplay = getDistanceDisplayString(naviPath!!.allLength, context) val stringBuilder = StringBuilder() stringBuilder.append(context.getString(R.string.distance)).append(":").append(distanceDisplay).append('\n') stringBuilder.append(context.getString(R.string.estimated_duration)).append(":").append(duration).append('\n') stringBuilder.append(context.getString(R.string.real_duration)).append(":").append(realDuration) _naviEndInfo.value = stringBuilder.toString() } ```