百度定位SDK使用

时间：2022-09-04 10:28:10

开发指南v3.3

导入库文件

在相关下载最 新的库文件。将liblocSDK3.so文件拷贝到libs/armeabi目录下。将locSDK3.3.jar文件拷贝到工程的libs目录下，并 在工程属性->Java Build Path->Libraries中选择“Add JARs”，选定locSDK3.3.jar，确定后返回。这样您就可以在程序中使用百度定位SDK了。

设置AndroidManifest.xml

在application标签中声明service组件,为了避免各个app公用1个service出现的权限问题，新版本各个app单独拥有自己的定位service.

 
 
    

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

    2.  
  
  2.  
   
     
    </service> 
   
    

    3.  
 


声明使用权限
 
 
 
 
    

  1.  
   
     
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission> 
   
    

    2.  
  
  2.  
   
     
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission> 
   
    

    3.  
  
  3.  
   
     
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission> 
   
    

    4.  
  
  4.  
   
     
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission> 
   
    

    5.  
  
  5.  
   
     
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission> 
   
    

    6.  
  
  6.  
   
     
    <uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission> 
   
    

    7.  
  
  7.  
   
     
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission> 
   
    

    8.  
  
  8.  
   
     
    <uses-permission android:name="android.permission.INTERNET" /> 
   
    

    9.  
  
  9.  
   
     
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"></uses-permission> 
   
    

    10.  
  
  10.  
   
     
    <uses-permission android:name="android.permission.READ_LOGS"></uses-permission> 
   
    

    11.  
 


import相关类
 
 
 
 
    

  1.  
   
     
    import 
    com.baidu.location.BDLocation 
    ; 
   
    

    2.  
  
  2.  
   
     
    import 
    com.baidu.location.BDLocationListener 
    ; 
   
    

    3.  
  
  3.  
   
     
    import 
    com.baidu.location.LocationClient 
    ; 
   
    

    4.  
  
  4.  
   
     
    import 
    com.baidu.location.LocationClientOption 
    ; 
   
    

    5.  
  
  5.  
   
     
    import 
    com.baidu.location.BDNotifyListener 
    ; 
    //假如用到位置提醒功能，需要import该类 
   
    

    6.  
 


