高德地图 API 的简易使用

注册个人开发者

http://lbs.amap.com/ 注册个人开发者,创建新应用,申请 Key
SHA1获取方式:
双击 signingReport获取 SHA1
在 Android Studio 下方控制台中找到 SHAI
获取 SHA1
在这里为了方便可以将 发布版安全码 和 测试版安全码 填同一个 SHA1。
获取 PackageName
在 build.gradle 中找到 applicationId 即是 包名


下载相应的 SDK

下载SDK
在这里只下载 地图SDK 和 定位SDK
在相关下载页面中均选择一键下载


下载好压缩包后 解压所需文件

下载好的压缩包

定位SDK 只需要解压其中的一个 jar 包
定位SDK中所需的文件
地图SDK 需解压以下文件
定位SDK中所需要的文件

将解压好的两个 jar 包导入工程目录下的 libs 目录下,选择 add as library 或 Sync Now
在 main 目录下创建文件夹 jniLibs (如果有就不需要创建了),将以下文件导入文件夹中

需要导入 jniLibs 的文件

配置 AndroidManifest.xml

1
2
3
4
5
6
7
8
9
10
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>   <!--用于网络定位-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!--用于 GPS 定位-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <!--用于获取运营商信息,用于支持提供运营商信息相关的接口-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> <!--用于访问wifi网络信息,wifi信息会用于进行网络定位-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> <!--用于获取wifi的获取权限,wifi信息会用来进行网络定位-->
<uses-permission android:name="android.permission.INTERNET"/><!--允许程序打开网络套接字-->
<uses-permission android:name="android.permission.READ_PHONE_STATE"/> <!-- 用于读取手机当前的状态 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> <!--用于写入缓存数据到扩展存储卡-->
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS"/><!--用于申请调用A-GPS模块-->
<uses-permission android:name="android.permission.BLUETOOTH"/> <!-- 用于申请获取蓝牙信息进行室内定位-->

然后,设置刚获取的 Key
在 application 标签中加入如下内容:

1
2
3
<meta-data android:name="com.amap.api.v2.apikey" android:value="key">
//开发者申请的key
</meta-data>


初始化地图容器

MapView 是 AndroidView 类的一个子类, 用于在 AndroidView 中放置地图。 MapView 是地图容器。用 MapView 加载地图的方法与 Android 提供的其他 View 一样.
在布局xml文件中添加地图控件:

1
2
3
4
5
6
7
<com.amap.api.maps.MapView

android:id="@+id/map"

android:layout_width="match_parent"

android:layout_height="match_parent"/>

在 MainActivity 中声明一个 MapView

1
MapView mMapView = null;

在 onCreate 中实例化:

1
2
3
mMapView = (MapView) findViewById(R.id.map);
//在activity执行onCreate时执行mMapView.onCreate(savedInstanceState),创建地图
mMapView.onCreate(savedInstanceState);

完善地图生命周期:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
@Override
protected void onDestroy() {
super.onDestroy();
//在activity执行onDestroy时执行mMapView.onDestroy(),销毁地图
mMapView.onDestroy();
}
@Override
protected void onResume() {
super.onResume();
//在activity执行onResume时执行mMapView.onResume (),重新绘制加载地图
mMapView.onResume();
}
@Override
protected void onPause() {
super.onPause();
//在activity执行onPause时执行mMapView.onPause (),暂停地图的绘制
mMapView.onPause();
}
@Override
protected void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
//在activity执行onSaveInstanceState时执行mMapView.onSaveInstanceState (outState),保存地图当前的状态
mMapView.onSaveInstanceState(outState);
}
}

显示地图

1
2
3
4
5
//初始化地图控制器对象
AMap aMap;
if (aMap == null) {
aMap = mapView.getMap();
}


