Google Map API v2 步步為營 （二）----- Location

接上篇。

改造一下MapsActivity:

public class MapsActivity extends Activity implements LocationListener, InfoWindowAdapter, OnMarkerClickListener, OnMarkerDragListener{
}

實現4個interface：

android.location.LocationListener

GoogleMap.InfoWindowAdapter

GoogleMap.OnMarkerClickListener

GoogleMap.OnMarkerDragListener

本篇要實現在地圖上定位，主要用到LocationListener接口。

另外3個接口關系到 打標記（Marker），移動標記點，以及點擊標記彈出info窗口。這些功能將在下一篇文中整理。   

 

地圖初始化

首先在onCreate中需要對地圖對象做一些設置：

@Override
public void onCreate(Bundle savedInstanceState){
    super.onCreate(savedInstanceState);
    setContentView(R.layout.map);

    ........
            
    if(servicesConnected()){
        initMapView();
    }
}

 

servicesConnected 檢查service是否可用

private boolean servicesConnected() {
    // Check that Google Play services is available
    int resultCode = GooglePlayServicesUtil.isGooglePlayServicesAvailable(this);
    // If Google Play services is available
    if(ConnectionResult.SUCCESS == resultCode) {
        log("Google Play services is available.");
        isServiceOk = true;
    } else {
        // Get the error code
        ConnectionResult connectionResult = new ConnectionResult(resultCode, null);
        int errorCode = connectionResult.getErrorCode();
        // Get the error dialog from Google Play services
        Dialog errorDialog = GooglePlayServicesUtil.getErrorDialog(
                    errorCode,
                    this,
                    RESULT_CODE_SERVICE_FAILURE);

        // If Google Play services can provide an error dialog
        if(errorDialog != null) {
            errorDialog.show();
        }
        isServiceOk = false;
    }
    return isServiceOk;
}

上一篇說過，手機調試環境需要安裝Google Play服務和play store。如果沒有安裝，這里就會返回錯誤碼。

 

initMapView 初始化

private void initMapView(){
    mMapView = ((MapFragment)getFragmentManager().findFragmentById(R.id.map_view)).getMap();
    mMapView.setMapType(GoogleMap.MAP_TYPE_NORMAL);

    UiSettings setting = mMapView.getUiSettings();
    setting.setTiltGesturesEnabled(true);
    //setting.setCompassEnabled(false);
}
    

2行，獲得地圖對象 GoogleMap mMapView；后面很多操作都要通過它。

3行，設在地圖模式為normal

4行，UiSettings 設置人機交互相關的各種按鈕手勢等待，例如：

void setTiltGesturesEnabled(boolean)  是否允許手勢改變視角；

void setCompassEnabled(boolean)  是否顯示指南針；

詳細的UiSettings用法可參考官文 https://developers.google.com/maps/documentation/android/reference/com/google/android/gms/maps/UiSettings

 

移動到經緯度地點

先闡明一個概念，Goolge Map假定地圖本身是固定不動的，移動的是camera（public final class CameraUpdate）。

想象一下，在地球上空漂浮着一只佳能無敵兔，把鏡頭對准魔都，焦距拉近看到了一號線，再拉遠，視角傾斜一下，看到了魔都全貌，還是帶廣角的。不錯吧！

 

回到代碼，這里需要用的GPS。通過LocationManager來獲得位置服務

mLocManager = (LocationManager)getSystemService(Context.LOCATION_SERVICE);
mGPSOk = mLocManager.isProviderEnabled(LocationManager.GPS_PROVIDER);

獲得LocationManager，並檢查GPS是否可用。

在onResume函數中注冊監聽

@Override
protected void onResume(){
    super.onResume();
    if(isServiceOk == false)
        return;

    String provider = getBestProvider();
    if(provider != null){
       mLocManager.requestLocationUpdates(provider, 5*1000, 1, this);
    }

    updateCurrentLoction();
    setLatLng();
}

7行，獲得可用的Location Provider，開啟GPS的情況下這里得到的是GPS provider

9行，注冊位置變化監聽。第二入參5*1000表示每隔5秒更新一次，第三入參表示移動超過1米更新一次。最后一個入參即LocationListener，由於activity implement了LocationListener，所以這里只需要給activity的this指針。

12行和13行的兩個函數，用於主動獲取最新位置，移動地圖到該位置，稍后貼出。

先看一下位置變化的監聽函數，activity在implement了LocationListener后 需要實現一下幾個函數：