功能类的使用
 
 
初始化LocationClient类
 
 
此处需要注意：LocationClient类必须在主线程中声明。需要Context类型的参数。
 
 
Context需要时全进程有效的context,推荐用getApplicationConext获取全进程有效的context
 
 
 
 
    

  1.  
   
     
    public LocationClient mLocationClient 
    = 
    null 
    ; 
   
    

    2.  
  
  2.  
   
     
    public BDLocationListener myListener 
    = 
    new MyLocationListener 
    ( 
    ) 
    ; 
   
    

    3.  
  
  3.  
   
    
       
   
    

    4.  
  
  4.  
   
     
    public 
    void onCreate 
    ( 
    ) 
    { 
   
    

    5.  
  
  5.  
   
    
     mLocationClient 
    = 
    new LocationClient 
    ( 
    getApplicationContext() 
    ) 
    ; 
    //声明LocationClient类 
   
    

    6.  
  
  6.  
   
    
     mLocationClient. 
    registerLocationListener 
    ( myListener 
    ) 
    ; 
    //注册监听函数 
   
    

    7.  
  
  7.  
   
     
    } 
   
    

    8.  
 


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

  1.  
   
     
    public 
    class MyLocationListener 
    implements BDLocationListener 
    { 
   
    

    2.  
  
  2.  
   
    
     @Override 
   
    

    3.  
  
  3.  
   
     
    public 
    void onReceiveLocation 
    (BDLocation location 
    ) 
    { 
   
    

    4.  
  
  4.  
   
     
    if 
    (location 
    == 
    null 
    ) 
   
    

    5.  
  
  5.  
   
     
    return 
    ; 
   
    

    6.  
  
  6.  
   
     
    StringBuffer sb 
    = 
    new 
    StringBuffer 
    ( 
    256 
    ) 
    ; 
   
    

    7.  
  
  7.  
   
    
     sb. 
    append 
    ( 
    "time : " 
    ) 
    ; 
   
    

    8.  
  
  8.  
   
    
     sb. 
    append 
    (location. 
    getTime 
    ( 
    ) 
    ) 
    ; 
   
    

    9.  
  
  9.  
   
    
     sb. 
    append 
    ( 
    "\nerror code : " 
    ) 
    ; 
   
    

    10.  
  
  10.  
   
    
     sb. 
    append 
    (location. 
    getLocType 
    ( 
    ) 
    ) 
    ; 
   
    

    11.  
  
  11.  
   
    
     sb. 
    append 
    ( 
    "\nlatitude : " 
    ) 
    ; 
   
    

    12.  
  
  12.  
   
    
     sb. 
    append 
    (location. 
    getLatitude 
    ( 
    ) 
    ) 
    ; 
   
    

    13.  
  
  13.  
   
    
     sb. 
    append 
    ( 
    "\nlontitude : " 
    ) 
    ; 
   
    

    14.  
  
  14.  
   
    
     sb. 
    append 
    (location. 
    getLongitude 
    ( 
    ) 
    ) 
    ; 
   
    

    15.  
  
  15.  
   
    
     sb. 
    append 
    ( 
    "\nradius : " 
    ) 
    ; 
   
    

    16.  
  
  16.  
   
    
     sb. 
    append 
    (location. 
    getRadius 
    ( 
    ) 
    ) 
    ; 
   
    

    17.  
  
  17.  
   
     
    if 
    (location. 
    getLocType 
    ( 
    ) 
    == BDLocation. 
    TypeGpsLocation 
    ) 
    { 
   
    

    18.  
  
  18.  
   
    
     sb. 
    append 
    ( 
    "\nspeed : " 
    ) 
    ; 
   
    

    19.  
  
  19.  
   
    
     sb. 
    append 
    (location. 
    getSpeed 
    ( 
    ) 
    ) 
    ; 
   
    

    20.  
  
  20.  
   
    
     sb. 
    append 
    ( 
    "\nsatellite : " 
    ) 
    ; 
   
    

    21.  
  
  21.  
   
    
     sb. 
    append 
    (location. 
    getSatelliteNumber 
    ( 
    ) 
    ) 
    ; 
   
    

    22.  
  
  22.  
   
     
    } 
    else 
    if 
    (location. 
    getLocType 
    ( 
    ) 
    == BDLocation. 
    TypeNetWorkLocation 
    ) 
    { 
   
    

    23.  
  
  23.  
   
    
     sb. 
    append 
    ( 
    "\naddr : " 
    ) 
    ; 
   
    

    24.  
  
  24.  
   
    
     sb. 
    append 
    (location. 
    getAddrStr 
    ( 
    ) 
    ) 
    ; 
   
    

    25.  
  
  25.  
   
     
    } 
   
    

    26.  
  
  26.  
   
    
       
   
    

    27.  
  
  27.  
   
    
     logMsg 
    (sb. 
    toString 
    ( 
    ) 
    ) 
    ; 
   
    

    28.  
  
  28.  
   
     
    } 
   
    

    29.  
  
  29.  
   
     
    public 
    void onReceivePoi 
    (BDLocation poiLocation 
    ) 
    { 
   
    

    30.  
  
  30.  
   
     
    if 
    (poiLocation 
    == 
    null 
    ) 
    { 
   
    

    31.  
  
  31.  
   
     
    return 
    ; 
   
    

    32.  
  
  32.  
   
     
    } 
   
    

    33.  
  
  33.  
   
     
    StringBuffer sb 
    = 
    new 
    StringBuffer 
    ( 
    256 
    ) 
    ; 
   
    

    34.  
  
  34.  
   
    
     sb. 
    append 
    ( 
    "Poi time : " 
    ) 
    ; 
   
    

    35.  
  
  35.  
   
    
     sb. 
    append 
    (poiLocation. 
    getTime 
    ( 
    ) 
    ) 
    ; 
   
    

    36.  
  
  36.  
   
    
     sb. 
    append 
    ( 
    "\nerror code : " 
    ) 
    ; 
   
    

    37.  
  
  37.  
   
    
     sb. 
    append 
    (poiLocation. 
    getLocType 
    ( 
    ) 
    ) 
    ; 
   
    

    38.  
  
  38.  
   
    
     sb. 
    append 
    ( 
    "\nlatitude : " 
    ) 
    ; 
   
    

    39.  
  
  39.  
   
    
     sb. 
    append 
    (poiLocation. 
    getLatitude 
    ( 
    ) 
    ) 
    ; 
   
    

    40.  
  
  40.  
   
    
     sb. 
    append 
    ( 
    "\nlontitude : " 
    ) 
    ; 
   
    

    41.  
  
  41.  
   
    
     sb. 
    append 
    (poiLocation. 
    getLongitude 
    ( 
    ) 
    ) 
    ; 
   
    

    42.  
  
  42.  
   
    
     sb. 
    append 
    ( 
    "\nradius : " 
    ) 
    ; 
   
    

    43.  
  
  43.  
   
    
     sb. 
    append 
    (poiLocation. 
    getRadius 
    ( 
    ) 
    ) 
    ; 
   
    

    44.  
  
  44.  
   
     
    if 
    (poiLocation. 
    getLocType 
    ( 
    ) 
    == BDLocation. 
    TypeNetWorkLocation 
    ) 
    { 
   
    

    45.  
  
  45.  
   
    
     sb. 
    append 
    ( 
    "\naddr : " 
    ) 
    ; 
   
    

    46.  
  
  46.  
   
    
     sb. 
    append 
    (poiLocation. 
    getAddrStr 
    ( 
    ) 
    ) 
    ; 
   
    

    47.  
  
  47.  
   
     
    } 
   
    

    48.  
  
  48.  
   
     
    if 
    (poiLocation. 
    hasPoi 
    ( 
    ) 
    ) 
    { 
   
    

    49.  
  
  49.  
   
    
     sb. 
    append 
    ( 
    "\nPoi:" 
    ) 
    ; 
   
    

    50.  
  
  50.  
   
    
     sb. 
    append 
    (poiLocation. 
    getPoi 
    ( 
    ) 
    ) 
    ; 
   
    

    51.  
  
  51.  
   
     
    } 
    else 
    { 
   
    

    52.  
  
  52.  
   
    
     sb. 
    append 
    ( 
    "noPoi information" 
    ) 
    ; 
   
    

    53.  
  
  53.  
   
     
    } 
   
    

    54.  
  
  54.  
   
    
     logMsg 
    (sb. 
    toString 
    ( 
    ) 
    ) 
    ; 
   
    

    55.  
  
  55.  
   
     
    } 
   
    

    56.  
  
  56.  
   
     
    } 
   
    

    57.  
 


