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 初始化

1 private void initMapView(){
2     mMapView = ((MapFragment)getFragmentManager().findFragmentById(R.id.map_view)).getMap();
3     mMapView.setMapType(GoogleMap.MAP_TYPE_NORMAL);
4 
5     UiSettings setting = mMapView.getUiSettings();
6     setting.setTiltGesturesEnabled(true);
7     //setting.setCompassEnabled(false);
8 }
9

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函数中注册监听

 1 @Override
 2 protected void onResume(){
 3     super.onResume();
 4     if(isServiceOk == false)
 5         return;
 6 
 7     String provider = getBestProvider();
 8     if(provider != null){
 9        mLocManager.requestLocationUpdates(provider, 5*1000, 1, this);
10     }
11 
12     updateCurrentLoction();
13     setLatLng();
14 }

7行，获得可用的Location Provider，开启GPS的情况下这里得到的是GPS provider

9行，注册位置变化监听。第二入参5*1000表示每隔5秒更新一次，第三入参表示移动超过1米更新一次。最后一个入参即LocationListener，由于activity implement了LocationListener，所以这里只需要给activity的this指针。

12行和13行的两个函数，用于主动获取最新位置，移动地图到该位置，稍后贴出。

先看一下位置变化的监听函数，activity在implement了LocationListener后需要实现一下几个函数：

 1 /* LocationListener begin */
 2 @Override
 3 public void onLocationChanged(Location newLoction) {
 4     if(mLocation != null){
 5         mLocation.setLatitude(newLoction.getLatitude());
 6         mLocation.setLongitude(newLoction.getLongitude());
 7         animateLatLng();
 8     }
 9 }
10 
11 @Override
12 public void onProviderDisabled(String arg0) {
13     // TODO Auto-generated method stub    
14 }
15 @Override
16 public void onProviderEnabled(String arg0) {
17     // TODO Auto-generated method stub    
18 }
19 @Override
20 public void onStatusChanged(String arg0, int arg1, Bundle arg2) {
21 }
22 /* 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

 1  2 private void updateCurrentLoction(){
 3     String bestProvider = getBestProvider();
 4     Location  newLoction = null;
 5 
 6     if(bestProvider != null)
 7         newLoction = mLocManager.getLastKnownLocation(bestProvider);
 8 
 9     if(mLocation == null){
10         mLocation = new Location("");
11     }
12 
13     if(newLoction != null){
14         mLocation.setLatitude(newLoction.getLatitude());
15         mLocation.setLongitude(newLoction.getLongitude());
16     }
17 }

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()

 1 private void setLatLng(boolean marked){
 2     if(mLocation == null){
 3         Toast.makeText(this, R.string.gpserr, Toast.LENGTH_LONG).show();
 4         return;
 5     }
 6 
 7     double dLat = mLocation.getLatitude();
 8     double dLong = mLocation.getLongitude();
 9     log("setLatLng: (" + dLat + "," + dLong + ")");
10 
11     //LatLng latlng = new LatLng(31.13893, 121.39668);
12     LatLng latlng = new LatLng(dLat, dLong);
13     if((latlng.latitude == 0) && (latlng.longitude == 0)){
14         //mMapView.moveCamera(CameraUpdateFactory.newLatLng(latlng));
15     }else{
16         mMapView.moveCamera(CameraUpdateFactory.newLatLngZoom(latlng, 15));
17     }
18 }
19 
20 private void animateLatLng(boolean guide){
21     if(mLocation == null){
22         Toast.makeText(this, R.string.gpserr, Toast.LENGTH_LONG).show();
23         return;
24     }
25         
26     double dLat = mLocation.getLatitude();
27     double dLong = mLocation.getLongitude();
28     log("animateLatLng: (" + dLat + "," + dLong + ")");
29     LatLng latlng = new LatLng(dLat, dLong);
30         
31     mMapView.animateCamera(CameraUpdateFactory.newLatLng(latlng));        
32 }

先看第一个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);

Google Map API v2 步步为营 （二）----- Location

Google Map API v2 步步为营（二）----- Location