Android studio 百度地圖開發（2）地圖定位

Android studio 百度地圖開發（2）地圖定位

Android studio 百度地圖開發（2）地圖定位

email:chentravelling@163.com

開發環境：win7 64位，Android Studio，請注意是Android Studio。

地圖顯示、工程配置請參考：Android studio 百度地圖開發（1）配置工程、顯示地圖

一.我為百度做點事

最開始自己是從頭到尾地寫了一遍，但是始終不能成功定位，一直沒找到原因，後來也是參考了百度官網上的Demo才弄出來，所以其中的代碼，基本來自百度Demo。喜歡吐槽的朋友請鍵盤留情，然後悄悄飄過吧。

一直以來都是喜歡百度的，儘管百度的的確確不能和Google比。但是，在中國的科技氛圍裡，我覺得百度已經夠好了，所以也貼一點百度地圖定位SDK的產品優勢。

最後，我想問問那些嘴裡罵著百度心裡又離不開百度的朋友：你為中國的科技、IT、社會做了什嗎？

二.定位SDK的應用

言歸正傳，先貼整個工程的代碼，第三部分再解釋說明。

（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：增加百度地圖控制項

 

 

（3）AndroidManifest.xml：增加百度地圖SDK需要的許可權、API_KEY和定位服務

 

 

<!--{cke_protected}{C}%3C!%2D%2D%3Fxml%20version%3D%221.0%22%20encoding%3D%22utf-8%22%3F%2D%2D%3E--><manifest xmlns:android="http://schemas.android.com/apk/res/android" package="intvehapp.intvehapp">    <!--{cke_protected}{C}%3C!%2D%2D%20%E7%99%BE%E5%BA%A6%E5%9C%B0%E5%9B%BEAPI%E6%89%80%E9%9C%80%E6%9D%83%E9%99%90%20%2D%2D%3E-->    <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">    <!--{cke_protected}{C}%3C!%2D%2D%20%E8%AE%BF%E9%97%AE%E7%B2%BE%E7%A1%AE%E4%BD%8D%E7%BD%AE%E7%9A%84%E6%9D%83%E9%99%90%20%2D%2D%3E-->    <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">            </category></action></intent-filter>        </activity>        <!--{cke_protected}{C}%3C!%2D%2D%E7%99%BE%E5%BA%A6API_KEY%2D%2D%3E-->        <meta-data android:name="com.baidu.lbsapi.API_KEY" android:value="iXDGdZtFiPifnNm6dUEFwDRXYQVeZ37V">        <!--{cke_protected}{C}%3C!%2D%2D%E7%99%BE%E5%BA%A6%E5%AE%9A%E4%BD%8D%E6%9C%8D%E5%8A%A1%2D%2D%3E-->        <service android:name="com.baidu.location.f" android:enabled="true" android:process=":remote">        </service>    </meta-data></application></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></uses-permission></manifest>

ok，通過這三部分，就可以成功定位了。效果如下：

三.定位SDK相關說明

【摘自百度官網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號和大體定位時間到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 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： 請求串密文解析失敗，一般是由於用戶端SO檔案載入失敗造成，請嚴格參照開發指南或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-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);

 

四.個人理解

通過第三部分的說明，這三個類之間的關係也是非常容易理解的。

LocationClient類作為SDK核心類，對定位服務進行一系列管理和操作，比如開啟和停止定位；

LocationClientOption類是配置資訊類，設定定位服務的配置資訊，比如定位時間間隔、是否使用GPS等等；

BDLocationListener介面即可獲得定位元據，那麼在該介面內可以對定位元據進行處理、或者儲存等等；

在實現定位個過程當中，可能會出現很多問題，比如不顯示地圖、不能定位、不進入回呼函數等等，網上的方法五花八門，但是真的能解決自己的問題嗎？未必。檢查API_KEY、檢查LocationClient是否在主線程中聲明等等，另外一個原因就是百度地圖定位SDK更新很快，15年還能找到的類，現在可能已經被覆蓋了，所以實在不行，最好的方法就是移植百度的Demo。