Android教程網 >> Android技術 >> Android開發實例 >> Android百度地圖開發教程（二）定位功能介紹及地圖覆蓋物使用示例

Android百度地圖開發教程（二）定位功能介紹及地圖覆蓋物使用示例

編輯：Android開發實例

這一篇文章主要講解的是百度地圖的定位功能，然後還有MyLocationOverlay和PopupOverlay兩個地圖覆蓋物的使用，Overlay是“圖層”或“覆蓋物”的意思，MyLocationOverlay從名字上面理解就是我的位置圖層，他能夠實現在地圖上顯示當前位置的圖標以及指南針，MyLocationOverlay只負責顯示我的位置，位置數據請使用百度定位SDK獲取，將獲取的位置數據放在一個LocationData結構中並用該結構設置MyLcationOverlay的數據源，即可創建MyLocationOverlay，PopupOverlay就是彈出窗口圖層了，跟PopupWindow類似的東西，下面會介紹他們的使用方法
定位我們使用的是百度 Android 定位SDKv4.0，我們先了解下定位原理和定位精度

定位原理
使用百度Android定位SDK必須注冊GPS和網絡使用權限。定位SDK采用GPS、基站、Wi-Fi信號進行定位。當應用程序向定位SDK發起定位請求時，定位SDK會根據應用的定位因素（GPS、基站、Wi-Fi信號）的實際情況（如是否開啟GPS、是否連接網絡、是否有信號等）來生成相應定位依據進行定位。
用戶可以設置滿足自身需求的定位依據：
若用戶設置GPS優先，則優先使用GPS進行定位，如果GPS定位未打開或者沒有可用位置信息，且網絡連接正常，定位SDK則會返回網絡定位（即Wi-Fi與基站）的最優結果。為了使獲得的網絡定位結果更加精確，請打開手機的Wi-Fi開關。

定位精度

了解了百度定位的原理和定位精度之後，接下來我們就來使用百度定位SDKv4.0吧

一 . 導入庫文件

在使用百度定位SDKv4.0之前，我們要下載最新的庫文件，下載地址：點擊下載相關庫文件，將liblocSDK4.so文件拷貝到libs/armeabi目錄下。將locSDK4.0.jar文件拷貝到工程的libs目錄下

二 . 布局文件，一個百度地圖控件，加一個手動點擊實現定位的按鈕，放在一個相對布局裡面，很簡單的布局

<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
    android:layout_width="fill_parent" 
    android:layout_height="fill_parent" > 
 
    <com.baidu.mapapi.map.MapView 
        android:id="@+id/bmapView" 
        android:layout_width="fill_parent" 
        android:layout_height="fill_parent" 
        android:clickable="true" /> 
      
      
     <Button 
         android:id="@+id/request" 
         android:layout_width="wrap_content" 
         android:layout_height="wrap_content" 
         android:layout_alignParentRight="true" 
         android:layout_alignParentTop="true" 
         android:layout_marginRight="10dp" 
         android:layout_marginTop="10dip" 
         android:background="@drawable/custom_loc"  /> 
 
</RelativeLayout>

三 . 界面MainActivity代碼，先貼上，然後適當講解相關代碼，我注釋也比較清楚

package com.example.baidumapdemo;  
 
import android.app.Activity;  
import android.graphics.Bitmap;  
import android.os.Bundle;  
import android.util.Log;  
import android.view.LayoutInflater;  
import android.view.View;  
import android.view.View.MeasureSpec;  
import android.view.View.OnClickListener;  
import android.widget.Button;  
import android.widget.TextView;  
import android.widget.Toast;  
 
import com.baidu.location.BDLocation;  
import com.baidu.location.BDLocationListener;  
import com.baidu.location.LocationClient;  
import com.baidu.location.LocationClientOption;  
import com.baidu.mapapi.BMapManager;  
import com.baidu.mapapi.MKGeneralListener;  
import com.baidu.mapapi.map.LocationData;  
import com.baidu.mapapi.map.MKEvent;  
import com.baidu.mapapi.map.MapController;  
import com.baidu.mapapi.map.MapView;  
import com.baidu.mapapi.map.MyLocationOverlay;  
import com.baidu.mapapi.map.PopupClickListener;  
import com.baidu.mapapi.map.PopupOverlay;  
import com.baidu.platform.comapi.basestruct.GeoPoint;  
 
public class MainActivity extends Activity {  
    private Toast mToast;  
    private BMapManager mBMapManager;  
    private MapView mMapView = null;  
    private MapController mMapController = null;  
      
