Android - 基於位置的服務

---

---

Android 位置 API 使您能夠輕鬆構建位置感知應用程式，而無需關注底層位置技術的細節。

這得益於 **Google Play 服務**，它透過自動位置跟蹤、地理圍欄和活動識別來簡化在您的應用中新增位置感知功能。

本教程將向您展示如何在您的 APP 中使用位置服務來獲取當前位置、獲取定期位置更新、查詢地址等。

位置物件

**Location** 物件表示一個地理位置，它可以包含緯度、經度、時間戳以及其他資訊，如方位角、海拔和速度。您可以使用以下重要方法來獲取位置特定資訊：

獲取當前位置

要獲取當前位置，請建立一個位置客戶端，即 **LocationClient** 物件，使用 **connect()** 方法將其連線到位置服務，然後呼叫其 **getLastLocation()** 方法。此方法返回最近的位置，以 **Location** 物件的形式，其中包含緯度和經度座標以及如上所述的其他資訊。要在您的活動中使用基於位置的功能，您必須實現兩個介面：

• GooglePlayServicesClient.ConnectionCallbacks
• GooglePlayServicesClient.OnConnectionFailedListener

這些介面提供以下重要的回撥方法，您需要在您的活動類中實現它們：

您應該在活動的 **onCreate()** 方法中建立位置客戶端，然後在 **onStart()** 中連線它，以便位置服務在您的活動完全可見時維護當前位置。您應該在 **onStop()** 方法中斷開客戶端的連線，以便當您的應用不可見時，位置服務不會維護當前位置。這有助於在很大程度上節省電池電量。

獲取更新的位置

如果您希望獲得位置更新，那麼除了上面提到的介面之外，您還需要實現 **LocationListener** 介面。此介面提供以下回調方法，您需要在您的活動類中實現它：

位置服務質量

**LocationRequest** 物件用於從 **LocationClient** 請求位置更新的服務質量 (QoS)。以下是一些可用於處理 QoS 的有用 setter 方法。在 Android 官方文件中，您可以檢視相應的 getter 方法。

例如，如果您的應用程式需要高精度位置，則應建立一個位置請求，將 **setPriority(int)** 設定為 PRIORITY_HIGH_ACCURACY，並將 **setInterval(long)** 設定為 5 秒。您還可以使用更大的間隔和/或其他優先順序（如 PRIORITY_LOW_POWER 以請求“城市”級別的精度或 PRIORITY_BALANCED_POWER_ACCURACY 以請求“街區”級別的精度）。

活動應認真考慮在進入後臺時（例如在 onPause() 中）刪除所有位置請求，或者至少將請求切換到更大的間隔和更低的質量以節省電量。

顯示位置地址

獲得 **Location** 物件後，您可以使用 **Geocoder.getFromLocation()** 方法獲取給定緯度和經度的地址。此方法是同步的，可能需要很長時間才能完成其工作，因此您應該從 **AsyncTask** 類的 **doInBackground()** 方法中呼叫此方法。

**AsyncTask** 必須進行子類化才能使用，子類將覆蓋 **doInBackground(Params...)** 方法在後臺執行任務，並且 **onPostExecute(Result)** 方法在後臺計算完成後以及在顯示結果時在 UI 執行緒上被呼叫。AsyncTask 中還有一個重要的可用方法，即 **execute(Params... params)**，此方法使用指定的引數執行任務。

示例

以下示例將向您展示如何在實踐中使用應用中的位置服務來獲取當前位置及其相應的地址等。

要體驗此示例，您需要配備最新 Android 作業系統的實際移動裝置，否則您將不得不與可能無法正常工作的模擬器作鬥爭。

建立 Android 應用

以下是修改後的主活動檔案 **MainActivity.java** 的內容。

package com.example.tutorialspoint7.myapplication;

import android.Manifest;
import android.app.Activity;
import android.os.Bundle;
import android.support.v4.app.ActivityCompat;
import android.test.mock.MockPackageManager;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;

public class MainActivity extends Activity {

   Button btnShowLocation;
   private static final int REQUEST_CODE_PERMISSION = 2;
   String mPermission = Manifest.permission.ACCESS_FINE_LOCATION;

   // GPSTracker class
   GPSTracker gps;

   @Override
   public void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
		
