百度地图集成步骤及使用中遇到的问题

百度地图集成步骤：

一. 获取开发密钥(AK)

百度地图 SDK开发密钥的申请地址为：http://lbsyun.baidu.com/apiconsole/key

二. 在项目中集成BaiduMap SDK

1. 下载开发包

   选择“基础地图”，

2. 将开发包拷贝至工程

（1）添加jar文件，BaiduLBS_Android.jar文件将其拷贝至工程的app/libs目录下

（2）添加so文件

      有两种方法可以往项目中添加so文件。
     方法一：
    在下载的开发包中拷贝需要的CPU架构对应的so文件文件夹到app/libs目录下

在app目录下的build.gradle文件中android块中配置sourceSets标签，如果没有使用该标签则新增，详细配置代码如下：

sourceSets {
           main {
               jniLibs.srcDir 'libs'
           }
    }

方法二：
     在src/main/目录下新建jniLibs目录（如果您的项目中已经包含该目录不用重复创建），在下载的开发包中拷贝项目中需要的CPU架构对应的so文件文件夹到jniLibs目录

3. 编写混淆文件，打开app目录下的proguard-rules.pro文件，添加如下代码

-keep class com.baidu.** {*;}
-keep class mapsdkvi.com.** {*;}    
-dontwarn com.baidu.**

注意：保证百度类不能被混淆，否则会出现网络不可用等运行时异常

三. 显示地图并定位：

1. 配置AndroidManifest.xml

（1）在<application>中加入如下代码配置开发密钥（AK）

<application>  
    <meta-data  
        android:name="com.baidu.lbsapi.API_KEY"  
        android:value="开发者 key" />  
    <!-- 声明定位的service组件 -->
    <service android:name="com.baidu.location.f"
        android:enabled="true"
        android:process=":remote"/>
</application>

（2） 在<application/>外部添加如下权限声明：

<!-- 访问网络，进行地图相关业务数据请求，包括地图数据，路线规划，POI检索等 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 获取网络状态，根据网络状态切换进行数据请求网络转换 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    
<!-- 读取外置存储。如果开发者使用了so动态加载功能并且把so文件放在了外置存储区域，则需要申请该权限，否则不需要 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- 写外置存储。如果开发者使用了离线地图，并且数据写在外置存储区域，则需要申请该权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 

<!-- 这个权限用于进行网络定位 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 这个权限用于访问GPS定位 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

2. 在布局文件中添加地图容器

<com.baidu.mapapi.map.MapView  
    android:id="@+id/bmapView"  
    android:layout_width="match_parent"  
    android:layout_height="match_parent"  
    android:clickable="true" />

3. 地图初始化

在项目的Application类的onCreate方法中完成SDK的初始化

//在使用SDK各组件之前初始化context信息，传入ApplicationContext   
        SDKInitializer.initialize(this);
        //自4.3.0起，百度地图SDK所有接口均支持百度坐标和国测局坐标，用此方法设置您使用的坐标类型.
        //包括BD09LL和GCJ02两种坐标，默认是BD09LL坐标。
        SDKInitializer.setCoordType(CoordType.BD09LL);

4. 在使用地图的Activity中，管理MapView生命周期

    private MapView bdMapView = null;  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);    
        setContentView(R.layout.activity_main);  
        //获取地图控件引用  
        bdMapView = (MapView) findViewById(R.id.bmapView);  
        requestPermission();
        initMapData();
    }  
    @Override  
    protected void onResume() {  
       super.onResume();  
       //在activity执行onResume时执行mMapView. onResume ()，实现地图生命周期管理  
       bdMapView.onResume();  
    }  
    @Override  
    protected void onPause() {  
      super.onPause();  
      //在activity执行onPause时执行mMapView. onPause ()，实现地图生命周期管理  
      bdMapView.onPause();  
    } 
    @Override  
    protected void onDestroy() {  
      super.onDestroy();  
      //在activity执行onDestroy时执行mMapView.onDestroy()，实现地图生命周期管理  
      if (bdMapView != null) {
            // 退出时销毁定位
            locationClient.unRegisterLocationListener(myLocationListener);
            locationClient.stop();
            // 关闭定位图层
            mBaiduMap.setMyLocationEnabled(false);
            bdMapView.onDestroy();
            bdMapView = null;
        }  
    }  