设置参数
 
 
设置定位参数包括：定位模式（单次定位，定时定位），返回坐标类型，是否打开GPS等等。eg：
 
 
 
 
    

  1.  
   
    
     LocationClientOption option 
    = 
    new LocationClientOption 
    ( 
    ) 
    ; 
   
    

    2.  
  
  2.  
   
    
     option. 
    setOpenGps 
    ( 
    true 
    ) 
    ; 
   
    

    3.  
  
  3.  
   
    
     option. 
    setAddrType 
    ( 
    "all" 
    ) 
    ; 
    //返回的定位结果包含地址信息 
   
    

    4.  
  
  4.  
   
    
     option. 
    setCoorType 
    ( 
    "bd09ll" 
    ) 
    ; 
    //返回的定位结果是百度经纬度,默认值gcj02 
   
    

    5.  
  
  5.  
   
    
     option. 
    setScanSpan 
    ( 
    5000 
    ) 
    ; 
    //设置发起定位请求的间隔时间为5000ms 
   
    

    6.  
  
  6.  
   
    
     option. 
    disableCache 
    ( 
    true 
    ) 
    ; 
    //禁止启用缓存定位 
   
    

    7.  
  
  7.  
   
    
     option. 
    setPoiNumber 
    ( 
    5 
    ) 
    ; 
    //最多返回POI个数  
   
    

    8.  
  
  8.  
   
    
     option. 
    setPoiDistance 
    ( 
    1000 
    ) 
    ; 
    //poi查询距离  
   
    

    9.  
  
  9.  
   
    
     option. 
    setPoiExtraInfo 
    ( 
    true 
    ) 
    ; 
    //是否需要POI的电话和地址等详细信息  
   
    

    10.  
  
  10.  
   
    
     mLocClient. 
    setLocOption 
    (option 
    ) 
    ; 
   
    

    11.  
 


发起定位请求
 
 
发起定位请求。请求过程是异步的，定位结果在上面的监听函数onReceiveLocation中获取。
 
 
 
 
    

  1.  
   
     
    if 
    (mLocClient 
    != 
    null 
    && mLocClient. 
    isStarted 
    ( 
    ) 
    ) 
   
    

    2.  
  
  2.  
   
    
     mLocClient. 
    requestLocation 
    ( 
    ) 
    ; 
   
    

    3.  
  
  3.  
   
     
    else 
   
    

    4.  
  
  4.  
   
    
     Log. 
    d 
    ( 
    "LocSDK3", 
    "locClient is null or not started" 
    ) 
    ; 
   
    

    5.  
 


