Android 地圖與定位 (Maps and Positioning)(3)

Positioning Demo

前面兩篇(1, 2)主要都是在講地圖，這篇要來講定位，本篇會用一個簡單的軌跡顯示範例來說明。使用地圖時有些必要條件，雖然第一篇有提過了，不過還是再提一下：

• 請確定已經下載最新版本的 Google Play services client library 並且加入 Eclipse 中
• SDK 必須使用 Android version 2.2 (API level 8) 或之後的版本，但因為有用到 MapFragment 所以 Mini target SDK 必須大於 12。(建議直接用最新的SDK會遇到最少問題)

執行步驟

本篇會接在前兩篇所用的範例程式碼之後，這個範例只是在地圖上加上定位的功能而以，步驟如下：

1. 設定權限
2. 取得位置提供器
3. 顯示已知的上一次的位置
4. 建立偵聽器
5. 建立"我"的標記
6. 讓攝影機追著"我"跑
7. 畫出移動軌跡
8. 更新位置資訊

1. 設定權限

權限有兩種：

• ACCESS_COARSE_LOCATION (A-GPS基地台、網路定位，較不精準、速度快、室內也可定位)
• ACCESS_FINE_LOCATION (使用GPS衛星定位，較精準、速度慢、受限於環境)

請求的權限會關係到定位的精準度。請求 ACCESS_FINE_LOCATION 意味著也請求了 ACCESS_COARSE_LOCATION。

設定 AndroidManifest.xml

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

位置資料的精準度取決於兩個條件，一個是開發者請求的位置提供器權限(例如GPS定位、A-GPS定位)，另一個則要看裝置本身的GPS接收器是否夠精準。

2. 取得位置提供器

*備註*：本範例是在第 2 篇的程式內增加有關 GPS 的部份，所以程式碼有些重覆的部份就不貼了，基本上地圖的程式碼都沒有更動。

另外有人有提到測試時畫面一片白，地圖沒有顯示的問題，後來查了一下，網路連線是原因之一，另外一個就是 Api key 的部份，因為範例裡面是用我的 Api key，所以如果你的套件名稱有換過，就會失效，建議你自己申請一個 Api key 來用，不然如果哪天我把 Api key 刪了，原本提供的範例就會不能用。

/** Map */
private GoogleMap mMap;
private TextView txtOutput;
private Marker markerMe;

/** 記錄軌跡 */
private ArrayList<LatLng> traceOfMe;

/** GPS */
private LocationManager locationMgr;
private String provider;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);
}

@Override
protected void onStart() {
    super.onStart();

    initView();
    initMap();
    if (initLocationProvider()) {
        whereAmI();
    }else{
        txtOutput.setText("請開啟定位！");
    }
}

@Override
protected void onStop() {
    locationMgr.removeUpdates(locationListener);
    super.onStop();
}

private void initView(){
    txtOutput = (TextView) findViewById(R.id.txtOutput);
}

/**
 * GPS初始化，取得可用的位置提供器
 * @return
 */
private boolean initLocationProvider() {
 locationMgr = (LocationManager) getSystemService(Context.LOCATION_SERVICE);

 //1.選擇最佳提供器
// Criteria criteria = new Criteria();
// criteria.setAccuracy(Criteria.ACCURACY_FINE);
// criteria.setAltitudeRequired(false);
// criteria.setBearingRequired(false);
// criteria.setCostAllowed(true);
// criteria.setPowerRequirement(Criteria.POWER_LOW);
//  
// provider = locationMgr.getBestProvider(criteria, true);
//  
// if (provider != null) {
//  return true;
// }

 //2.選擇使用GPS提供器
 if (locationMgr.isProviderEnabled(LocationManager.GPS_PROVIDER)) {
  provider = LocationManager.GPS_PROVIDER;
  return true;
 }

 //3.選擇使用網路提供器
// if (locationMgr.isProviderEnabled(LocationManager.NETWORK_PROVIDER)) {
//  provider = LocationManager.NETWORK_PROVIDER;
//  return true;
// }

 return false;
}

原本寫在 onCreate() 的程式碼現在都移到 onStart() 中。