5. 进入页面，首先申请动态权限

private void requestPermission() {
        if (Build.VERSION.SDK_INT >= 23 ) {

//            isPermissionRequested = true;
            ArrayList<String> permissionsList = new ArrayList<>();
            String[] permissions = {
                    Manifest.permission.ACCESS_NETWORK_STATE,
                    Manifest.permission.INTERNET,
                    Manifest.permission.ACCESS_COARSE_LOCATION,
                    Manifest.permission.ACCESS_FINE_LOCATION,
                    Manifest.permission.CAMERA,
                    Manifest.permission.READ_EXTERNAL_STORAGE,
                    Manifest.permission.WRITE_EXTERNAL_STORAGE,
            };

            for (String perm : permissions) {
                if (PackageManager.PERMISSION_GRANTED != checkSelfPermission(perm)) {
                    permissionsList.add(perm);
                    // 进入到这里代表没有权限.
                }
            }

            if (!permissionsList.isEmpty()) {
                requestPermissions(permissionsList.toArray(new String[permissionsList.size()]), 0);
            }
        }
    }

6. 初始化地图

private BaiduMap mBaiduMap;
private LocationClient locationClient;
private MapStatusUpdate update;
private MyLocationListener myLocationListener;
private void initMapData() {
        mBaiduMap = bdMapView.getMap();
        mBaiduMap.setMapType(BaiduMap.MAP_TYPE_NORMAL);
        //开启地图的定位图层
        mBaiduMap.setMyLocationEnabled(true);
        
        //地图打印信息中定位成功，但一直显示在北京
        //要先设置缩放比例，再进行经纬度的显示，最终就可以定位自己
        // 在MyLocationListener中设置经纬度
        update = MapStatusUpdateFactory.zoomTo(16f);
        mBaiduMap.animateMapStatus(update);


        //通过LocationClient发起定位
        locationClient = new LocationClient(getApplicationContext());
        LocationClientOption option = new LocationClientOption();
        option.setOpenGps(true);
        //可选，设置是否需要地址信息，默认不需要
        option.setIsNeedAddress(true);
        option.setPriority(LocationClientOption.NetWorkFirst); // 设置网络优先
        //可选，默认高精度，设置定位模式，高精度，低功耗，仅设备
        option.setLocationMode(LocationClientOption.LocationMode.Hight_Accuracy);
        //可选，默认gcj02，设置返回的定位结果坐标系
        option.setCoorType("bd09ll");
        //可选，默认0，即仅定位一次，设置发起定位请求的间隔需要大于等于1000ms才是有效的
        option.setScanSpan(1000);
        locationClient.setLocOption(option);

        myLocationListener = new MyLocationListener();
        locationClient.registerLocationListener(myLocationListener);

        //开启地图定位
        locationClient.start();

        mBaiduMap.setMyLocationConfiguration(new MyLocationConfiguration(
                MyLocationConfiguration.LocationMode.NORMAL, true, BitmapDescriptorFactory.fromResource(R.mipmap.icon_gcoding),
                0x0f1679b3, 0xAA00FF00));
    }



    //通过继承抽象类BDAbstractListener并重写其onReceieveLocation方法来获取定位数据，并将其传给MapView
    public class MyLocationListener extends BDAbstractLocationListener {

        @Override
        public void onReceiveLocation(BDLocation bdLocation) {
            if (bdLocation == null || bdMapView == null) {
                return;
            }

            String province = bdLocation.getProvince();    //获取省份
            String city = bdLocation.getCity();    //获取城市
            String district = bdLocation.getDistrict();    //获取区县
            String street = bdLocation.getStreet();    //获取街道信息
            String mAddress = province + city + district + street;
            //获取纬度信息
            double mLatitude = bdLocation.getLatitude();
            //获取经度信息
            double mLongitude = bdLocation.getLongitude();
            float radius = bdLocation.getRadius();    //获取定位精度，默认值为0.0f

            String coorType = bdLocation.getCoorType();
            Log.d(TAG, "bdLocation="+bdLocation+",mAddress="+mAddress+","+radius+","+coorType);
            MyLocationData locationData = new MyLocationData.Builder()
                    .accuracy(bdLocation.getRadius())
                    .direction(bdLocation.getDirection())
//                    .direction(100)
                    .latitude(bdLocation.getLatitude())
                    .longitude(bdLocation.getLongitude())
                    .build();

            mBaiduMap.setMyLocationData(locationData);
            //地图打印信息中定位成功，但一直显示在北京
            //要先设置缩放比例，再进行经纬度的显示，最终就可以定位自己
            //在init中设置了缩放比例，在这里进行经纬度的显示
            LatLng latLng = new LatLng(mLatitude, mLongitude);
            update = MapStatusUpdateFactory.newLatLng(latLng);
            mBaiduMap.animateMapStatus(update);
        }
    }