显示定位蓝点

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
MyLocationStyle myLocationStyle;
myLocationStyle = new MyLocationStyle();//初始化定位蓝点样式类
myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE);//连续定位、且将视角移动到地图中心点,定位点依照设备方向旋转,并且会跟随设备移动。(1秒1次定位)如果不设置myLocationType,默认也会执行此种模式。
myLocationStyle.interval(2000); //设置连续定位模式下的定位间隔,只在连续定位模式下生效,单次定位模式下不会生效。单位为毫秒。

//MyLocationStyle myLocationIcon(BitmapDescriptor myLocationIcon);//设置定位蓝点的icon图标方法,需要用到BitmapDescriptor类对象作为参数。
MyLocationStyle strokeColor(0);//设置定位蓝点精度圆圈的边框颜色的方法。
MyLocationStyle radiusFillColor(0);//设置定位蓝点精度圆圈的填充颜色的方法。

aMap.setMyLocationStyle(myLocationStyle);//设置定位蓝点的Style
//aMap.getUiSettings().setMyLocationButtonEnabled(true);设置默认定位按钮是否显示,非必需设置。
aMap.setMyLocationEnabled(true);// 设置为true表示启动显示定位蓝点,false表示隐藏定位蓝点并不进行定位,默认是false。
//将定位风格设置传给地图控制器
aMap.setMyLocationStyle(myLocationStyle);aMap.setMyLocationEnabled(true);
aMap.moveCamera(CameraUpdateFactory.zoomTo(17)); //设置缩放级别为17
aMap.showIndoorMap(true); //显示室内地图

定位蓝点提供5种模式:

1
2
3
4
5
myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_SHOW);//只定位一次。
myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATE) ;//定位一次,且将视角移动到地图中心点。
myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_FOLLOW) ;//连续定位、且将视角移动到地图中心点,定位蓝点跟随设备移动。(1秒1次定位)
myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_MAP_ROTATE);//连续定位、且将视角移动到地图中心点,地图依照设备方向旋转,定位点会跟随设备移动。(1秒1次定位)
myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE);//连续定位、且将视角移动到地图中心点,定位点依照设备方向旋转,并且会跟随设备移动。(1秒1次定位)默认执行此种模式。

设置定位刷新事件
new 一个 Button,并添加刷新事件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
private void Refresh(){
mLocationClient = new AMapLocationClient(getApplicationContext());
mLocationOption = new AMapLocationClientOption();
mLocationOption.setOnceLocation(true); //设置为单次定位模式
mLocationOption.setNeedAddress(true); //返回地址描述
mLocationOption.setHttpTimeOut(10000); //设置请求超时时间
mLocationClient.setLocationOption(mLocationOption);

//设置定位回调监听器
mLocationClient.setLocationListener(new AMapLocationListener() {
@Override
public void onLocationChanged(AMapLocation aMapLocation) {
if(aMapLocation != null){
LatLng latLng = new LatLng(aMapLocation.getLatitude(), aMapLocation.getLongitude());
if(locationMarker == null){
locationMarker = aMap.addMarker(new MarkerOptions()
.position(latLng)
.icon(BitmapDescriptorFactory.fromResource(R.drawable.center_marker2)));
}else{
locationMarker.setPosition(latLng);
}
//将标记移动到定位点,使用animateCamera就有动画效果
aMap.animateCamera(CameraUpdateFactory.newLatLngZoom(latLng, 17));
}else{
Toast.makeText(MainActivity.this, "定位失败", Toast.LENGTH_SHORT).show();
}
}
});
}

设置地图内的指南针或者缩放按钮等

1
2
3
4
5
6
7
private UiSettings mUiSettings;
mUiSettings = aMap.getUiSettings();
mUiSettings.setZoomControlsEnabled(false); //缩放按钮的显示与隐藏
mUiSettings.setCompassEnabled(false); //指南针的显示与隐藏
mUiSettings.setScaleControlsEnabled(false); //比例尺的显示与隐藏
mUiSettings.setLogoPosition(AMapOptions.LOGO_POSITION_BOTTOM_LEFT); // 设置LOGO位置
mUiSettings.setRotateGesturesEnabled(false); //禁止旋转