本節所使用的示例運行后的界面如圖9-30所示。 :-:  圖9-30　示例運行效果 * 左邊按鈕為"Fine-grain provider"，表示通過GpsLP來獲取位置信息。 * 右邊按鈕為"Both Providers"，表示同時使用GpsLP和NetworkLP來獲取位置信息。 * 按鈕下方的"Lat/Long"表示當前設備的位置信息（經緯度值），而"Address"表示根據該位置信息得到的地址信息。 示例非常簡單，所有內容都集中在LocationActivity.java文件中。先來看onCreate函數，代碼如下所示。 **LocationActivity.java：：onCreate** ~~~ public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); ......// UI 等初始化 // Geocoder：只有Android 2.3版本以后系統才支持該功能 // 同時還需要判斷是否存在GeocoderProvider mGeocoderAvailable = Build.VERSION.SDK_INT >= Build.VERSION_CODES.GINGERBREAD && Geocoder.isPresent(); mHandler = new Handler() {......// Handler的作用是更新圖9-30中的位置和地址信息}; // 客戶端必須要獲取LocationManager來和LMS交互 mLocationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE); } } ~~~ 接著，LocationActivity在其onResume中將調用setup函數完成進一步的初始化工作，其代碼如下所示。 **LocationActivity.java：：setup** ~~~ private void setup() { Location gpsLocation = null; Location networkLocation = null; mLocationManager.removeUpdates(listener); mLatLng.setText(R.string.unknown); mAddress.setText(R.string.unknown); if (mUseFine) { // mUseFine對應為圖9-30中的“Fine-grain Provider”按鈕 ...... // requestUpdatesFromProvider為關鍵函數，下文將詳細分析 gpsLocation = requestUpdatesFromProvider( LocationManager.GPS_PROVIDER,// 該參數為字符串，值為“gps” R.string.not_support_gps); if (gpsLocation != null) updateUILocation(gpsLocation); } else if (mUseBoth) {// mUseBoth對應為圖9-30中的“Both Providers”按鈕 gpsLocation = requestUpdatesFromProvider(LocationManager.GPS_PROVIDER, R.string.not_support_gps); networkLocation = requestUpdatesFromProvider( LocationManager.NETWORK_PROVIDER, // 該參數值為“network” R.string.not_support_network); ...... } } ~~~ 看setup中的關鍵函數requestUpdatesFromProvider代碼如下所示。 **LocationActivity.java：：requestUpdatesFromProvider** ~~~ private Location requestUpdatesFromProvider(final String provider, final int errorResId) { Location location = null; // 判斷由provider指定的LP是否啟用。 if (mLocationManager.isProviderEnabled(provider)) { /* 調用LocationManager的requestLocationUpdates函數，該函數用于注冊一個回調函數以 接收位置變化信息，其各個參數的作用如下。 provider：用于指明使用哪個LP，目前可取參數有“gps”（對應為GpsLP）、“network”（對應 為NetworkLP）、“passive”（對應為PassiveProvider）。 TEN_SECONDS:用于指明多少毫秒更新一次位置數據，本例中使用的值為10秒。 TEN_METERS：用于指明位置變化多少時更新一次數據，本例中使用的值為10米。 listener：類型為LocationListener，當位置發生變化時，其onLocationChanged函數將被調用。 */ mLocationManager.requestLocationUpdates(provider, TEN_SECONDS, TEN_METERS,listener); // getLastKnownLocation用于獲取LP上一次保存的位置信息數據 // Android平臺中，位置信息用Location類表示 location = mLocationManager.getLastKnownLocation(provider); } return location; } ~~~ requestLocationUpdates是LM中非常重要的函數，請讀者務必把握其用法。 當位置信息發生變化后，LocationListener的onChange函數將被調用。本例中使用的LocationListener相關代碼如下所示。 **LocationActivity.java：：LocationListener** ~~~ private final LocationListener listener = new LocationListener() { public void onLocationChanged(Location location) { updateUILocation(location);// 下文將分析它 } // 當用戶在設置中啟用或禁止相關LocationProvider后，下面這兩個函數將被調用 public void onProviderEnabled(String provider) { } public void onProviderDisabled(String provider) { } // 當LocationProvider的狀態發生變化時，下面這個函數將被調用 public void onStatusChanged(String provider, int status, Bundle extras) {} }; ~~~ updateUILocation函數代碼如下所示。 **LocationActivity.java：：updateUILocation** ~~~ private void updateUILocation(Location location) { // updateUILocation的參數location代表對應LP得到的位置信息 // 示例程序將根據該信息來更新圖9-30中“Lat/Long”的值 Message.obtain(mHandler, UPDATE_LATLNG, location.getLatitude() + ", " + location.getLongitude()).sendToTarget(); // doReverseGeocoding根據位置信息來獲取地址信息 if (mGeocoderAvailable) doReverseGeocoding(location); } ~~~ doReverseGeocoding用于根據位置信息來獲取地址信息，由于該工作往往需要通過網絡來查詢，所以doReverseGeocoding內部將創建一個AsyncTask用來完成此工作。我們直接來看AsyncTask的代碼。 **LocationActivity.java：：ReverseGeocodingTask** ~~~ private class ReverseGeocodingTask extends AsyncTask<Location, Void, Void> { Context mContext; ...... protected Void doInBackground(Location... params) { // 創建一個Geocoder對象，它可用于處理地址信息和位置信息的轉換 Geocoder geocoder = new Geocoder(mContext, Locale.getDefault()); Location loc = params[0]; List<Address> addresses = null; try { // getFromLocation用于根據位置信息來查詢對應的地址信息 addresses = geocoder.getFromLocation(loc.getLatitude(), loc.getLongitude(), 1); } ...... if (addresses != null && addresses.size() > 0) { Address address = addresses.get(0); String addressText = String.format("%s, %s, %s", address.getMaxAddressLineIndex() > 0 ? address.getAddressLine(0) : "", address.getLocality(),address.getCountryName()); // 更新圖9-30中的“Address”信息 Message.obtain(mHandler, UPDATE_ADDRESS, addressText).sendToTarget(); } return null; } } ~~~ 通過上述示例可以發現，Android平臺中使用LM非常簡單，其主要工作如下。 1. 先創建一個LocationManager對象，用于和LMS交互。 2. 然后調用requestLocationUpdates以設置一個回調接口對象LocationListener，同時還需要指明使用哪個LP[^①]。 3. 當LP更新相關信息后，LocationListener對應的函數將被調用，應用程序在這些回調函數中做相關處理即可。 4. 如果應用程序需要在位置和地址信息做轉換，則使用Geocoder類提供的函數即可。 雖然LM比較簡單，但它提供的都是一些很基本的功能，如果想實現一些諸如顯示地圖信息這樣的功能，LM就無能為力了。為了實現一些更復雜的位置相關的功能，Google提供了更高級的API來幫助開發者。關于這一部分內容，建議讀者閱讀參考資料[30]。 [^①]:根據審稿專家的意見，有些應用會只傳進定位的條件（精度），而不去指定使用哪個LP。在不帶GPS功能的平臺，若應用只指定從GPS中獲取定位數據，則它將得不到位置信息。