    /**  
     * 定位SDK的核心類  
     */ 
    private LocationClient mLocClient;  
    /**  
     * 用戶位置信息   
     */ 
    private LocationData mLocData;  
    /**  
     * 我的位置圖層  
     */ 
    private LocationOverlay myLocationOverlay = null;  
    /**  
     * 彈出窗口圖層  
     */ 
    private PopupOverlay mPopupOverlay  = null;  
      
    private boolean isRequest = false;//是否手動觸發請求定位  
    private boolean isFirstLoc = true;//是否首次定位  
      
    /**  
     * 彈出窗口圖層的View  
     */ 
    private View mPopupView;  
    private BDLocation location;  
 
    @Override 
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        //使用地圖sdk前需先初始化BMapManager，這個必須在setContentView()先初始化  
        mBMapManager = new BMapManager(this);  
          
        //第一個參數是API key,  
        //第二個參數是常用事件監聽，用來處理通常的網絡錯誤，授權驗證錯誤等，你也可以不添加這個回調接口  
        mBMapManager.init("7ae13368159d6a513eaa7a17b9413b4b", new MKGeneralListenerImpl());  
        setContentView(R.layout.activity_main);  
          
        //點擊按鈕手動請求定位  
        ((Button) findViewById(R.id.request)).setOnClickListener(new OnClickListener() {  
              
            @Override 
            public void onClick(View v) {  
                requestLocation();  
            }  
        });  
          
        mMapView = (MapView) findViewById(R.id.bmapView); //獲取百度地圖控件實例  
        mMapController = mMapView.getController(); //獲取地圖控制器  
        mMapController.enableClick(true);   //設置地圖是否響應點擊事件  
        mMapController.setZoom(14);   //設置地圖縮放級別  
        mMapView.setBuiltInZoomControls(true);   //顯示內置縮放控件  
          
        mMapView.setTraffic(true);  //設置交通信息圖  
//        mMapView.setSatellite(true);  //設置衛星圖  
//        mMapController.setOverlooking(-45);  //設置地圖俯視角度 ，范圍：0~ -45  
          
          
        mPopupView = LayoutInflater.from(this).inflate(R.layout.pop_layout, null);  
          
        //實例化彈出窗口圖層  
        mPopupOverlay = new PopupOverlay(mMapView ,new PopupClickListener() {  
              
            /**  
             * 點擊彈出窗口圖層回調的方法  
             */ 
            @Override 
            public void onClickedPopup(int arg0) {  
                //隱藏彈出窗口圖層  
                mPopupOverlay.hidePop();  
            }  
        });  
          
          
        //實例化定位服務，LocationClient類必須在主線程中聲明  
        mLocClient = new LocationClient(getApplicationContext());  
        mLocClient.registerLocationListener(new BDLocationListenerImpl());//注冊定位監聽接口  
          
        /**  
         * LocationClientOption 該類用來設置定位SDK的定位方式。  
         */ 
        LocationClientOption option = new LocationClientOption();  
        option.setOpenGps(true); //打開GPRS  
        option.setAddrType("all");//返回的定位結果包含地址信息  
        option.setCoorType("bd09ll");//返回的定位結果是百度經緯度,默認值gcj02  
        option.setPriority(LocationClientOption.GpsFirst); // 設置GPS優先  
        option.setScanSpan(5000); //設置發起定位請求的間隔時間為5000ms  
        option.disableCache(false);//禁止啟用緩存定位  
//      option.setPoiNumber(5);    //最多返回POI個數     
//      option.setPoiDistance(1000); //poi查詢距離          
//      option.setPoiExtraInfo(true);  //是否需要POI的電話和地址等詳細信息          
        mLocClient.setLocOption(option);  //設置定位參數  
          
          
        mLocClient.start();  // 調用此方法開始定位  
          
        //定位圖層初始化  
        myLocationOverlay = new LocationOverlay(mMapView);  
          
          
        //實例化定位數據，並設置在我的位置圖層  
        mLocData = new LocationData();  
        myLocationOverlay.setData(mLocData);  
          
        //添加定位圖層  
        mMapView.getOverlays().add(myLocationOverlay);  
          
