越写悦快乐之Android应用如何使用百度地图进行定位

百度地图开放平台 - 图片来自网络

今天的越写悦快乐之系列文章为大家带来Android应用如何使用百度地图进行定位。有过Android开发经验的小伙伴可能知道，定位签到功能经常出现在你的App应用中，如何使用百度地图进行定位，将成为我们这篇文章的主旨，当然你也可以其他地图API构建你的定位签到功能，下面我为大家 分享一下如何使用百度地图进行简单的定位功能。

开发环境

• Window 10.0.17763
• Java 8.0.191
• Android Studio 3.3.2

Gradle 版本

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-4.10.1-all.zip

Build 版本

dependencies {
    classpath "com.android.tools.build:gradle:3.2.1"
}

构建步骤

注册百度账号并申请成为百度地图开发者

没什么可叨叨的，我相信你肯定能搞定

获取服务秘钥

• 登录百度地图控制台
• 查看我的应用
• 创建新应用（应用类别Android）
• 获取服务AK

选择启用服务并填写相关信息 - 图片来自我的手机

1 未认证的开发者有调用频次的限制；
2 若是获得更稳定和可靠的开放服务，请根据具体的业务需求选择合适的商用授权；

还记得上一篇文章中我们获取的证书指纹吗？我们要在测试环境或者生成环境验证定位功能则需要证书的相关信息才能使用定位服务（请看上图中的发布版SHA1和开发版SHA1）。

包名填写你的应用的AndroidManifest.xml文件中package的值。

使用定位服务

添加百度地图定位SDK

• 下载并解压定位SDK
• 复制文件.jar + .so文件到app模块的libs目录下
• 更新配置文件（app/build.gradle）

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

• 添加AK（AndroidManifest.xml文件中的application标签里）

• 添加访问权限（AndroidManifest.xml文件中的uses-permission标签）

书写定位代码

参考官方的示例代码和官方文档，我们可以梳理一下使用定位服务的步骤：

• 添加地图布局
• 获取地图对象
• 获取定位客户端对象
• 设置定位选项
• 注册定位监听器
• 为定位客户端设置监听

下面给出示例代码，仅供参考。

 private void initMap() {
        mBaiDuMap = mMapView.getMap();
        // 设置地图类型
        mBaiDuMap.setMapType(BaiduMap.MAP_TYPE_NORMAL);
        // 获取定位客户端
        mLocationClient = new LocationClient(this);
        initLocationOption();
        // 注册LocationListener监听器
        myListener = new MyLocationListener();
        mLocationClient.registerLocationListener(myListener);
    }

    private void initLocationOption() {
        LocationClientOption option = new LocationClientOption();
        // 设置定位模式
        option.setLocationMode(LocationClientOption.LocationMode.Hight_Accuracy
        );
        // 定位结果坐标系
        option.setCoorType("bd09ll");
        int span = 1000;
        // 设置发起连续定位请求的时间间隔
        option.setScanSpan(span);
        // 设置是否需要地址信息
        option.setIsNeedAddress(true);
        // 设置是否开启Gps定位
        option.setOpenGps(true);
        // 设置是否收集CRASH信息
        option.SetIgnoreCacheException(true);
        // 设置是否需要位置语义化结果
        option.setIsNeedLocationDescribe(true);
        // 设置是否需要POI结果
        option.setIsNeedLocationPoiList(true);
        mLocationClient.setLocOption(option);
    }

    public class MyLocationListener extends BDAbstractLocationListener {

        @Override
        public void onReceiveLocation(BDLocation location) {
            if (location == null || mMapView == null) {
                return;
            }
            LatLng latLng;
            // 构造定位数据
            MyLocationData locData = new MyLocationData.Builder()
                    .accuracy(location.getRadius())
                    .direction(100).latitude(location.getLatitude())
                    .longitude(location.getLongitude()).build();
            // 设置定位数据
            mBaiDuMap.setMyLocationData(locData);
            if (isFirstLoc) {
                isFirstLoc = false;
                latLng = new LatLng(location.getLatitude(),
                        location.getLongitude());
                MapStatus.Builder builder = new MapStatus.Builder();
                builder.target(latLng).zoom(15.0f);
                mBaiDuMap.animateMapStatus(MapStatusUpdateFactory.newMapStatus(builder.build()));
                viewModel.longitude.set(String.valueOf(location.getLongitude()));
                viewModel.latitude.set(String.valueOf(location.getLatitude()));
                viewModel.address.set(location.getAddrStr());
                switch (location.getLocType()) {
                    case BDLocation.TypeGpsLocation:
                        // GPS 定位结果
                        ToastUtils.showShort(location.getAddrStr());
                        break;
                    case BDLocation.TypeNetWorkLocation:
                        // 网络定位结果
                        ToastUtils.showShort(location.getAddrStr());
                        break;
                    case BDLocation.TypeOffLineLocation:
                        // 离线定位结果
                        ToastUtils.showShort(location.getAddrStr());
                        break;
                    case BDLocation.TypeServerError:
                        ToastUtils.showShort("服务器错误，请检查");
                        break;
                    case BDLocation.TypeNetWorkException:
                        ToastUtils.showShort("网络错误，请检查网络");
                        break;
                    case BDLocation.TypeCriteriaException:
                        ToastUtils.showShort("手机模式错误，请检查是否飞行");
                        break;
                }
            }
        }
    }

    @Override
    public void onStart() {
        super.onStart();
        mBaiDuMap.setMyLocationEnabled(true);
        if (!mLocationClient.isStarted()) {
            mLocationClient.start();
        }
    }

    @Override
    public void onStop() {
        super.onStop();
        mBaiDuMap.setMyLocationEnabled(false);
        mLocationClient.stop();
    }

    @Override
    public void onResume() {
        super.onResume();
        mMapView.onResume();
    }

    @Override
    public void onPause() {
        super.onPause();
        mMapView.onPause();
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        mMapView.onDestroy();
    }

验证定位功能

我们从百度地图控制台设置我们的开发版SHA1，保存完成后即可启动应用，在模拟器或者Android设备验证我们的定位功能，若是在定位过程中出现错误信息，可以参考官方文档中关于服务错误的描述，进一步定位错误并修复问题。

参考

• 百度地图定位

个人收获

定位功能算是一个应用的基础功能，也是利用位置数据提供更多的服务给客户，当然这里也要注意不同Android版本对定位权限的不同处理机制，有时候需要动态申请权限，在用户同意获取定位权限后获取用户的定位数据，涉及到用户隐私问题我们需要从多方面保护用户的个人数据，避免这些敏感数据被用于非法用途，给用户带来不可挽回的损失，因此从Android应用的安全角度和用户的隐私进去考量一个应用的质量，才能更好地服务于用户，让我们的应用助力用户，成就用户，为用户创造价值，希望我的文章对你有所启发，接下来我继续大家分享Android开发的那些事儿。若是我的文章对你有所启发，那将是我莫大的荣幸。