這裡寫出 3 種常用的位置提供器寫法，第 1 種是開發者提出條件，告訴系統想要取得什麼樣的提供器，Criteria 是用來建立想要取得的提供器的標準，系統會去找出符合或條件之內的提供器。

第 2 種是指名使用 GPS 衛星定位，所以必須判斷裝置是否有 GPS 設備，才能拿來使用。本範例是使用 GPS 定位。

第 3 種是使用網路定位。

一開始我是用第 1 種，結果系統給我網路定位(也就是第 3 種)提供器，我在路上繞了半天都沒什麼反應。後來就使用第 2 種 GPS 定位，只要 5 秒內走超過 5 公尺(依設定條件)，就會更新資料，總算有看到地圖在動。

3. 顯示已知的上一次的位置

Location location = locationMgr.getLastKnownLocation(provider);
updateWithNewLocation(location);

如果有上次最後記錄的位置資料，就可以取出來立即顯示。如果沒有的話 location 會是 null。

4. 建立偵聽器

/**
 * 執行"我"在哪裡
 * 1.建立位置改變偵聽器
 * 2.預先顯示上次的已知位置
 */
private void whereAmI(){
 //取得上次已知的位置
 Location location = locationMgr.getLastKnownLocation(provider);
 updateWithNewLocation(location);

 //GPS Listener
 locationMgr.addGpsStatusListener(gpsListener);

 //Location Listener
 int minTime = 5000;//ms
 int minDist = 5;//meter
 locationMgr.requestLocationUpdates(provider, minTime, minDist, locationListener);
 }

一開始先顯示上次的位罝。接著建立 GPS 偵聽器，用來知道 GPS 的狀態。最後建立位置偵聽器，我們設定的更新條件為「更新時間為 5 秒，且距離超過 5 公尺」必須同時符合這兩個條件，偵聽器才會接受更新。

GPS 偵聽器：

GpsStatus.Listener gpsListener = new GpsStatus.Listener() {
    @Override
    public void onGpsStatusChanged(int event) {
        switch (event) {
            case GpsStatus.GPS_EVENT_STARTED:
            Log.d(TAG, "GPS_EVENT_STARTED");
            Toast.makeText(MainActivity.this, "GPS_EVENT_STARTED", Toast.LENGTH_SHORT).show();
            break;
            case GpsStatus.GPS_EVENT_STOPPED:
            Log.d(TAG, "GPS_EVENT_STOPPED");
            Toast.makeText(MainActivity.this, "GPS_EVENT_STOPPED", Toast.LENGTH_SHORT).show();
            break;
            case GpsStatus.GPS_EVENT_FIRST_FIX:
            Log.d(TAG, "GPS_EVENT_FIRST_FIX");
            Toast.makeText(MainActivity.this, "GPS_EVENT_FIRST_FIX", Toast.LENGTH_SHORT).show();
            break;
            case GpsStatus.GPS_EVENT_SATELLITE_STATUS:
            Log.d(TAG, "GPS_EVENT_SATELLITE_STATUS");
            break;
       }
    }
};

位置偵聽器：

LocationListener locationListener = new LocationListener(){
 @Override
 public void onLocationChanged(Location location) {
  updateWithNewLocation(location);
 }

 @Override
 public void onProviderDisabled(String provider) {
  updateWithNewLocation(null);
 }

 @Override
 public void onProviderEnabled(String provider) {

 }

 @Override
 public void onStatusChanged(String provider, int status, Bundle extras) {
  switch (status) {
      case LocationProvider.OUT_OF_SERVICE:
      Log.v(TAG, "Status Changed: Out of Service");
      Toast.makeText(MainActivity.this, "Status Changed: Out of Service", Toast.LENGTH_SHORT).show();
      break;
      case LocationProvider.TEMPORARILY_UNAVAILABLE:
      Log.v(TAG, "Status Changed: Temporarily Unavailable");
      Toast.makeText(MainActivity.this, "Status Changed: Temporarily Unavailable", Toast.LENGTH_SHORT).show();
      break;
      case LocationProvider.AVAILABLE:
                 Log.v(TAG, "Status Changed: Available");
      Toast.makeText(MainActivity.this, "Status Changed: Available", Toast.LENGTH_SHORT).show();
      break;
  }
 }

};

5. 建立"我"的標記

