Android studio 百度地圖開發（2）地圖定位
Android studio 百度地圖開發（2）地圖定位
email:[email protected]
開發環境：win7 64位，Android Studio，請註意是Android Studio，使用的百度地圖定位SDK6.2.3。
地圖顯示、project配置請參考：Android
studio 百度地圖開發（1）配置project、顯示地圖
一.我為百度做點事
最開始自己是從頭到尾地寫了一遍，可是始終不能成功定位。一直沒找到原因。後來也是參考了百度官網上的Demo才弄出來。所以當中的代碼，基本來自百度Demo。喜歡吐槽的朋友請鍵盤留情，然後悄悄飄過吧。
一直以來都是喜歡百度的，雖然百度的的確確不能和Google比。可是。在中國的科技氛圍裏。我認為百度已經夠好了。所以也貼一點百度地圖定位SDK的產品優勢。
最後，我想問問那些嘴裏罵著百度心裏又離不開百度的朋友：你為中國的科技、IT、社會做了什麽？
二.定位SDK的應用
言歸正傳。先貼整個project的代碼，第三部分再解釋說明。
（1）BaiDuMapActivity.java
package intvehapp.intvehapp;
import com.baidu.location.BDLocation;
import com.baidu.location.BDLocationListener;
import com.baidu.location.LocationClient;
import com.baidu.location.LocationClientOption;
import com.baidu.mapapi.SDKInitializer;
import com.baidu.mapapi.map.BaiduMap;
import com.baidu.mapapi.map.MapStatus;
import com.baidu.mapapi.map.MapStatusUpdateFactory;
import com.baidu.mapapi.map.MapView;
import com.baidu.mapapi.map.MyLocationData;
import com.baidu.mapapi.model.LatLng;
import android.app.Activity;
import android.os.Bundle;
public class BaiDuMapActivity extends Activity{
/**
* 定位SDK核心類
*/
private LocationClient locationClient;
/**
* 定位監聽
*/
public MyLocationListenner myListener = new MyLocationListenner();
/**
* 百度地圖控件
*/
private MapView mapView;
/**
* 百度地圖對象
*/
private BaiduMap baiduMap;
boolean isFirstLoc = true; // 是否首次定位
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
SDKInitializer.initialize(getApplicationContext());
setContentView(R.layout.activity_bai_du_map);
/**
* 地圖初始化
*/
//獲取百度地圖控件
mapView = (MapView) findViewById(R.id.bmapView);
//獲取百度地圖對象
baiduMap = mapView.getMap();
// 開啟定位圖層
baiduMap.setMyLocationEnabled(true);
/**
* 定位初始化
*/
//聲明定位SDK核心類
locationClient = new LocationClient(this);
//註冊監聽
locationClient.registerLocationListener(myListener);
//定位配置信息
LocationClientOption option = new LocationClientOption();
option.setOpenGps(true); // 打開gps
option.setCoorType("bd09ll"); // 設置坐標類型
option.setScanSpan(1000);//定位請求時間間隔
locationClient.setLocOption(option);
//開啟定位
locationClient.start();
}
/**
* 定位SDK監聽函數
*/
public class MyLocationListenner implements BDLocationListener {
@Override
public void onReceiveLocation(BDLocation location) {
// map view 銷毀後不在處理新接收的位置
if (location == null || mapView == null) {
return;
}
MyLocationData locData = new MyLocationData.Builder()
.accuracy(location.getRadius())
// 此處設置開發人員獲取到的方向信息，順時針0-360
.direction(100).latitude(location.getLatitude())
.longitude(location.getLongitude()).build();
baiduMap.setMyLocationData(locData);
if (isFirstLoc) {
isFirstLoc = false;
LatLng ll = new LatLng(location.getLatitude(),
location.getLongitude());
MapStatus.Builder builder = new MapStatus.Builder();
builder.target(ll).zoom(18.0f);
baiduMap.animateMapStatus(MapStatusUpdateFactory.newMapStatus(builder.build()));
}
}
public void onReceivePoi(BDLocation poiLocation) {
}
}
@Override
protected void onPause() {
mapView.onPause();
super.onPause();
}
@Override
protected void onResume() {
mapView.onResume();
super.onResume();
}
@Override
protected void onDestroy() {
// 退出時銷毀定位
locationClient.stop();
// 關閉定位圖層
baiduMap.setMyLocationEnabled(false);
mapView.onDestroy();
mapView = null;
super.onDestroy();
}
}
（2）activity_bai_du_map.xml：添加百度地圖控件
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent"
android:layout_height="match_parent" android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
android:paddingBottom="@dimen/activity_vertical_margin"
tools:context="intvehapp.intvehapp.BaiDuMapActivity">
<com.baidu.mapapi.map.MapView
android:id="@+id/bmapView"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:clickable="true" />
</RelativeLayout>
（3）AndroidManifest.xml：添加百度地圖SDK須要的權限、API_KEY和定位服務
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="intvehapp.intvehapp" >
<!-- 百度地圖API所需權限 -->
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
<uses-permission android:name="android.permission.USE_CREDENTIALS" />
<uses-permission android:name="android.permission.MANAGE_ACCOUNTS" />
<uses-permission android:name="android.permission.AUTHENTICATE_ACCOUNTS" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_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.BROADCAST_STICKY" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 訪問精確位置的權限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme" >
<activity android:name=".BaiDuMapActivity" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<!--百度API_KEY-->
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="iXDGdZtFiPifnNm6dUEFwDRXYQVeZ37V" />
<!--百度定位服務-->
<service
android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote" >
</service>
</application>
</manifest>
ok，通過這三部分，就能夠成功定位了。效果例如以下：
三.定位SDK相關說明
【摘自百度官網 title=android-locsdk/guide/getloc">http://lbsyun.baidu.com/index.php?title=android-locsdk/guide/getloc】
【類參考：http://wiki.lbsyun.baidu.com/cms/androidloc/doc/v6_0_3/doc/index.html】
第一步，初始化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);//可選，默認true，定位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號和大體定位時[email protected]，會有人追查原因");
} 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 ： 網絡異常，沒有成功向server發起請求，請確認當前測試手機網絡是否通暢，嘗試又一次請求定位。
65 ： 定位緩存的結果。
66 ： 離線定位結果。通過requestOfflineLocaiton調用時相應的返回結果。
67 ： 離線定位失敗。
通過requestOfflineLocaiton調用時相應的返回結果。
68 ： 網絡連接失敗時，查找本地離線定位時相應的返回結果。
161： 網絡定位結果，網絡定位定位成功。
162： 請求串密文解析失敗，通常是因為clientSO文件載入失敗造成。請嚴格參照開發指南或demo開發，放入相應SO文件。
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-bu[email protected]，以便我們跟進追查問題。
第四步，開始定位
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);四.個人理解
通過第三部分的說明，這三個類之間的關系也是很easy理解的。
LocationClient類作為SDK核心類。對定位服務進行一系列管理和操作，比方開啟和停止定位；
LocationClientOption類是配置信息類。設置定位服務的配置信息。比方定位時間間隔、是否使用GPS等等。
BDLocationListener接口就可以獲得定位數據。那麽在該接口內能夠對定位數據進行處理、或者存儲等等；
在實現定位個過程其中，可能會出現非常多問題。比方不顯示地圖、不能定位、不進入回調函數等等。網上的方法五花八門。可是真的能解決自己的問題嗎？未必。檢查API_KEY、檢查LocationClient是否在主線程中聲明等等，另外一個原因就是百度地圖定位SDK更新非常快。15年還能找到的類。如今可能已經被覆蓋了，所以實在不行，最好的方法就是移植百度的Demo。
Android studio 百度地圖開發（2）地圖定位