高德地图的使用

Android平台高德地图的使用

高德地图 Android SDK 是一套地图开发调用接口，开发者可以轻松地在自己的Android应用中加入地图相关的功能，包括：地图显示（含室内、室外地图）、与地图交互、在地图上绘制、兴趣点搜索、地理编码、离线地图等功能。

账号与Key的申请

https://lbs.amap.com/
登录高德开放平台的网站注册账号并且生成API_KEY。

在AndroidManifest.xml 文件中添加 如下2行代码：

<service android:name="com.amap.api.location.APSService"/>
<meta-data android:name="com.amap.api.v2.apikey" android:value="填入获得的API_KEY"/>

配置权限

在AndroidManifest.xml中配置权限:

//地图包、搜索包需要的基础权限
<!--允许程序打开网络套接字-->
<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" /> 
<!--允许程序读写手机状态和身份-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />     
<!--允许程序访问CellID或WiFi热点来获取粗略的位置-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

jar包的导入

在build.gradle中添加依赖jar包

implementation 'com.amap.api:3dmap:latest.integration' 
implementation 'com.amap.api:location:latest.integration'
implementation 'com.amap.api:search:latest.integration'

地图的显示

在完成了上面的步骤之后，进入正式的高德地图api的应用。

AMap 类是地图的控制器类，用来操作地图。它所承载的工作包括：地图图层切换（如卫星图、黑夜地图）、改变地图状态（地图旋转角度、俯仰角、中心点坐标和缩放级别）、添加点标记（Marker）、绘制几何图形(Polyline、Polygon、Circle)、各类事件监听(点击、手势等)等，AMap 是地图 SDK 最重要的核心类，诸多操作都依赖它完成。
核心代码如下

1.在布局文件中添加一个地图的容器

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

2.在activity中初始化AMap控制器：

//定义了一个地图view
mapView = (MapView) findViewById(R.id.map);
mapView.onCreate(savedInstanceState);
//初始化地图控制器对象
AMap aMap;
if (aMap == null) {
    aMap = mapView.getMap();        
}

显示定位的蓝点

MyLocationStyle myLocationStyle;
myLocationStyle = new MyLocationStyle();//初始化定位蓝点样式类
myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE);//连续定位、且
将视角移动到地图中心点，定位点依照设备方向旋转，并且会跟随设备移动。（1秒1次定位）如果不设置
myLocationType，默认也会执行此种模式。
myLocationStyle.interval(2000); //设置连续定位模式下的定位间隔，只在连续定位模式下生效，单次定位模式
下不会生效。单位为毫秒。
aMap.setMyLocationStyle(myLocationStyle);//设置定位蓝点的Style，可以自定义蓝点的样式
//aMap.getUiSettings().setMyLocationButtonEnabled(true);设置默认定位按钮是否显示，非必需设置。
aMap.setMyLocationEnabled(true);// 设置为true表示启动显示定位蓝点，false表示隐藏定位蓝点并不进行定
位，默认是false。

效果图如下

标记点的绘制

代码如下

LatLng latLng = new LatLng(39.906901,116.397972);
MarkerOptions options = new MarkerOptions();
options.position(latLng);
Marker marker = aMap.addMarker(options);

常用的参数如下

名称	说明
position	在地图上标记位置的经纬度值。必填参数
title	点标记的标题
snippet	点标记的内容
draggable	点标记是否可拖拽
visible	点标记是否可见
anchor	点标记的锚点 //锚点是指点标记图标像素与点标记坐标的关联点
alpha	点的透明度
icon	点的图标