百度定位功能封装

﹏ヽ暗。殇╰゛Y 2022-08-10 03:40 251阅读 0赞

百度定位SDK应用封装及官方文档

应用封装

public class BaiduLocationHelper \{  
  
public interface MyLocationResultI  
\{  
   public void doLocationResult(HashMap hmResult);  
\}  
  
private Dialog dlgWait;  
private LocationClient mLocationClient;  
private Date locationStartDate = null; // 定位开始时间  
private Date locationEndDate = null; // 定位结束时间  
  
MyLocationResultI myLocationResultI = null;  
public void setLocationCallBack(MyLocationResultI mr)    
    \{    
myLocationResultI = mr;  
    \}    
  
/\*\*  
\*   
\* @函数名称: startLocation  
\* @功能描述: 开始定位请求，结果在回调中  
\* @return void  
\* @throws  
\*/  
public void startLocation(Context context, String strProductName) \{  
//dlgWait = Tools.createLoadingDialog(this, "定位中，请稍等……");  
//dlgWait.show();  
mLocationClient = new LocationClient(context);  
mLocationClient.registerLocationListener(new MyLocationListenner());  
LocationClientOption option = new LocationClientOption();  
// 高精度定位模式：这种定位模式下，会同时使用网络定位和GPS定位，优先返回最高精度的定位结果；  
option.setLocationMode(LocationClientOption.LocationMode.Hight\_Accuracy);  
// 设置是否打开gps，使用gps前提是用户硬件打开gps。默认是不打开gps的。  
option.setOpenGps(true);  
// 设置坐标类型 返回的定位结果是百度经纬度,默认值gcj02国测局经纬度坐标系  
option.setCoorType("bd09ll");  
// 可选，默认0，即仅定位一次，设置发起定位请求的间隔需要大于等于1000ms才是有效的  
option.setScanSpan(0);  
option.setIsNeedAddress(true);// 返回的定位结果包含地址信息  
//option.setLocationNotify(true);//可选，默认false，设置是否当gps有效时按照1S1次频率输出GPS结果  
        //option.setIgnoreKillProcess(true);//可选，默认true，定位SDK内部是一个SERVICE，并放到了独立进程，设置是否在stop的时候杀死这个进程，默认不杀死  
//setIsNeedLocationPoiList(boolean isNeedLocationPoiList) //设置是否需要返回位置POI信息，可以在BDLocation.getPoiList()中得到数据  
option.setIsNeedLocationDescribe(true);//设置是否需要返回位置语义化信息，可以在BDLocation.getLocationDescribe()中得到数据，ex:"在天安门附近"， 可以用作地址信息的补充  
  
// 设置产品线名称：设置产品线名称。强烈建议您使用自定义的产品线名称，方便我们以后为您提供更高效准确的定位服务。  
option.setProdName(strProductName);  
mLocationClient.setLocOption(option);  
//  
locationStartDate = new Date();  
mLocationClient.start();  
\}  
  
/\*\*  
\*   
\* @类名称：MyLocationListenner  
\* @类描述： 定位监听类  
\* @创建人：SQWANG  
\* @创建时间：2015-2-27 下午12:06:33  
\* @修改人：  
\* @修改时间：  
\* @修改备注：  
\* @版本：V1.0  
\*/  
public class MyLocationListenner implements BDLocationListener \{  
@Override  
public void onReceiveLocation(BDLocation location) \{  
//mLocationClient.stop();// 停止定位  
locationEndDate = new Date(); // 定位结束时间  
if (dlgWait != null && dlgWait.isShowing()) \{  
dlgWait.dismiss();  
\}  
doLocationResult(location);  
\}  
\}  
  
/\*\*  
\*   
\* @函数名称: doLocationResult   
\* @功能描述: 处理定位结果  
\* @param location  
\* 定位返回错误码查询：  
   61 ： GPS定位结果，GPS定位成功。  
62 ： 无法获取有效定位依据，定位失败，请检查运营商网络或者wifi网络是否正常开启，尝试重新请求定位。  
63 ： 网络异常，没有成功向服务器发起请求，请确认当前测试手机网络是否通畅，尝试重新请求定位。  
65 ： 定位缓存的结果。  
66 ： 离线定位结果。通过requestOfflineLocaiton调用时对应的返回结果。  
67 ： 离线定位失败。通过requestOfflineLocaiton调用时对应的返回结果。  
68 ： 网络连接失败时，查找本地离线定位时对应的返回结果。  
161： 网络定位结果，网络定位定位成功。  
162： 请求串密文解析失败。  
167： 服务端定位失败，请您检查是否禁用获取位置信息权限，尝试重新请求定位。  
502： key参数错误，请按照说明文档重新申请KEY。  
505： key不存在或者非法，请按照说明文档重新申请KEY。  
601： key服务被开发者自己禁用，请按照说明文档重新申请KEY。  
602： key mcode不匹配，您的ak配置过程中安全码设置有问题，请确保：sha1正确，“;”分号是英文状态；  
且包名是您当前运行应用的包名，请按照说明文档重新申请KEY。  
501～700：key验证失败，请按照说明文档重新申请KEY。  
如果不能定位，请记住这个返回值，并到百度LBS开放平台论坛Andriod定位SDK版块中进行交流  
http://bbs.lbsyun.baidu.com/forum.php?mod=forumdisplay&fid=10 。  
若返回值是162~167，请将错误码、imei和定位时间反馈至loc-bugs@baidu.com，  
以便我们跟进追查问题。  
\*/  
public void doLocationResult(BDLocation location)\{  
boolean bLocationSuccess = false;   
        if (location.getLocType() == BDLocation.TypeGpsLocation)\{// GPS定位结果  
        bLocationSuccess = true;             
        \} else if (location.getLocType() == BDLocation.TypeNetWorkLocation)\{// 网络定位结果  
        bLocationSuccess = true;              
        \} else if (location.getLocType() == BDLocation.TypeOffLineLocation) \{// 离线定位结果  
        bLocationSuccess = true;             
        \} else if (location.getLocType() == BDLocation.TypeServerError) \{  
        bLocationSuccess = false;             
        \} else if (location.getLocType() == BDLocation.TypeNetWorkException) \{  
        bLocationSuccess = false;             
        \} else if (location.getLocType() == BDLocation.TypeCriteriaException) \{  
        bLocationSuccess = false;              
        \}  
          
        @SuppressWarnings("rawtypes")  
HashMap hm = new HashMap();  
        if (!bLocationSuccess)\{//定位失败  
        hm.put("LocationResult", false);  
        myLocationResultI.doLocationResult(hm);  
        \}else\{  
        hm.put("LocationResult", true);  
        //不包含地址信息  
    if (!location.hasAddr())\{//仅有经纬度，不包括位置信！  
    hm.put("IncludeAddr", false);  
    \}else\{  
    hm.put("IncludeAddr", true);  
    \}  
    // 定位用时,单位毫秒  
    long locationUsedTime = locationEndDate.getTime() - locationStartDate.getTime();  
    //  
    hm.put("Province", location.getProvince());//省  
    hm.put("City", location.getCity());//市  
    hm.put("Address", location.getAddress());//街道  
    hm.put("LocationDescribe", location.getLocationDescribe());//位置语义化信息,ex:"在天安门附近"， 可以用作地址信息的补充  
    hm.put("Longitude", Float.parseFloat(location.getLongitude()+""));//经度  
    hm.put("Latitude", Float.parseFloat(location.getLatitude()+""));//纬度  
    hm.put("Radius", location.getRadius());//定位精度  
    hm.put("LocType", location.getLocType());//定位类型  
    hm.put("Loctime", locationUsedTime);//定位耗时

myLocationResultI.doLocationResult(hm);  
        \}  
\}  
\}