      try {
         if (ActivityCompat.checkSelfPermission(this, mPermission)
            != MockPackageManager.PERMISSION_GRANTED) {

            ActivityCompat.requestPermissions(this, new String[]{mPermission}, 
               REQUEST_CODE_PERMISSION);

            // If any permission above not allowed by user, this condition will
               execute every time, else your else part will work
         }
      } catch (Exception e) {
         e.printStackTrace();
      }

      btnShowLocation = (Button) findViewById(R.id.button);

      // show location button click event
      btnShowLocation.setOnClickListener(new View.OnClickListener() {

         @Override
         public void onClick(View arg0) {
            // create class object
            gps = new GPSTracker(MainActivity.this);

            // check if GPS enabled
            if(gps.canGetLocation()){

               double latitude = gps.getLatitude();
               double longitude = gps.getLongitude();

               // \n is for new line
               Toast.makeText(getApplicationContext(), "Your Location is - \nLat: "
                  + latitude + "\nLong: " + longitude, Toast.LENGTH_LONG).show();
            }else{
               // can't get location
               // GPS or Network is not enabled
               // Ask user to enable GPS/network in settings
               gps.showSettingsAlert();
            }

         }
      });
   }
}

以下是修改後的主活動檔案 **GPSTracker.java** 的內容。

package com.example.tutorialspoint7.myapplication;

import android.app.AlertDialog;
import android.app.Service;
import android.content.Context;
import android.content.DialogInterface;
import android.content.Intent;
import android.location.Location;
import android.location.LocationListener;
import android.location.LocationManager;
import android.os.Bundle;
import android.os.IBinder;
import android.provider.Settings;
import android.util.Log;

public class GPSTracker extends Service implements LocationListener {

   private final Context mContext;

   // flag for GPS status
   boolean isGPSEnabled = false;

   // flag for network status
   boolean isNetworkEnabled = false;

   // flag for GPS status
   boolean canGetLocation = false;

   Location location; // location
   double latitude; // latitude
   double longitude; // longitude

   // The minimum distance to change Updates in meters
   private static final long MIN_DISTANCE_CHANGE_FOR_UPDATES = 10; // 10 meters

   // The minimum time between updates in milliseconds
   private static final long MIN_TIME_BW_UPDATES = 1000 * 60 * 1; // 1 minute

   // Declaring a Location Manager
   protected LocationManager locationManager;

   public GPSTracker(Context context) {
      this.mContext = context;
      getLocation();
   }

   public Location getLocation() {
      try {
         locationManager = (LocationManager) mContext.getSystemService(LOCATION_SERVICE);

         // getting GPS status
         isGPSEnabled = locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER);

         // getting network status
         isNetworkEnabled = locationManager
            .isProviderEnabled(LocationManager.NETWORK_PROVIDER);

         if (!isGPSEnabled && !isNetworkEnabled) {
            // no network provider is enabled
         } else {
            this.canGetLocation = true;
            // First get location from Network Provider
            if (isNetworkEnabled) {
               locationManager.requestLocationUpdates(
                  LocationManager.NETWORK_PROVIDER,
                  MIN_TIME_BW_UPDATES,
                  MIN_DISTANCE_CHANGE_FOR_UPDATES, this);
						
               Log.d("Network", "Network");
               if (locationManager != null) {
                  location = locationManager
                     .getLastKnownLocation(LocationManager.NETWORK_PROVIDER);
							
                  if (location != null) {
                     latitude = location.getLatitude();
                     longitude = location.getLongitude();
                  }
               }
            }
				
            // if GPS Enabled get lat/long using GPS Services
            if (isGPSEnabled) {
               if (location == null) {
                  locationManager.requestLocationUpdates(
                     LocationManager.GPS_PROVIDER,
                     MIN_TIME_BW_UPDATES,
                     MIN_DISTANCE_CHANGE_FOR_UPDATES, this);
							
                  Log.d("GPS Enabled", "GPS Enabled");
                  if (locationManager != null) {
                     location = locationManager
                        .getLastKnownLocation(LocationManager.GPS_PROVIDER);
								
                     if (location != null) {
                        latitude = location.getLatitude();
                        longitude = location.getLongitude();
                     }
                  }
               }
            }
         }

      } catch (Exception e) {
         e.printStackTrace();
      }