        //修改定位數據後刷新圖層生效  
        mMapView.refresh();  
          
          
    }  
      
      
    /**  
     * 定位接口，需要實現兩個方法  
     * @author xiaanming  
     *  
     */ 
    public class BDLocationListenerImpl implements BDLocationListener {  
 
        /**  
         * 接收異步返回的定位結果，參數是BDLocation類型參數  
         */ 
        @Override 
        public void onReceiveLocation(BDLocation location) {  
            if (location == null) {  
                return;  
            }  
              
            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){  
                   sb.append("\nspeed : ");  
                   sb.append(location.getSpeed());  
                   sb.append("\nsatellite : ");  
                   sb.append(location.getSatelliteNumber());  
                   } else if (location.getLocType() == BDLocation.TypeNetWorkLocation){  
                   sb.append("\naddr : ");  
                   sb.append(location.getAddrStr());  
                }   
           
              Log.e("log", sb.toString());  
              
              
            MainActivity.this.location = location;  
              
            mLocData.latitude = location.getLatitude();  
            mLocData.longitude = location.getLongitude();  
            //如果不顯示定位精度圈，將accuracy賦值為0即可  
            mLocData.accuracy = location.getRadius();  
            mLocData.direction = location.getDerect();  
              
            //將定位數據設置到定位圖層裡  
            myLocationOverlay.setData(mLocData);  
            //更新圖層數據執行刷新後生效  
            mMapView.refresh();  
              
              
            if(isFirstLoc || isRequest){  
                //將給定的位置點以動畫形式移動至地圖中心  
                mMapController.animateTo(new GeoPoint(  
                        (int) (location.getLatitude() * 1e6), (int) (location  
                                .getLongitude() * 1e6)));  
                showPopupOverlay(location);  
                isRequest = false;  
            }  
            isFirstLoc = false;  
              
        }  
 
        /**  
         * 接收異步返回的POI查詢結果，參數是BDLocation類型參數  
         */ 
        @Override 
        public void onReceivePoi(BDLocation poiLocation) {  
              
        }  
 
    }  
      
      
 
    //繼承MyLocationOverlay重寫dispatchTap方法  
    private class LocationOverlay extends MyLocationOverlay{  
 
        public LocationOverlay(MapView arg0) {  
            super(arg0);  
        }  
 
          
        /**  
         * 在“我的位置”坐標上處理點擊事件。  
         */ 
        @Override 
        protected boolean dispatchTap() {  
            //點擊我的位置顯示PopupOverlay  
            showPopupOverlay(location);  
            return super.dispatchTap();  
        }  
          
    }  
      
      
    /**  
     * 顯示彈出窗口圖層PopupOverlay  
     * @param location  
     */ 
    private void showPopupOverlay(BDLocation location){  
         TextView popText = ((TextView)mPopupView.findViewById(R.id.location_tips));  
         popText.setText("[我的位置]\n" + location.getAddrStr());  
         mPopupOverlay.showPopup(getBitmapFromView(popText),  
                    new GeoPoint((int)(location.getLatitude()*1e6), (int)(location.getLongitude()*1e6)),  
                    15);  
           
    }  
      
      
    /**  
     * 手動請求定位的方法  
     */ 
    public void requestLocation() {  
        isRequest = true;  
          
        if(mLocClient != null && mLocClient.isStarted()){  
            showToast("正在定位......");  
            mLocClient.requestLocation();  
        }else{  
            Log.d("log", "locClient is null or not started");  
        }  
    }  
      
      
      
     /**   
     * 顯示Toast消息   
     * @param msg   
     */    
    private void showToast(String msg){    
        if(mToast == null){    
            mToast = Toast.makeText(this, msg, Toast.LENGTH_SHORT);    
        }else{    
            mToast.setText(msg);    
            mToast.setDuration(Toast.LENGTH_SHORT);  
        }    
        mToast.show();    
    }   
      
    /**  
     * 將View轉換成Bitmap的方法  
     * @param view  
     * @return  
     */ 
    public static Bitmap getBitmapFromView(View view) {  
        view.measure(MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED), MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED));  
        view.layout(0, 0, view.getMeasuredWidth(), view.getMeasuredHeight());  
        view.buildDrawingCache();  
        Bitmap bitmap = view.getDrawingCache();  
        return bitmap;  
    }  
      
      
      
      
      
    /**  
     * 常用事件監聽，用來處理通常的網絡錯誤，授權驗證錯誤等  
     * @author xiaanming  
     *  
     */ 
    public class MKGeneralListenerImpl implements MKGeneralListener{  
 
        /**  
         * 一些網絡狀態的錯誤處理回調函數  
         */ 
        @Override 
        public void onGetNetworkState(int iError) {  
            if (iError == MKEvent.ERROR_NETWORK_CONNECT) {  
                showToast("您的網絡出錯啦！");  
            }  
        }  
 
        /**  
         * 授權錯誤的時候調用的回調函數  
         */ 
        @Override 
        public void onGetPermissionState(int iError) {  
            if (iError ==  MKEvent.ERROR_PERMISSION_DENIED) {  
                showToast("API KEY錯誤, 請檢查！");  
            }  
        }  
          
    }  
      
    @Override 
    protected void onResume() {  
        //MapView的生命周期與Activity同步，當activity掛起時需調用MapView.onPause()  
        mMapView.onResume();  
        super.onResume();  
    }  
 
 
 
    @Override 
    protected void onPause() {  
        //MapView的生命周期與Activity同步，當activity掛起時需調用MapView.onPause()  
        mMapView.onPause();  
        super.onPause();  
    }  
 
    @Override 
    protected void onDestroy() {  
        //MapView的生命周期與Activity同步，當activity銷毀時需調用MapView.destroy()  
        mMapView.destroy();  
          
        //退出應用調用BMapManager的destroy()方法  
        if(mBMapManager != null){  
            mBMapManager.destroy();  
            mBMapManager = null;  
        }  
          
        //退出時銷毀定位  
        if (mLocClient != null){  
            mLocClient.stop();  
        }  
          
        super.onDestroy();  
    }  
 
      
      
}