百度官方文档，很详细仔细阅读下什么都有了

*  [导入库文件][Link 1]
 *  [设置AndroidManifest.xml][AndroidManifest.xml]
 *  [设置AcessKey][AcessKey]
 *  [import相关类][import]
 *  [功能类的使用][Link 2]
 *  [需要注意的问题][Link 3]

## 导入库文件 ##

在[相关下载][Link 4]里下载最新的库文件。将so文件的压缩文件解压出来，把对应架构下的so文件放入开发者自己APP的对应架构下的文件夹中（建议全部放入以提高程序兼容性），将locSDK\_6.X.jar文件拷贝到工程的libs目录下，这样您就可以在程序中使用百度定位SDK了。

使用eclipse开发的开发者，只需要将SO的文件夹放到libs下即可；使用AndroidStutio的开发者除了上述操作，还需要在build.gradle中配置SO的使用，如下所示：

sourceSets {
           
            	main {
           
        			jniLibs.srcDirs = ['libs']
            	}
    }

开发者如果开发的是系统应用，则只在工程中配置SO还是不够的，还需要手动把对应架构的SO拷贝到/system/lib下，如果是64位系统的话需要将64位的SO拷贝到/sytem/lib64下。

**注意：每次新版本的定位SDK，开发者除了要更新JAR包之外，也要注意一下SO有无更新，如果SO名称不一样了，也要及时替换老的SO版本，不然会导致定位失败！**