      return location;
   }

   /**
      * Stop using GPS listener
      * Calling this function will stop using GPS in your app
   * */
	
   public void stopUsingGPS(){
      if(locationManager != null){
         locationManager.removeUpdates(GPSTracker.this);
      }
   }

   /**
      * Function to get latitude
   * */
	
   public double getLatitude(){
      if(location != null){
         latitude = location.getLatitude();
      }

      // return latitude
      return latitude;
   }

   /**
      * Function to get longitude
   * */
	
   public double getLongitude(){
      if(location != null){
         longitude = location.getLongitude();
      }

      // return longitude
      return longitude;
   }

   /**
      * Function to check GPS/wifi enabled
      * @return boolean
   * */
	
   public boolean canGetLocation() {
      return this.canGetLocation;
   }

   /**
      * Function to show settings alert dialog
      * On pressing Settings button will lauch Settings Options
   * */
	
   public void showSettingsAlert(){
      AlertDialog.Builder alertDialog = new AlertDialog.Builder(mContext);

      // Setting Dialog Title
      alertDialog.setTitle("GPS is settings");

      // Setting Dialog Message
      alertDialog.setMessage("GPS is not enabled. Do you want to go to settings menu?");

      // On pressing Settings button
      alertDialog.setPositiveButton("Settings", new DialogInterface.OnClickListener() {
         public void onClick(DialogInterface dialog,int which) {
            Intent intent = new Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS);
            mContext.startActivity(intent);
         }
      });

      // on pressing cancel button
      alertDialog.setNegativeButton("Cancel", new DialogInterface.OnClickListener() {
         public void onClick(DialogInterface dialog, int which) {
            dialog.cancel();
         }
      });

      // Showing Alert Message
      alertDialog.show();
   }

   @Override
   public void onLocationChanged(Location location) {
   }

   @Override
   public void onProviderDisabled(String provider) {
   }

   @Override
   public void onProviderEnabled(String provider) {
   }

   @Override
   public void onStatusChanged(String provider, int status, Bundle extras) {
   }

   @Override
   public IBinder onBind(Intent arg0) {
      return null;
   }
}

**res/layout/activity_main.xml** 檔案的內容如下：

<?xml version = "1.0" encoding = "utf-8"?>
<LinearLayout xmlns:android = "http://schemas.android.com/apk/res/android"
   android:layout_width = "fill_parent"
   android:layout_height = "fill_parent"
   android:orientation = "vertical" >


   <Button
      android:id = "@+id/button"
      android:layout_width = "fill_parent"
      android:layout_height = "wrap_content"
      android:text = "getlocation"/>

</LinearLayout>

**res/values/strings.xml** 檔案的內容如下，用於定義兩個新的常量：

<?xml version = "1.0" encoding = "utf-8"?>
<resources>
   <string name = "app_name">Tutorialspoint</string>
</resources>

**AndroidManifest.xml** 檔案的預設內容如下：

<?xml version = "1.0" encoding = "utf-8"?>
<manifest xmlns:android = "http://schemas.android.com/apk/res/android"
   package = "com.example.tutorialspoint7.myapplication">
   <uses-permission android:name = "android.permission.ACCESS_FINE_LOCATION" />
   <uses-permission android:name = "android.permission.INTERNET" />
   <application
      android:allowBackup = "true"
      android:icon = "@mipmap/ic_launcher"
      android:label = "@string/app_name"
      android:supportsRtl = "true"
      android:theme = "@style/AppTheme">
		
      <activity android:name = ".MainActivity">
         <intent-filter>
            <action android:name = "android.intent.action.MAIN" />

            <category android:name = "android.intent.category.LAUNCHER" />
         </intent-filter>
      </activity>
   </application>

</manifest>

讓我們嘗試執行您的Tutorialspoint應用程式。我假設您已將您的實際Android移動裝置連線到您的電腦。要從Android Studio執行應用程式，請開啟專案中的一個活動檔案，然後點選工具欄中的執行圖示。在啟動應用程式之前，Android Studio安裝程式將顯示以下視窗，供您選擇要執行Android應用程式的位置。

現在要檢視位置，請選擇“獲取位置”按鈕，它將顯示如下位置資訊：