Android 地图 —— 2. 百度地图定位

参考链接:

百度地图定位文档:http://lbsyun.baidu.com/index.php?title=android-locsdk/guide/addition-func/error-code

---

1. 导入SDK,配置AK

• 跟上一小节一样,如果已经配置,无序重复.上节文章链接:Android 地图 —— 1. 百度地图的SDK配置

---

2. 导入具体的权限以及定位服务

• 权限声明

<!-- 这个权限用于进行网络定位-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission>
<!-- 这个权限用于访问GPS定位-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
<!-- 用于访问wifi网络信息，wifi信息会用于进行网络定位-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<!-- 获取运营商信息，用于支持提供运营商信息相关的接口-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<!-- 这个权限用于获取wifi的获取权限，wifi信息会用来进行网络定位-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>
<!-- 用于读取手机当前的状态-->
<uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>
<!-- 写入扩展存储，向扩展卡写入数据，用于写入离线定位数据-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
<!-- 访问网络，网络定位需要上网-->
<uses-permission android:name="android.permission.INTERNET" />
<!-- SD卡读取权限，用户写入离线定位数据-->
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"></uses-permission>

• 定位服务 (这个Service在官方提供的SDK已经给出,只需要声明即可)

<service android:name="com.baidu.location.f" android:enabled="true" android:process=":remote"> </service>

---

3. 由于Android6.0(API23)以上的动态权限申请这个原因,我们定位所需的GPS以及网络定位都需要进行危险权限申请处理.

• 判断用户的手机版本是否超过23,如果等于或大于则进行权限申请,如果没有则直接进行定位处理

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M){
            checkPhonePermission();     //检查用户手机有没有这些权限
        }else{
            mLocationClient.start();   //进行定位
        }

• 检查用户手机权限

    /**
     *  检查手机权限是否已经获取
     */
    private void checkPhonePermission() {
        //mPermissionList 是对用户未授权的权限进行保存,便于对这些权限进行重新申请
        mPermissionList.clear();//清空没有通过的权限

        //逐个判断你要的权限是否已经通过
        for (int i = 0; i < permissions.length; i++) {
            if (ContextCompat.checkSelfPermission(this, permissions[i]) != PackageManager.PERMISSION_GRANTED) {
                mPermissionList.add(permissions[i]);//添加还未授予的权限
            }
        }
        //申请权限
        if (mPermissionList.size() > 0) {//有权限没有通过，需要申请
            //将未授权集合转换为数组
            String[] permissions2 = mPermissionList.toArray(new String[mPermissionList.size()]);//将List转为数组
            //申请权限    PERMISSION_REQUEST_CODE  权限申请码
            ActivityCompat.requestPermissions(this, permissions2, PERMISSION_REQUEST_CODE);
        }else{
            //说明权限都已经通过，可以进行定位了
            mLocationClient.start();
        }
    }

• 权限结果回调

    /**
     * 权限结果回调处理
     * @param requestCode
     * @param permissions
     * @param grantResults
     */
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        boolean hasPermissionDismiss = false;//有权限没有通过
        //PERMISSION_REQUEST_CODE  权限申请码
        if (PERMISSION_REQUEST_CODE == requestCode) {
            for (int i = 0; i < grantResults.length; i++) {
                if (grantResults[i] == -1) {
                    hasPermissionDismiss = true;
                }
            }
            //如果有权限没有被允许,如果权限没有允许,可以进行提示,也可以弹出dialog,对用户进行解释,并设置可选操作,让用户跳转去设置,或不显示
            if (hasPermissionDismiss) {
                Toast.makeText(this, "您没有授予权限,请您到系统设置中设置该权限,再重新进行定位", Toast.LENGTH_SHORT).show();;//跳转到系统设置权限页面，或者直接关闭页面，不让他继续访问
            }else{
                //全部权限通过，可以进行定位
                mLocationClient.start();
            }
        }
    }

---

4. 设置定位回调监听

• 新建类 MyLocationListener 继承 BDAbstractLocationListener ,在实现的方法中对回调进过进行处理

public class MyLocationListener extends BDAbstractLocationListener {

    private static final String TAG = MyLocationListener.class.getSimpleName();