## 设置AndroidManifest.xml ##

### 在application标签中声明service组件,每个app拥有自己单独的定位service ###

【重要提醒】

定位SDKv3.1版本之后，以下权限已不需要，请取消声明，否则将由于Android 5.0多帐户系统加强权限管理而导致应用安装失败。 <uses-permission android:name="android.permission.BAIDU\_LOCATION\_SERVICE"></uses-permission>

### 声明使用权限 ###

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission>
    
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
    
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
    
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
    
    <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" />
    
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"></uses-permission>

## 设置AcessKey ##

SDK4.2及之后版本需要在Mainfest.xml设置Accesskey，设置有误会引起定位和地理围栏服务不能正常使用，必须进行Accesskey的正确设置。

设置AccessKey，在application标签中加入

## import相关类 ##

import com.baidu.location.BDLocation;
    import com.baidu.location.BDLocationListener;
    import com.baidu.location.LocationClient;
    import com.baidu.location.LocationClientOption;
    import com.baidu.location.BDNotifyListener;//假如用到位置提醒功能，需要import该类
    import com.baidu.location.Poi;

## 功能类的使用 ##

### 使用综合定位功能 ###

综合定位功能指的根据用户实际需求，返回用户当前位置的基础定位服务。包含GPS和网络定位（Wi-Fi和基站定位）功能。基本定位功能同时还支持结合定位结果的反地理编码功能，离线定位，位置提醒功能和位置语义化功能。

#### 第一步，初始化LocationClient类 ####

此处需要注意：LocationClient类必须在主线程中声明。需要Context类型的参数。

Context需要时全进程有效的context,推荐用getApplicationConext获取全进程有效的context

public LocationClient mLocationClient = null;
    public BDLocationListener myListener = new MyLocationListener();
     
    public void onCreate() {
           
        mLocationClient = new LocationClient(getApplicationContext());     //声明LocationClient类
        mLocationClient.registerLocationListener( myListener );    //注册监听函数
    }

**LocationClient**类是定位SDK的核心类，具体方法详见类参考。

#### 第二步，配置定位SDK参数 ####

设置定位参数包括：定位模式（高精度定位模式，低功耗定位模式和仅用设备定位模式），返回坐标类型，是否打开GPS，是否返回地址信息、位置语义化信息、POI信息等等。

**LocationClientOption**类，该类用来设置定位SDK的定位方式，e.g.：

private 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);//可选，默认false，定位SDK内部是一个SERVICE，并放到了独立进程，设置是否在stop的时候杀死这个进程，默认杀死
            option.SetIgnoreCacheException(false);//可选，默认false，设置是否收集CRASH信息，默认收集
    option.setEnableSimulateGps(false);//可选，默认false，设置是否需要过滤gps仿真结果，默认需要
            mLocationClient.setLocOption(option);
        }

高精度定位模式：这种定位模式下，会同时使用网络定位和GPS定位，优先返回最高精度的定位结果；

低功耗定位模式：这种定位模式下，不会使用GPS，只会使用网络定位（Wi-Fi和基站定位）；

仅用设备定位模式：这种定位模式下，不需要连接网络，只使用GPS进行定位，这种模式下不支持室内环境的定位。

#### 第三步，实现BDLocationListener接口 ####

