前言
最近更新项目中用的百度定位SDK时遇见了一个奇葩的问题。当升级SDK后百度定位一直返回505,通过百度定位官网查看该码表示AK非法或者不存在。很纠结,于是自己又写了一个demo来研究一下百度定位以及大家使用百度定位经常出现的问题,特此记录。这篇文章我先将百度定位的实现也介绍一下,最后再分析遇到的问题及解决方案。
定位分析
目前百度定位提供了WIFI,基站,GPS等多种定位方式,适用于室内、室外多种定位场景,具有出色的定位性能:定位精度高(其实我是想吐槽的)、覆盖率广、网络定位请求流量小、定位速度快。集成定位SDK
现在官网提供的最新的定位SDK版本是v7.0,官网SDK下载地址请戳 定位SDK,可根据自己的需要下载,在这里我进入全部下载,只下载了全量定位。在新版本V7.0中百度将定位对开发包实现了分离
(1)基础定位:开发包体积最小,但只包含基础定位能力(GPS/WiFi/基站)、基础位置描述能力;
(2)离线定位:在基础定位能力基础之上,提供离线定位能力,可在网络环境不佳时,进行精准定位;
(3)室内定位:在基础定位能力基础之上,提供室内高精度定位能力,精度可达1-3米;
(4)全量定位:包含离线定位、室内高精度定位能力,同时提供更人性化的位置描述服务;
对于这四种类型定位开发包是互斥的,一个应用中只需集成一种定位开发包即可。下载成功之后,将jar包和.so文件放到对应的文件下即可。
申请秘钥
使用百度定位,我们需要在官网申请一个AK,项目定位时需要使用这个Ak,一个应用对于一个AK,AK申请时需要提供包名及SHA1值。具体方式
可去官网查看。在这里我简单介绍下SHA1获取方式。在申请Ak时,页面填写发布版SHA1和开发版SHA1。下面我提供两种方式获取SHA1值。
AndroidStudio Terminal获取
-rfc 以 RFC 样式输出
-alias <alias> 要处理的条目的别名
-keystore <keystore> 密钥库名称
-storepass <arg> 密钥库口令
-storetype <storetype> 密钥库类型
-providername <providername> 提供方名称
-providerclass <providerclass> 提供方类名
-providerarg <arg> 提供方参数
-providerpath <pathlist> 提供方类路径
-v 详细输出
-protected 通过受保护的机制的口令
上面是获取密钥库信息的一些命令,则在此获取SHA1可以
keytool -v -list -keystore 【密钥库文件路径】 -storepass 【密钥库文件密码】
在Terminal执行命令后就出现上面的详细信息。SHA1后面的那一串字符就是我们需要的SHA1.
CMD方式
如果要在CMD中获取,必须先要设置环境变量,具体设置方式可谷歌搜索。当然获取的命令和在AndroidStudio中获取是一样的。在上面我获取下开发版SHA1。对于debug版一般存用户下的.android目录下,我们打开CMD后执行 cd .android然后通过dir就可以看到目录下会有一个debug.keystore文件,我们找的就是它。
在图中你会看到没有写-storepass参数(当然也可和上面一样)。在回车后会提示输入密钥库口令,对于我们的debug版本口令默认是android,输入后回车即可看到详细信息了。
环境配置
要想实现定位,我们必须在清单文件中加入一些必要的权限以及key等信息,如下
<!--百度定位权限相关-->
<!-- 这个权限用于进行网络定位-->
<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>
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<service
android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote" >
</service>
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="w7NQOKL8SpxHrs6lixBNoe90" />
</application>
定位实现
对于定位的实现我们可以分为三步,第一步:初始化LocationClient;第二步:通过LocationClientOption设置定位参数;第三步:实现BDLocationListener接口。看着是不是很简单,你没看错,确实很简单。
初始化LocationClient
/**
* 获取LocationService实例
*
* @param context
* @return
*/
public static LocationService getInstance(Context context) {
if (locationClient == null) {
synchronized (LocationService.class) {
locationService= new LocationService(context);
}
}
return locationService;
}
private LocationService(Context context) {
if (locationClient == null) {
locationClient = new LocationClient(context);
locationClient.setLocOption(getDefaultLocationClientOption());
}
}
设置定位参数
/***
* 配置参数
*
* @return DefaultLocationClientOption
*/
public LocationClientOption getDefaultLocationClientOption() {
if (locationClientOption == null) {
locationClientOption = new LocationClientOption();
locationClientOption.setLocationMode(LocationClientOption.LocationMode.Hight_Accuracy);//可选,默认高精度,设置定位模式,高精度,低功耗,仅设备
locationClientOption.setCoorType("bd09ll");//可选,默认gcj02,设置返回的定位结果坐标系,如果配合百度地图使用,建议设置为bd09ll;
locationClientOption.setScanSpan(3000);//可选,默认0,即仅定位一次,设置发起定位请求的间隔需要大于等于1000ms才是有效的
locationClientOption.setIsNeedAddress(true);//可选,设置是否需要地址信息,默认不需要
locationClientOption.setIsNeedLocationDescribe(true);//可选,设置是否需要地址描述
locationClientOption.setNeedDeviceDirect(true);//可选,设置是否需要设备方向结果
locationClientOption.setLocationNotify(true);//可选,默认false,设置是否当gps有效时按照1S1次频率输出GPS结果
locationClientOption.setIgnoreKillProcess(true);//可选,默认true,定位SDK内部是一个SERVICE,并放到了独立进程,设置是否在stop的时候杀死这个进程,默认不杀死
locationClientOption.setIsNeedLocationDescribe(true);//可选,默认false,设置是否需要位置语义化结果,可以在BDLocation.getLocationDescribe里得到,结果类似于“在北京天安门附近”
locationClientOption.setIsNeedLocationPoiList(true);//可选,默认false,设置是否需要POI结果,可以在BDLocation.getPoiList里得到
locationClientOption.SetIgnoreCacheException(false);//可选,默认false,设置是否收集CRASH信息,默认收集
locationClientOption.setIsNeedAltitude(false);//可选,默认false,设置定位时是否需要海拔信息,默认不需要,除基础定位版本都可用
}
return locationClientOption;
}
实现BDLocationListener接口
/*****
* 定位结果回调,重写onReceiveLocation方法
*
*/
private BDLocationListener mListener = new BDLocationListener() {
@Override
public void onReceiveLocation(BDLocation location) {
// TODO Auto-generated method stub
if (null != location ) {
StringBuffer sb = new StringBuffer(256);
sb.append("time : ");
/**
* 时间也可以使用systemClock.elapsedRealtime()方法 获取的是自从开机以来,每次回调的时间;
* location.getTime() 是指服务端出本次结果的时间,如果位置不发生变化,则时间不变
*/
sb.append(location.getTime());
sb.append("\nlocType : ");// 定位类型
sb.append(location.getLocType());
sb.append("\nlocType description : ");// *****对应的定位类型说明*****
//sb.append(location.getLocTypeDescription());
sb.append("\nlatitude : ");// 纬度
sb.append(location.getLatitude());
sb.append("\nlontitude : ");// 经度
sb.append(location.getLongitude());
sb.append("\nradius : ");// 半径
sb.append(location.getRadius());
sb.append("\nCountryCode : ");// 国家码
sb.append(location.getCountryCode());
sb.append("\nCountry : ");// 国家名称
sb.append(location.getCountry());
sb.append("\ncitycode : ");// 城市编码
sb.append(location.getCityCode());
sb.append("\ncity : ");// 城市
sb.append(location.getCity());
sb.append("\nDistrict : ");// 区
sb.append(location.getDistrict());
sb.append("\nStreet : ");// 街道
sb.append(location.getStreet());
sb.append("\naddr : ");// 地址信息
sb.append(location.getAddrStr());
sb.append("\nUserIndoorState: ");// *****返回用户室内外判断结果*****
//sb.append(location.getUserIndoorState());
sb.append("\nDirection(not all devices have value): ");
sb.append(location.getDirection());// 方向
sb.append("\nlocationdescribe: ");
sb.append(location.getLocationDescribe());// 位置语义化信息
sb.append("\nPoi: ");// POI信息
if (location.getPoiList() != null && !location.getPoiList().isEmpty()) {
for (int i = 0; i < location.getPoiList().size(); i++) {
Poi poi = (Poi) location.getPoiList().get(i);
sb.append(poi.getName() + ";");
}
}
if (location.getLocType() == BDLocation.TypeGpsLocation) {// GPS定位结果
sb.append("\nspeed : ");
sb.append(location.getSpeed());// 速度 单位:km/h
sb.append("\nsatellite : ");
sb.append(location.getSatelliteNumber());// 卫星数目
sb.append("\nheight : ");
sb.append(location.getAltitude());// 海拔高度 单位:米
sb.append("\ngps status : ");
//sb.append(location.getGpsAccuracyStatus());// *****gps质量判断*****
sb.append("\ndescribe : ");
sb.append("gps定位成功");
} else if (location.getLocType() == BDLocation.TypeNetWorkLocation) {// 网络定位结果
// 运营商信息
if (location.hasAltitude()) {// *****如果有海拔高度*****
sb.append("\nheight : ");
sb.append(location.getAltitude());// 单位:米
}
sb.append("\noperationers : ");// 运营商信息
sb.append(location.getOperators());
sb.append("\ndescribe : ");
sb.append("网络定位成功");
} else if (location.getLocType() == BDLocation.TypeOffLineLocation) {// 离线定位结果
sb.append("\ndescribe : ");
sb.append("离线定位成功,离线定位结果也是有效的");
} else if (location.getLocType() == BDLocation.TypeServerError) {
sb.append("\ndescribe : ");
sb.append("服务端网络定位失败,可以反馈IMEI号和大体定位时间到loc-bugs@baidu.com,会有人追查原因");
} else if (location.getLocType() == BDLocation.TypeNetWorkException) {
sb.append("\ndescribe : ");
sb.append("网络不同导致定位失败,请检查网络是否通畅");
} else if (location.getLocType() == BDLocation.TypeCriteriaException) {
sb.append("\ndescribe : ");
sb.append("无法获取有效定位依据导致定位失败,一般是由于手机的原因,处于飞行模式下一般会造成这种结果,可以试着重启手机");
}
tv_location.setText(sb+"\n定位结束");
locationService.stop();
}else{
tv_location.setText("\n定位失败");
}
}
};
通过上面的实现后,我们在想要定位的地方注册下回调,并调用start()方法即可以获取位置了,我对注册开始暂停做了下简单封装,具体代码参考LocationService。如果要写的项目里也要把回调接口封装,自定义一个接口回调返回定位后的详细位置信息。到这里即可成功定位了,下面就开始介绍下这个过程会出现的问题。
定位问题分析
在分析之前我们先看下百度定位返回的错误码,分析定位的问题也就是分析出现错误码的原因。
获取定位返回错误码::
public int getLocType ( )
返回值:
61 : GPS定位结果,GPS定位成功。
62 : 无法获取有效定位依据,定位失败,请检查运营商网络或者WiFi网络是否正常开启,尝试重新请求定位。
63 : 网络异常,没有成功向服务器发起请求,请确认当前测试手机网络是否通畅,尝试重新请求定位。
65 : 定位缓存的结果。
66 : 离线定位结果。通过requestOfflineLocaiton调用时对应的返回结果。
67 : 离线定位失败。通过requestOfflineLocaiton调用时对应的返回结果。
68 : 网络连接失败时,查找本地离线定位时对应的返回结果。
161: 网络定位结果,网络定位成功。
162: 请求串密文解析失败,一般是由于客户端SO文件加载失败造成,请严格参照开发指南或demo开发,放入对应SO文件。
167: 服务端定位失败,请您检查是否禁用获取位置信息权限,尝试重新请求定位。
502: AK参数错误,请按照说明文档重新申请AK。
505:AK不存在或者非法,请按照说明文档重新申请AK。
601: AK服务被开发者自己禁用,请按照说明文档重新申请AK。
602: key mcode不匹配,您的AK配置过程中安全码设置有问题,请确保:SHA1正确,“;”分号是英文状态;且包名是您当前运行应用的包名,请按照说明文档重新申请AK。
501~700:AK验证失败,请按照说明文档重新申请AK。
其实知道上面错误码代表的含义后,我们就很快速的定位问题出现地方。当然有些时候不如此,可能需要走一些弯路。
505错误
在我升级定位SDK版本后遇到得到就是这个问题,没有更改任何代码但是就是一直返回错误码是505.通过上面错误码表我们看到时AK不存在或者非法,但是依然很纠结,因为代码时点儿也没有改,只是替换了jar和.so文件为最新版就不能用了。定位一直返回505,最后在官网更新日志看到V7.0版本有一条记录 是优化、完善AK校验机制,充分保证开发者合法权益,保证开发者应用的安全性。具体怎么优化并没有说明。不过也能猜测应该是SHA1的值问题。我先将demo用的定位SDK用V6.2.2(项目中用的此版本),然后更改SHA1的值,不管怎么改依然能成功定位。但是更改为了V7.0版本发现SHA1的值并不能随便改,只能是运行程序用的key文件的SHA1的值,否则就出现505错误。至此问题解决。在V7.0之前版本虽说让填写SHA1的值,但是并没有什么有效作用,在V7.0版本开始加入了严格的校验。在这里提供一个软件可以校验APK的SHA1值,他提供了SHA1的和AK的校验功能。
如上图,这上面显示的SHA1的值应该和你开发版或者发布版中至少其中的一个相同。否则V7.0定位就不会成功。校验工具百度网盘下载链接,提取码:je4r。
162错误
162错误一般是.so文件加载失败引起的。在AndroidStudio中.so文件的位置和Eclipse中的是不一样的。默认情况下,AndroidStudio中.so文件放在main目录下,在该文件夹下创建jniLibs,然后将不同内核的.so文件放到该文件夹下就可以了。当然一些人延续了Eclipse位置,将.so文件放置在libs目录下,如果此时没有其他一些配置.so文件是不能加载的。此时再gradle文件加入下面代码即可
sourceSets {
main {
jniLibs.srcDirs = ['libs']
}
}
其实最多出现的问题也就是这两种情况。正常情况下百度定位成功返回的是161也就是网络定位结果(如上图),但是有时候无网络会返回66机离线定位结果,离线定位是小区定位,需要手机手机中有SIM卡,否则不会返回66,你可以尝试下,把手机调到飞行模式,发现离线定位会失败。百度定位默认GPS定位是关闭的,如果想用GPS定位可以通过下面代码打开,
locationClientOption.setOpenGps(true);
BDLocationListener只回调一次
对于很多刚接触定位的人可能还会遇到一个问题就是,为何多次调用start()方法但是BDLocationListener回调只执行一次。每次只要程序刚启动时才能定位成功。之后再定位就没有反应了。如果你第一次遇到这个问题,确实很棘手,不管怎么改定位相关的代码,并不能解决问题。其实此时只需要在清单文件加入下面代码既可以解决BDLocationListener只会回调一次的问题
<service
android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote" >
</service>
好了,到此,本篇文章真的结束了,若文章有不足或者错误的地方,欢迎指正,以防止给其他读者错误引导