    @Override
    public void onReceiveLocation(BDLocation bdLocation) {
        if (bdLocation.getLocType()==61){           //GPS定位结果，GPS定位成功
            //此处的BDLocation为定位结果信息类，通过它的各种get方法可获取定位相关的全部结果
            //以下只列举部分获取经纬度相关（常用）的结果信息
            //更多结果信息获取说明，请参照类参考中BDLocation类中的说明
            double latitude = bdLocation.getLatitude();        //获取纬度信息
            double longitude = bdLocation.getLongitude();      //获取经度信息
            float radius = bdLocation.getRadius();             //获取定位精度，默认值为0.0f
            String coorType = bdLocation.getCoorType();         //获取经纬度坐标类型，以LocationClientOption中设置过的坐标类型为准
            Log.i(TAG,latitude+","+longitude);
        }else if (bdLocation.getLocType()==161){              //网络定位结果，网络定位成功
            //此处的BDLocation为定位结果信息类，通过它的各种get方法可获取定位相关的全部结果
            //以下只列举部分获取经纬度相关（常用）的结果信息
            //更多结果信息获取说明，请参照类参考中BDLocation类中的说明
            double latitude = bdLocation.getLatitude();       //获取纬度信息
            double longitude = bdLocation.getLongitude();     //获取经度信息
            float radius = bdLocation.getRadius();            //获取定位精度，默认值为0.0f
            String coorType = bdLocation.getCoorType();        //获取经纬度坐标类型，以LocationClientOption中设置过的坐标类型为准
            Log.i(TAG,latitude+","+longitude);
        }else{                                      //定位失败
            Log.i(TAG,"定位失败,错误码:"+bdLocation.getLocType());         //拿到错误码对照定位错误的返回码来具体检查自己的那步出现了问题
        }
    }
}

---

5. 初始化MyLocationListener监听

myLocationListener = new MyLocationListener();

---

6. 配置定位SDK参数

        option = new LocationClientOption();
        //可选，设置定位模式，默认高精度
        //LocationMode.Hight_Accuracy：高精度；
        //LocationMode. Battery_Saving：低功耗；
        //LocationMode. Device_Sensors：仅使用设备；
        option.setLocationMode(LocationClientOption.LocationMode.Hight_Accuracy);
        //可选，设置返回经纬度坐标类型，默认GCJ02
        //GCJ02：国测局坐标；
        //BD09ll：百度经纬度坐标；
        //BD09：百度墨卡托坐标；
        //海外地区定位，无需设置坐标类型，统一返回WGS84类型坐标
        option.setCoorType("bd09ll");
        //可选，设置发起定位请求的间隔，int类型，单位ms
        //如果设置为0，则代表单次定位，即仅定位一次，默认为0
        //如果设置非0，需设置1000ms以上才有效
        option.setScanSpan(1000);
        //可选，设置是否使用gps，默认false
        //使用高精度和仅用设备两种定位模式的，参数必须设置为true
        option.setOpenGps(true);
        //可选，设置是否当GPS有效时按照1S/1次频率输出GPS结果，默认false
        option.setLocationNotify(true);
        //可选，定位SDK内部是一个service，并放到了独立进程。
        //设置是否在stop的时候杀死这个进程，默认（建议）不杀死，即setIgnoreKillProcess(true)
        option.setIgnoreKillProcess(false);
        //可选，设置是否收集Crash信息，默认收集，即参数为false
        option.SetIgnoreCacheException(false);
        //可选，V7.2版本新增能力
        //如果设置了该接口，首次启动定位时，会先判断当前Wi-Fi是否超出有效期，若超出有效期，会先重新扫描Wi-Fi，然后定位
        option.setWifiCacheTimeOut(5*60*1000);
        //可选，设置是否需要过滤GPS仿真结果，默认需要，即参数为false
        option.setEnableSimulateGps(false);

---

7. 初始化LocationClient类,并设置上面初始化的LocationClientOption,注册MyLocationListener监听

mLocationClient = new LocationClient(this);
mLocationClient.setLocOption(option);
mLocationClient.registerLocationListener(myLocationListener);

---

8. 开启定位,并在上面所有权限处理相关的地方加入该句代码

 mLocationClient.start();

---

9. 以下贴入MainActivity的全部代码

import android.Manifest;
import android.app.AlertDialog;
import android.content.DialogInterface;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.net.Uri;
import android.os.Build;
import android.provider.Settings;
import android.support.annotation.NonNull;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.Toast;

import com.baidu.location.LocationClient;
import com.baidu.location.LocationClientOption;
import com.baidu.mapapi.map.BaiduMap;
import com.baidu.mapapi.map.MapView;
import com.jh.maplocationtest.location.MyLocationListener;