四.  使用中遇到的问题：

1. 打包后，第一次定位成功，再次定位没有定位成功，报locType:505

      原因：505错误码的意思是AK错误

      解决方法：使用keytool -list -v -keystore G:\project\nmpaapp\nmpa.jks -alias adcd或使用signingReport方法获取正确的SHA1，配置上即可。

      思路：  获取发布版SHA1时，先是使用命令keytool -list -v -keystore G:\project\nmpaapp\nmpa.jks -alias adcd 获取了SHA1，但看到开发者文档里没有设置别名，就把别名去掉了，重新获取了一次，结果配置上去后，第一次能定位成功，闪一下正确的定位后，就显示空页面了。

在网上查看了获取SHA1码的资料，在build.gradle文件中配置了signingConfigs后，

signingConfigs {
        //你自己的keystore信息
        myConfig {
            storeFile file("../nmpa.jks")
            storePassword "123456"
            keyAlias "adcd"
            keyPassword "123456"
            v2SigningEnabled false
        }
}


buildTypes {
        release {
            //是否混淆
            minifyEnabled false
            //Zipalign优化
            zipAlignEnabled true
            // 移除无用的resource文件
            shrinkResources false
            //签名文件
            signingConfig signingConfigs.myConfig
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

打开android studio的右侧边栏"Gradle"，找到app--->android---->signingReport，双击运行，会出现debug版本和release版本的SHA1,

> Task :app:signingReport
Variant: debug
Config: debug
Store: C:\Users\Administrator\.android\debug.keystore
Alias: AndroidDebugKey
MD5: 
SHA1: 
SHA-256: 
Valid until: 2050年3月4日 星期五

Variant: release
Config: myConfig
Store: G:\project\nmpaapp\nmpa.jks
Alias: adcd
MD5: 
SHA1: 
SHA-256: 
Valid until: 2045年4月11日 星期二

最终发现：使用signingReport方式获取到的发布版SHA1与一开始使用命令keytool -list -v -keystore G:\project\nmpaapp\nmpa.jks -alias adcd获取到的SHA1是一样的。

2. 刚开始运行时，定位不成功，原因：没有动态申请位置权限；

3. 打印信息中显示定位成功，但地图上还是显示北京的地图：

   原因：要先设置缩放比例，再进行经纬度的显示，最终就可以定位自己

   解决：在class MyLocationListener extends BDAbstractLocationListener监听中添加

        MapStatusUpdate update = MapStatusUpdateFactory.zoomTo(16f);
        mBaiduMap.animateMapStatus(update);
        LatLng latLng = new LatLng(mLatitude, mLongitude);
        update = MapStatusUpdateFactory.newLatLng(latLng);
        mBaiduMap.animateMapStatus(update);