BDLocationListener接口有1个方法需要实现： 1.接收异步返回的定位结果，参数是BDLocation类型参数。

public class MyLocationListener implements BDLocationListener {
           
     
            @Override
            public void onReceiveLocation(BDLocation location) {
           
                //Receive Location
                StringBuffer sb = new StringBuffer(256);
                sb.append("time : ");
                sb.append(location.getTime());
                sb.append("\nerror code : ");
                sb.append(location.getLocType());
                sb.append("\nlatitude : ");
                sb.append(location.getLatitude());
                sb.append("\nlontitude : ");
                sb.append(location.getLongitude());
                sb.append("\nradius : ");
                sb.append(location.getRadius());
                if (location.getLocType() == BDLocation.TypeGpsLocation){
           // GPS定位结果
                    sb.append("\nspeed : ");
                    sb.append(location.getSpeed());// 单位：公里每小时
                    sb.append("\nsatellite : ");
                    sb.append(location.getSatelliteNumber());
                    sb.append("\nheight : ");
                    sb.append(location.getAltitude());// 单位：米
                    sb.append("\ndirection : ");
                    sb.append(location.getDirection());// 单位度
                    sb.append("\naddr : ");
                    sb.append(location.getAddrStr());
                    sb.append("\ndescribe : ");
                    sb.append("gps定位成功");
     
                } else if (location.getLocType() == BDLocation.TypeNetWorkLocation){
           // 网络定位结果
                    sb.append("\naddr : ");
                    sb.append(location.getAddrStr());
                    //运营商信息
                    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("无法获取有效定位依据导致定位失败，一般是由于手机的原因，处于飞行模式下一般会造成这种结果，可以试着重启手机");
                }
    sb.append("\nlocationdescribe : ");
                    sb.append(location.getLocationDescribe());// 位置语义化信息
                    List<Poi> list = location.getPoiList();// POI数据
                    if (list != null) {
           
                        sb.append("\npoilist size = : ");
                        sb.append(list.size());
                        for (Poi p : list) {
           
                            sb.append("\npoi= : ");
                            sb.append(p.getId() + " " + p.getName() + " " + p.getRank());
                        }
                    }
                Log.i("BaiduLocationApiDem", sb.toString());
            }

BDLocation类，封装了定位SDK的定位结果，在BDLocationListener的onReceive方法中获取。通过该类用户可以获取error code，位置的坐标，精度半径等信息。具体方法请参考类参考。

**获取error code：**

public int getLocType ( )

返回值：

61 ： GPS定位结果，GPS定位成功。

62 ： 无法获取有效定位依据，定位失败，请检查运营商网络或者wifi网络是否正常开启，尝试重新请求定位。

63 ： 网络异常，没有成功向服务器发起请求，请确认当前测试手机网络是否通畅，尝试重新请求定位。

65 ： 定位缓存的结果。

66 ： 离线定位结果。通过requestOfflineLocaiton调用时对应的返回结果。

67 ： 离线定位失败。通过requestOfflineLocaiton调用时对应的返回结果。

68 ： 网络连接失败时，查找本地离线定位时对应的返回结果。

161： 网络定位结果，网络定位定位成功。

162： 请求串密文解析失败。

167： 服务端定位失败，请您检查是否禁用获取位置信息权限，尝试重新请求定位。

502： key参数错误，请按照说明文档重新申请KEY。

505： key不存在或者非法，请按照说明文档重新申请KEY。

601： key服务被开发者自己禁用，请按照说明文档重新申请KEY。

602： key mcode不匹配，您的ak配置过程中安全码设置有问题，请确保：sha1正确，“;”分号是英文状态；且包名是您当前运行应用的包名，请按照说明文档重新申请KEY。

501～700：key验证失败，请按照说明文档重新申请KEY。

如果不能定位，请记住这个返回值，并到百度LBS开放平台论坛Andriod定位SDK版块中进行交流http://bbs.lbsyun.baidu.com/forum.php?mod=forumdisplay&fid=10 。若返回值是162~167，请将错误码、imei和定位时间反馈至loc-bugs@baidu.com，以便我们跟进追查问题。

#### 第四步，开始定位 ####

**开启：**

mLocationClient.start();

start：启动定位SDK。 stop：关闭定位SDK。调用start之后只需要等待定位结果自动回调即可。

开发者定位场景如果是单次定位的场景，在收到定位结果之后直接调用stop函数即可。

如果stop之后仍然想进行定位，可以再次start等待定位结果回调即可。

如果开发者想按照自己逻辑请求定位，可以在start之后按照自己的逻辑请求locationclient.requestLocation()函数，会主动触发定位SDK内部定位逻辑，等待定位回调即可。

### 位置提醒使用 ###

位置提醒最多提醒3次，3次过后将不再提醒。 假如需要再次提醒，或者要修改提醒点坐标，都可通过函数SetNotifyLocation()来实现。

//位置提醒相关代码
    mNotifyer = new NotifyLister();
    mNotifyer.SetNotifyLocation(42.03249652949337,113.3129895882556,3000,"gps");//4个参数代表要位置提醒的点的坐标，具体含义依次为：纬度，经度，距离范围，坐标系类型(gcj02,gps,bd09,bd09ll)
    mLocationClient.registerNotify(mNotifyer);
    //注册位置提醒监听事件后，可以通过SetNotifyLocation 来修改位置提醒设置，修改后立刻生效。
    //BDNotifyListner实现
    public class NotifyLister extends BDNotifyListener{
           