import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {

    private MapView mapView = null;
    private BaiduMap baiduMap = null;
    private MyLocationListener myLocationListener = null;
    private LocationClient mLocationClient = null;
    private LocationClientOption option = null;

    private static final int PERMISSION_REQUEST_CODE = 1000;             //请求码

    //预设权限数组,对权限进行统一处理
    String[] permissions = new String[]{
            Manifest.permission.ACCESS_COARSE_LOCATION,
            Manifest.permission.ACCESS_FINE_LOCATION,
            Manifest.permission.WRITE_EXTERNAL_STORAGE,
            Manifest.permission.READ_PHONE_STATE
    };
    //创建一个mPermissionList，逐个判断哪些权限未授予，未授予的权限存储到mPerrrmissionList中
    List<String> mPermissionList = new ArrayList<>();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mapView = findViewById(R.id.mapView);
        baiduMap = mapView.getMap();
        initOptions();
        mLocationClient = new LocationClient(this);
        myLocationListener = new MyLocationListener();
        mLocationClient.setLocOption(option);
        mLocationClient.registerLocationListener(myLocationListener);

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M){
            checkPhonePermission();
        }else{
            mLocationClient.start();
        }
    }

    /**
     *  检查手机权限是否已经获取
     */
    private void checkPhonePermission() {
        mPermissionList.clear();//清空没有通过的权限

        //逐个判断你要的权限是否已经通过
        for (int i = 0; i < permissions.length; i++) {
            if (ContextCompat.checkSelfPermission(this, permissions[i]) != PackageManager.PERMISSION_GRANTED) {
                mPermissionList.add(permissions[i]);//添加还未授予的权限
            }
        }
        //申请权限
        if (mPermissionList.size() > 0) {//有权限没有通过，需要申请
            String[] permissions2 = mPermissionList.toArray(new String[mPermissionList.size()]);//将List转为数组
            ActivityCompat.requestPermissions(this, permissions2, PERMISSION_REQUEST_CODE);
        }else{
            //说明权限都已经通过，可以做你想做的事情去
            mLocationClient.start();
        }
    }


    /**
     *  进行初始化定位功能的配置
     */
    private void initOptions() {
        option = new LocationClientOption();
        //可选，设置定位模式，默认高精度
        //LocationMode.Hight_Accuracy：高精度；
        //LocationMode. Battery_Saving：低功耗；
        //LocationMode. Device_Sensors：仅使用设备；
        option.setLocationMode(LocationClientOption.LocationMode.Hight_Accuracy);
        //可选，设置返回经纬度坐标类型，默认GCJ02
        //GCJ02：国测局坐标；
        //BD09ll：百度经纬度坐标；
        //BD09：百度墨卡托坐标；
        //海外地区定位，无需设置坐标类型，统一返回WGS84类型坐标
        option.setCoorType("bd09ll");
        //可选，设置发起定位请求的间隔，int类型，单位ms
        //如果设置为0，则代表单次定位，即仅定位一次，默认为0
        //如果设置非0，需设置1000ms以上才有效
        option.setScanSpan(1000);
        //可选，设置是否使用gps，默认false
        //使用高精度和仅用设备两种定位模式的，参数必须设置为true
        option.setOpenGps(true);
        //可选，设置是否当GPS有效时按照1S/1次频率输出GPS结果，默认false
        option.setLocationNotify(true);
        //可选，定位SDK内部是一个service，并放到了独立进程。
        //设置是否在stop的时候杀死这个进程，默认（建议）不杀死，即setIgnoreKillProcess(true)
        option.setIgnoreKillProcess(false);
        //可选，设置是否收集Crash信息，默认收集，即参数为false
        option.SetIgnoreCacheException(false);
        //可选，V7.2版本新增能力
        //如果设置了该接口，首次启动定位时，会先判断当前Wi-Fi是否超出有效期，若超出有效期，会先重新扫描Wi-Fi，然后定位
        option.setWifiCacheTimeOut(5*60*1000);
        //可选，设置是否需要过滤GPS仿真结果，默认需要，即参数为false
        option.setEnableSimulateGps(false);
        //mLocationClient为第二步初始化过的LocationClient对象
        //需将配置好的LocationClientOption对象，通过setLocOption方法传递给LocationClient对象使用


    }

    @Override
    protected void onResume() {
        super.onResume();
        mapView.onResume();
    }

    @Override
    protected void onPause() {
        super.onPause();
        mapView.onPause();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mapView.onDestroy();
    }

    /**
     * 权限结果回调处理
     * @param requestCode
     * @param permissions
     * @param grantResults
     */
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        boolean hasPermissionDismiss = false;//有权限没有通过
        if (PERMISSION_REQUEST_CODE == requestCode) {
            for (int i = 0; i < grantResults.length; i++) {
                if (grantResults[i] == -1) {
                    hasPermissionDismiss = true;
                }
            }
            //如果有权限没有被允许
            if (hasPermissionDismiss) {
                Toast.makeText(this, "您没有授予权限,请您到系统设置中设置该权限,再重新进行定位", Toast.LENGTH_SHORT).show();;//跳转到系统设置权限页面，或者直接关闭页面，不让他继续访问
            }else{
                //全部权限通过，可以进行下一步操作。。。
                mLocationClient.start();
            }
        }
    }
}

---

10. 代码已上传至github,可自行下载,查看

github地址