/**
 * 顯示"我"在哪裡
 * @param lat
 * @param lng
 */
private void showMarkerMe(double lat, double lng){
 if (markerMe != null) {
  markerMe.remove();
 }

 MarkerOptions markerOpt = new MarkerOptions();
 markerOpt.position(new LatLng(lat, lng));
 markerOpt.title("我在這裡");
 markerMe = mMap.addMarker(markerOpt);

 Toast.makeText(this, "lat:" + lat + ",lng:" + lng, Toast.LENGTH_SHORT).show();
}

這裡我原本的想法是單純的去改變 MarkerOptions 的 position 屬性，但是沒反應，應該是 Marker 被建立到地圖上就不能再改變其位置了，所以我後來改為移除前一個 Marker ，同時在新的位置建立一個新的 Marker 。

6. 讓攝影機追著"我"跑

private void cameraFocusOnMe(double lat, double lng){
 CameraPosition camPosition = new CameraPosition.Builder()
    .target(new LatLng(lat, lng))
    .zoom(16)
    .build();

 mMap.animateCamera(CameraUpdateFactory.newCameraPosition(camPosition));
}

7. 畫出移動軌跡

private void trackToMe(double lat, double lng){
 if (traceOfMe == null) {
  traceOfMe = new ArrayList<LatLng>();
}
 traceOfMe.add(new LatLng(lat, lng));

 PolylineOptions polylineOpt = new PolylineOptions();
 for (LatLng latlng : traceOfMe) {
  polylineOpt.add(latlng);
 }

 polylineOpt.color(Color.RED);

 Polyline line = mMap.addPolyline(polylineOpt);
 line.setWidth(10);
}

8. 更新位置資訊

/**
 * 更新並顯示新位置
 * @param location
 */
private void updateWithNewLocation(Location location) {
 String where = "";
 if (location != null) {
  //經度
  double lng = location.getLongitude();
  //緯度
  double lat = location.getLatitude();
  //速度
  float speed = location.getSpeed();
  //時間
  long time = location.getTime();
  String timeString = getTimeString(time);

  where = "經度: " + lng + 
   "\n緯度: " + lat + 
   "\n速度: " + speed + 
   "\n時間: " + timeString +
   "\nProvider: " + provider;

  //"我"
  showMarkerMe(lat, lng);
  cameraFocusOnMe(lat, lng);
  trackToMe(lat, lng);

 }else{
  where = "No location found.";
 }

 //顯示資訊
 txtOutput.setText(where);
}

private String getTimeString(long timeInMilliseconds){
 SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
 return format.format(timeInMilliseconds);
}

這裡我讓資訊顯示在地圖上方，可以看到經、緯度、速度、時間及提供器。

以下為測試中的截圖，用的是第 1 種提供器的寫法，走來走去都沒什麼反應，圖上顯示的是最後一次的位置的資料，所以表示還是有抓到資料。這個版本效果不太好，簡直不能用。後來成功畫出軌跡的測試沒有圖，有機會在補上。 這篇應該是我寫過最累人的技術文章，大熱天的跑出去曬太陽，定了半天沒反應還要回來重寫，實測加上撰寫，斷斷續續的大概花了三、四天的時間吧，呼~~總算寫完了。看到軌跡出現的那一刻，真是開心 :)

---

----------------- (沒圖沒真相，補圖 2013/6/11) ------------------ 在運作時，標記會在螢幕中央，可以用手指移動地圖，但只要符合更新條件(5秒5公尺)就會再次把畫面移到正中央，以標記為中心點。這裡因為要截圖，所以把畫面移動過。

範例程式碼已上傳到 GitHub : https://github.com/tony915/GoogleMapDemo

參考資料

• http://developer.android.com/reference/android/location/LocationManager.html
• http://developer.android.com/reference/android/location/Criteria.html
• http://stackoverflow.com/questions/14222152/androids-onstatuschanged-not-working
• http://stackoverflow.com/questions/6755880/how-to-test-gps-status
• http://stackoverflow.com/questions/16312754/move-marker-on-google-maps-api-2

本文網址：http://blog.tonycube.com/2013/06/androidmaps-and-positioning3.html
由 Tony Blog 撰寫，請勿全文複製，轉載時請註明出處及連結，謝謝 😀