           public void onNotify(BDLocation mlocation, float distance){
           
     	   mVibrator01.vibrate(1000);//振动提醒已到设定位置附近
           }
        }
    //取消位置提醒
    mLocationClient.removeNotifyEvent(mNotifyer);

## 需要注意的问题 ##

定位SDK必须注册GPS和网络的使用权限。

使用定位SDK请尽量保证网络连接通畅（GPS定位方式不需要连网，但如果需要地址信息、位置语义化、POI等信息都需要联网的）。目前离线功能已经支持获取上述信息，但离线定位不是百分百都能定位成功的，增加我们如何保证在线定位成功的措施，以打消用户对于离线定位的顾虑。

我们强烈建议您设置自己的prodName，并保管好，这样方便我们为您提供更好的定位服务。

若需要返回的定位结果里包含地址信息，请保证网络连接。因为GPS是本地获取的定位位置，在某些情况下有可能不带地址信息。

定位SDK可以返回bd09、bd09ll、gcj02三种类型坐标，若需要将定位点的位置通过百度Android地图 SDK进行地图展示，请返回bd09ll，将无偏差的叠加在百度地图上。

有的移动设备锁屏后为了省电会自动关闭网络连接，此时网络定位模式的定位失效。此外，锁屏后移动设备若进入cpu休眠，定时定位功能也失效。若您需要实现在cpu休眠状态仍需定时定位，可以用alarmManager 实现1个cpu可叫醒的timer，定时请求定位。

[Link 1]: http://developer.baidu.com/map/index.php?title=android-locsdk/guide/v5-0#.E5.AF.BC.E5.85.A5.E5.BA.93.E6.96.87.E4.BB.B6
[AndroidManifest.xml]: http://developer.baidu.com/map/index.php?title=android-locsdk/guide/v5-0#.E8.AE.BE.E7.BD.AEAndroidManifest.xml
[AcessKey]: http://developer.baidu.com/map/index.php?title=android-locsdk/guide/v5-0#.E8.AE.BE.E7.BD.AEAcessKey
[import]: http://developer.baidu.com/map/index.php?title=android-locsdk/guide/v5-0#import.E7.9B.B8.E5.85.B3.E7.B1.BB
[Link 2]: http://developer.baidu.com/map/index.php?title=android-locsdk/guide/v5-0#.E5.8A.9F.E8.83.BD.E7.B1.BB.E7.9A.84.E4.BD.BF.E7.94.A8
[Link 3]: http://developer.baidu.com/map/index.php?title=android-locsdk/guide/v5-0#.E9.9C.80.E8.A6.81.E6.B3.A8.E6.84.8F.E7.9A.84.E9.97.AE.E9.A2.98
[Link 4]: http://developer.baidu.com/map/index.php?title=android-locsdk/geosdk-android-download