高德地图 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)); //设置缩放级别为17aMap.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); //禁止旋转