高德地图 API 的简易使用

1. 注册个人开发者

到 http://lbs.amap.com/ 注册个人开发者，创建新应用，申请 Key

SHA1获取方式：

双击 signingReport，

在 Android Studio 下方控制台中找到 SHAI

在这里为了方便可以将 发布版安全码 和 测试版安全码 填同一个 SHA1。

获取 PackageName：
在 build.gradle 中找到 applicationId 即是 包名

2. 下载相应的 SDK

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

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

定位SDK 只需要解压其中的一个 jar 包

地图SDK 需解压以下文件

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

4. 配置 AndroidManifest.xml

    <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 标签中加入如下内容：

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

5. 初始化地图容器

MapView 是 AndroidView 类的一个子类， 用于在 AndroidView 中放置地图。 MapView 是地图容器。用 MapView 加载地图的方法与 Android 提供的其他 View 一样.

在布局xml文件中添加地图控件：

<com.amap.api.maps.MapView

    android:id="@+id/map"

    android:layout_width="match_parent"

    android:layout_height="match_parent"/>

在 MainActivity 中声明一个 MapView

MapView mMapView = null;

在 onCreate 中实例化：

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

完善地图生命周期：

  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);
  } 
}

显示地图

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

6. 显示定位蓝点

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种模式：

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，并添加刷新事件：

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();
                }
            }
        });
}

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

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); //禁止旋转