发起POI查询请求
 
 
发起POI查询请求。请求过程是异步的，定位结果在上面的监听函数onReceivePoi中获取。
 
 
 
 
    

  1.  
   
     
    if 
    (mLocClient 
    != 
    null 
    && mLocClient. 
    isStarted 
    ( 
    ) 
    ) 
   
    

    2.  
  
  2.  
   
    
     mLocClient. 
    requestPoi 
    ( 
    ) 
    ; 
   
    

    3.  
 


发起离线定位请求
 
 
发起离线定位请求。请求过程是异步的，定位结果在上面的监听函数onReceiveLocation中获取。
 
 
getLocTypte = BDLocation.TypteOfflineLocation || BDLocation.TypeOfflineLocationFail
 
 
表示是离线定位请求返回的定位结果
 
 
 
 
    

  1.  
   
     
    if 
    (mLocClient 
    != 
    null 
    && mLocClient. 
    isStarted 
    ( 
    ) 
    ) 
   
    

    2.  
  
  2.  
   
    
     mLocClient. 
    requestOfflineLocation 
    ( 
    ) 
    ; 
   
    

    3.  
 


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

  1.  
   
     
    //位置提醒相关代码 
   
    

    2.  
  
  2.  
   
    
     mNotifyer 
    = 
    new NotifyLister 
    ( 
    ) 
    ; 
   
    

    3.  
  
  3.  
   
    
     mNotifyer. 
    SetNotifyLocation 
    ( 
    42.03249652949337, 
    113.3129895882556, 
    3000, 
    "gps" 
    ) 
    ; 
    //4个参数代表要位置提醒的点的坐标，具体含义依次为：纬度，经度，距离范围，坐标系类型(gcj02,gps,bd09,bd09ll) 
   
    

    4.  
  
  4.  
   
    
     mLocationClient. 
    registerNotify 
    (mNotifyer 
    ) 
    ; 
   
    

    5.  
  
  5.  
   
     
    //注册位置提醒监听事件后，可以通过SetNotifyLocation 来修改位置提醒设置，修改后立刻生效。 
   
    

    6.  
 


 
 
    

  1.  
   
     
    //BDNotifyListner实现 
   
    

    2.  
  
  2.  
   
     
    public 
    class NotifyLister 
    extends BDNotifyListener 
    { 
   
    

    3.  
  
  3.  
   
     
    public 
    void onNotify 
    (BDLocation mlocation, 
    float distance 
    ) 
    { 
   
    

    4.  
  
  4.  
   
    
     mVibrator01. 
    vibrate 
    ( 
    1000 
    ) 
    ; 
    //振动提醒已到设定位置附近 
   
    

    5.  
  
  5.  
   
     
    } 
   
    

    6.  
  
  6.  
   
     
    } 
   
    

    7.  
 


 
 
    

  1.  
   
     
    //取消位置提醒 
   
    

    2.  
  
  2.  
   
    
     mLocationClient. 
    removeNotifyEvent 
    (mNotifyer 
    ) 
    ; 
   
    

    3.  
 


需要注意的问题
 
 
    

  • 定位SDK必须注册GPS和网络的使用权限。
    •  
  
  • 使用定位SDK请保证网络连接通畅（GPS定位方式不需要连网）。
    •  
  
  • 我们强烈建议您设置自己的prodName，并保管好，这样方便我们为您提供更好的定位服务。
    •  
  
  • 若需要返回的定位结果里包含地址信息，请保证网络连接。
    •  
  
  • 定位SDK可以返回bd09、bd09ll、gcj02三种类型坐标，若需要将定位点的位置通过百度Android地图 SDK进行地图展示，请返回bd09ll，将无偏差的叠加在百度地图上。
    •  
  
  • 有的移动设备锁屏后为了省电会自动关闭网络连接，此时网络定位模式的定位失效。此外，锁屏后移动设备若进入cpu休眠，定时定位功能也失效。若您需要实现在cpu休眠状态仍需定时定位，可以用alarmManager 实现1个cpu可叫醒的timer，定时请求定位。
    •  
 



 
 
摘自：http://developer.baidu.com/map/geosdk-android-developv3.3.htm
 



标签：
相关文章