相信现在很多app都会用到百度定位、百度地图、百度导航等等的功能,本篇先对百度定位做个介绍,接下来我会尽快的将其他相关功能的demo及介绍也做个记录。
一、获取应用程序密钥
官方文档上关于key的申请流程:http://lbsyun.baidu.com/index.php?title=android-locsdk/guide/key,(今天看了下官方的文档发现流程写得好清晰,似乎比以前写的详细了,还是说我现在变聪明了,哈哈~~)
密钥配置好了,开始写之前我们先设置好相应的包,看,我把所有架构对应的文件夹都加了.(这些jar包我会上传demo,也可以去官方上下载)
二、AndroidManifest.xml的配置
(1)权限声明
<!-- 这个权限用于进行网络定位 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 这个权限用于访问GPS定位 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 用于访问wifi网络信息,wifi信息会用于进行网络定位 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 获取运营商信息,用于支持提供运营商信息相关的接口 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 这个权限用于获取wifi的获取权限,wifi信息会用来进行网络定位 -->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<!-- 用于读取手机当前的状态 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!-- 写入扩展存储,向扩展卡写入数据,用于写入离线定位数据 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- 访问网络,网络定位需要上网 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- SD卡读取权限,用户写入离线定位数据 -->
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
(2)服务声明
<service
android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote" />
(3)设置key
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="申请的密钥" />
提示: 服务和key要写在application的标签内哦
三、具体实现
(1)初始化LocationClient
LocationClient mLocationClient = new LocationClient(getApplicationContext());
(2)配置定位SDK参数
private static void initLocation() {
LocationClientOption option = new LocationClientOption();
option.setLocationMode(LocationMode.Hight_Accuracy);// 可选,默认高精度,设置定位模式,高精度,低功耗,仅设备
option.setCoorType("bd09ll");// 可选,默认gcj02,设置返回的定位结果坐标系
int span = 1000;
option.setScanSpan(span);// 可选,默认0,即仅定位一次,设置发起定位请求的间隔需要大于等于1000ms才是有效的
option.setIsNeedAddress(true);// 可选,设置是否需要地址信息,默认不需要
option.setOpenGps(true);// 可选,默认false,设置是否使用gps
option.setLocationNotify(true);// 可选,默认false,设置是否当gps有效时按照1S1次频率输出GPS结果
option.setIsNeedLocationDescribe(true);// 可选,默认false,设置是否需要位置语义化结果,可以在BDLocation.getLocationDescribe里得到,结果类似于“在北京天安门附近”
option.setIsNeedLocationPoiList(true);// 可选,默认false,设置是否需要POI结果,可以在BDLocation.getPoiList里得到
option.setIgnoreKillProcess(false);// 可选,默认true,定位SDK内部是一个SERVICE,并放到了独立进程,设置是否在stop的时候杀死这个进程,默认不杀死
option.SetIgnoreCacheException(false);// 可选,默认false,设置是否收集CRASH信息,默认收集
option.setEnableSimulateGps(false);// 可选,默认false,设置是否需要过滤gps仿真结果,默认需要
mLocationClient.setLocOption(option);
}
(3)设置LocationClient监听
mLocationClient.registerLocationListener(new BDLocationListener {
@Override
public void onReceiveLocation(BDLocation location) {
//定位返回的结果,具体操作在这实现
}
});
根据返回的BDLocation,使用location.getLocType ( )可查看返回的参数值,对应值得介绍如下
61 : GPS定位结果,GPS定位成功。
62 : 无法获取有效定位依据,定位失败,请检查运营商网络或者wifi网络是否正常开启,尝试重新请求定位。
63 : 网络异常,没有成功向服务器发起请求,请确认当前测试手机网络是否通畅,尝试重新请求定位。
65 : 定位缓存的结果。
66 : 离线定位结果。通过requestOfflineLocaiton调用时对应的返回结果。
67 : 离线定位失败。通过requestOfflineLocaiton调用时对应的返回结果。
68 : 网络连接失败时,查找本地离线定位时对应的返回结果。
161: 网络定位结果,网络定位定位成功。
162: 请求串密文解析失败,一般是由于客户端SO文件加载失败造成,请严格参照开发指南或demo开发,放入对应SO文件。
167: 服务端定位失败,请您检查是否禁用获取位置信息权限,尝试重新请求定位。
502: key参数错误,请按照说明文档重新申请KEY。
505: key不存在或者非法,请按照说明文档重新申请KEY。
601: key服务被开发者自己禁用,请按照说明文档重新申请KEY。
602: key mcode不匹配,您的ak配置过程中安全码设置有问题,请确保:sha1正确,“;”分号是英文状态;且包名是您当前运行应用的包名,请按照说明文档重新申请KEY。
501~700:key验证失败,请按照说明文档重新申请KEY。
四、开启/停止定位
//开启定位服务
public void start() {
mLocationClient.start();
}
//停止定位服务并且移除监听
public void stopLocationAndRemoveListener(BDLocationListener listener) {
if (mLocationClient.isStarted()) {
mLocationClient.stop();
}
mLocationClient.unRegisterLocationListener(listener);
}
效果:
这样百度定位开启和结束就好了,有没有感觉蛮简单的呢!有什么不对的需要改进的,还望大家多多指导,提出意见。
demo下载地址:https://github.com/972242736/Location.git
本来打算继续往下写关于百度地图的其他功能,上网搜了一下别人写的风格,发现人家写的很清晰,所以就不打算往下编辑了,地址:http://blog.youkuaiyun.com/crazy1235/article/details/44002459