/* LocationListener begin */
@Override
public void onLocationChanged(Location newLoction) {
    if(mLocation != null){
        mLocation.setLatitude(newLoction.getLatitude());
        mLocation.setLongitude(newLoction.getLongitude());
        animateLatLng();
    }
}

@Override
public void onProviderDisabled(String arg0) {
    // TODO Auto-generated method stub    
}
@Override
public void onProviderEnabled(String arg0) {
    // TODO Auto-generated method stub    
}
@Override
public void onStatusChanged(String arg0, int arg1, Bundle arg2) {
}
/* LocationListener end */

3～9行，我這里只處理了onLocationChanged，這個函數在location發生變化時會調用到。

我們用了一個私有數據：private Location mLocation = null;

在onLocationChanged函數中，把新的location保存到mLocation中，然后調用animateLatLng把地圖移動到該位置。

=================================================================

mLocation用於記錄每次更新的經緯度，建議在onPause的時候把這個數據保存到本地，我是保存在preference中的。在onResume時讀出來。

這樣可以避免gps不可用的時候，地圖飛回非洲。

當然也可一增加一個對network provider的監聽，通過網絡獲取不太准確的位置，這部份我沒做完整。

因為火星坐標系的問題，我最后換了baidu map，google map的這個apk很多后續的優化就沒做了，汗吧！

=================================================================

有時我們需要主動查詢最新的Location

 2 private void updateCurrentLoction(){
    String bestProvider = getBestProvider();
    Location  newLoction = null;

    if(bestProvider != null)
        newLoction = mLocManager.getLastKnownLocation(bestProvider);

    if(mLocation == null){
        mLocation = new Location("");
    }

    if(newLoction != null){
        mLocation.setLatitude(newLoction.getLatitude());
        mLocation.setLongitude(newLoction.getLongitude());
    }
}

3行，獲取最優的provider

7行，獲取最近一次的location

8～16行，同樣的，新位置記錄到mLocation中。

getBestProvider函數體如下：

private String getBestProvider(){      
    Criteria criteria = new Criteria();
    criteria.setPowerRequirement(Criteria.POWER_LOW);
    criteria.setAccuracy(Criteria.ACCURACY_FINE);
    String bestOne = mLocManager.getBestProvider(criteria, true);
    return bestOne;
}

 

上文用到的兩個函數setLatLng()和animateLatLng()

 

private void setLatLng(boolean marked){
    if(mLocation == null){
        Toast.makeText(this, R.string.gpserr, Toast.LENGTH_LONG).show();
        return;
    }

    double dLat = mLocation.getLatitude();
    double dLong = mLocation.getLongitude();
    log("setLatLng: (" + dLat + "," + dLong + ")");

    //LatLng latlng = new LatLng(31.13893, 121.39668);
    LatLng latlng = new LatLng(dLat, dLong);
    if((latlng.latitude == 0) && (latlng.longitude == 0)){
        //mMapView.moveCamera(CameraUpdateFactory.newLatLng(latlng));
    }else{
        mMapView.moveCamera(CameraUpdateFactory.newLatLngZoom(latlng, 15));
    }
}

private void animateLatLng(boolean guide){
    if(mLocation == null){
        Toast.makeText(this, R.string.gpserr, Toast.LENGTH_LONG).show();
        return;
    }
        
    double dLat = mLocation.getLatitude();
    double dLong = mLocation.getLongitude();
    log("animateLatLng: (" + dLat + "," + dLong + ")");
    LatLng latlng = new LatLng(dLat, dLong);
        
    mMapView.animateCamera(CameraUpdateFactory.newLatLng(latlng));        
}

 

先看第一個setLatLng()：

7～8行，從mLocation中調用getLatitude()取得維度，getLongitude()取得經度。

12行，構造一個LatLng對象

16行， mMapView.moveCamera(CameraUpdateFactory.newLatLngZoom(latlng, 15));

CameraUpdateFactory.newLatLngZoom(latlng, 15) 返回一個CameraUpdate對象，入參是經緯度和zoom level；

GoogleMap的moveCamera方法把地圖移動到該位置。

animateLatLng()函數

31行  基本相同，唯一的區別是最后調用的是animateCamera，我們會看到地圖從原location移動到新location的過程。而moveCamera方法是瞬移過去的，不會看到移動過程。

CameraUpdate有很多中構造方法，可以單獨或同時指定位置和放大倍數。指定邊界等待，詳見

https://developers.google.com/maps/documentation/android/reference/com/google/android/gms/maps/CameraUpdateFactory

 

 

最后，要在onPause函數中注銷位置服務監聽

mLocManager.removeUpdates(this);