LocationClient 定位SDK的核心類,LocationClient類必須在主線程中聲明。需要Context類型的參數。Context需要時全進程有效的context,推薦用getApplicationConext獲取全進程有效的context,我們調用registerLocationListener（BDLocationListener）方法來注冊定位監聽接口，BDLocationListener裡面有兩個方法，onReceiveLocation（）（接收異步返回的定位結果），onReceivePoi（）（接收異步返回的POI查詢結果，POI是“Point of Interest”的縮寫，可以翻譯成“信息點”，每個POI包含四方面信息，名稱、類別、經度、緯度、附近的酒店、飯店，商鋪等信息。我們可以叫它為“導航地圖信息”，導航地圖數據是整個導航產業的基石）,我們這裡只需要重寫onReceiveLocation就行了
BDLocation 封裝了定位SDK的定位結果，在BDLocationListener的onReceive方法中獲取。通過該類用戶可以獲取error code，位置的坐標，精度半徑，地址等信息，對於其getLocType ()方法獲取的error code一些情況

61 ： GPS定位結果
62 ：掃描整合定位依據失敗。此時定位結果無效。
63 ：網絡異常，沒有成功向服務器發起請求。此時定位結果無效。
65 ：定位緩存的結果。
66 ：離線定位結果。通過requestOfflineLocaiton調用時對應的返回結果
67 ：離線定位失敗。通過requestOfflineLocaiton調用時對應的返回結果
68 ：網絡連接失敗時，查找本地離線定位時對應的返回結果
161：表示網絡定位結果
162~167：服務端定位失敗
LocationClientOption 用來設置定位SDK的定位方式，比如設置打開GPS,設置是否需要地址信息,設置發起定位請求的間隔時間等等，參數設置完後調用LocationClient 的setLocOption方法

LocationOverlay MyLocationOverlay的子類，重寫裡面的dispatchTap（）方法，顯示彈出窗口圖層PopupOverlay,調用mMapView.getOverlays().add(myLocationOverlay)就將我的位置圖層添加到地圖裡面
PopupOverlay 彈出圖層，這個類還是比較簡單，裡面只有三個方法，hidePop() （隱藏彈出圖層）showPopup(Bitmap pop, GeoPoint point, int yOffset) （顯示彈出圖層）和showPopup顯示多張圖片的重載方法，由於showPopup方法只接受Bitmap對象，所以我們必須將我們的彈出圖層View對象轉換成Bitmap對象，我們調用getBitmapFromView方法就實現這一轉換
BDLocationListener接口的onReceiveLocation(BDLocation location) 方法我還要重點講解下，我們會發現onReceiveLocation方法會反復執行，他執行的間隔跟LocationClientOption類的setScanSpan()方法設定的值有關，我們設定的是5000毫秒，則onReceiveLocation方法每隔5秒執行一次，注意，當我們設定的值大於1000（ms）,定位SDK內部使用定時定位模式。調用requestLocation( )後，每隔設定的時間，定位SDK就會進行一次定位。如果定位SDK根據定位依據發現位置沒有發生變化，就不會發起網絡請求，返回上一次定位的結果；如果發現位置改變，就進行網絡請求進行定位，得到新的定位結果。如果你只需要定位一次的話，這個設置小於1000，或者不用設置就可以了,定時定位時，調用一次requestLocation，會定時監聽到定位結果

四 . 在運行程序之前，我們還必須在AndroidManifest.xml進行相關配置和權限的聲明
在application標簽中聲明service組件,每個app擁有自己單獨的定位service

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

聲明相關的使用權限

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

五 . 運行結果

源碼下載

轉自：http://blog. csdn. net/xiaanming/article/details/11380619

Android開發實例

Android編程入門 Android技術基礎 Android資訊關於Android編程 Android開發 Android開發環境 Android開發實例

相關文章