本頁面由 Cloud Translation API 翻譯而成。

要求接獲位置更新通知

適當地使用位置資訊，可能對應用程式。舉例來說，如果您的應用程式協助使用者在步行或行走時規劃路線，或應用程式追蹤資產位置，則應用程式必須取得定期的裝置位置。還有地理位置地點 (經緯度) 時，建議您進一步為使用者提供資訊，例如方位 (行進的水平方向)、高度或裝置的速率如需更多資訊，請參閱 Location 應用程式可從融合式位置提供者。作為回應，API 會定期以根據目前所在位置找出最準確的地點 Wi-Fi 和 GPS (全球定位系統) 等服務供應商。更準確的位置則是由供應商決定你已授予的位置存取權要求，以及您在位置資訊要求中設定的選項。

本課程將說明如何要求定期更新裝置的使用 requestLocationUpdates()敬上方法。

取得最後已知位置

裝置的最後已知位置是個方便的基地，可於請先確定應用程式已含已知位置，再開始定期更新位置資訊。取得最後已知位置：如何撥打電話取得最後已知位置？ getLastLocation()。以下章節的程式碼片段假設您的應用程式已已擷取最後已知位置並儲存為全域變數中的 Location 物件 mCurrentLocation。

提出位置資訊要求

應用程式必須先連線至位置資訊，才能要求位置更新通知並提出位置資訊要求變更位置資訊設定中示範了具體做法提出位置資訊要求後，即可開始使用可以呼叫 requestLocationUpdates()。

根據要求格式，整合式位置預測提供工具會叫用 LocationCallback.onLocationResult()敬上並傳遞 Location 物件清單給這個方法發行 PendingIntent ，在其延伸資料中包含該位置。此外，資料的準確率與頻率更新項目會受到您要求的位置存取權您在位置資訊要求物件中設定的選項。

本課程將說明如何使用 LocationCallback敬上回呼方法。致電 requestLocationUpdates()、並向其傳送 LocationRequest。物件和 LocationCallback。請定義 startLocationUpdates() 方法，如以下程式碼範例所示：

Kotlin

override fun onResume() {
    super.onResume()
    if (requestingLocationUpdates) startLocationUpdates()
}

private fun startLocationUpdates() {
    fusedLocationClient.requestLocationUpdates(locationRequest,
            locationCallback,
            Looper.getMainLooper())
}

Java

@Override
protected void onResume() {
    super.onResume();
    if (requestingLocationUpdates) {
        startLocationUpdates();
    }
}

private void startLocationUpdates() {
    fusedLocationClient.requestLocationUpdates(locationRequest,
            locationCallback,
            Looper.getMainLooper());
}

請注意，上述程式碼片段參照的是布林值標記 requestingLocationUpdates，用於追蹤使用者是否已開啟定位功能開啟或關閉更新。如果使用者關閉了位置更新功能，您可以通知指出應用程式的地理位置規定。適用對象進一步瞭解如何在請參閱「儲存活動狀態」。

定義位置更新通知的回呼

整合式位置預測提供工具會叫用 LocationCallback.onLocationResult()敬上回呼方法。傳入的引數包含 Location 清單物件，內含位置的經緯度。下列程式碼片段會說明如何在 LocationCallback敬上並定義方法，然後取得位置更新的時間戳記並在應用程式使用者上顯示經緯度介面：

Kotlin

private lateinit var locationCallback: LocationCallback

// ...

override fun onCreate(savedInstanceState: Bundle?) {
    // ...

    locationCallback = object : LocationCallback() {
        override fun onLocationResult(locationResult: LocationResult?) {
            locationResult ?: return
            for (location in locationResult.locations){
                // Update UI with location data
                // ...
            }
        }
    }
}

Java

private LocationCallback locationCallback;

// ...

@Override
protected void onCreate(Bundle savedInstanceState) {
    // ...

    locationCallback = new LocationCallback() {
        @Override
        public void onLocationResult(LocationResult locationResult) {
            if (locationResult == null) {
                return;
            }
            for (Location location : locationResult.getLocations()) {
                // Update UI with location data
                // ...
            }
        }
    };
}

停止位置更新通知

考慮是否要在活動發生時停止位置更新通知使用者就會失去焦點，例如使用者切換至其他應用程式同一個應用程式中的不同活動。有效降低耗電量前提是應用程式不需收集它會在背景執行本節說明如何停止活動的 onPause() 方法。

如要停止位置更新通知，請撥打 removeLocationUpdates()、傳送 LocationCallback, 如以下程式碼範例所示：

Kotlin

override fun onPause() {
    super.onPause()
    stopLocationUpdates()
}

private fun stopLocationUpdates() {
    fusedLocationClient.removeLocationUpdates(locationCallback)
}

Java

@Override
protected void onPause() {
    super.onPause();
    stopLocationUpdates();
}

private void stopLocationUpdates() {
    fusedLocationClient.removeLocationUpdates(locationCallback);
}

使用布林值 requestingLocationUpdates 追蹤是否開啟位置更新功能。在活動的 onResume() 方法，請檢查是否正在啟用位置更新功能；如果沒有，請啟用：

Kotlin

override fun onResume() {
    super.onResume()
    if (requestingLocationUpdates) startLocationUpdates()
}

Java

@Override
protected void onResume() {
    super.onResume();
    if (requestingLocationUpdates) {
        startLocationUpdates();
    }
}

儲存活動狀態

變更裝置設定，例如畫面變更方向或語言，可能會導致目前活動遭到刪除。您的因此，應用程式必須儲存重建活動所需的任何資訊。其中一個做法是透過儲存於 Bundle 物件。

以下程式碼範例說明如何使用活動的 onSaveInstanceState()敬上儲存實例狀態的回呼：

Kotlin

override fun onSaveInstanceState(outState: Bundle?) {
    outState?.putBoolean(REQUESTING_LOCATION_UPDATES_KEY, requestingLocationUpdates)
    super.onSaveInstanceState(outState)
}

Java

@Override
protected void onSaveInstanceState(Bundle outState) {
    outState.putBoolean(REQUESTING_LOCATION_UPDATES_KEY,
            requestingLocationUpdates);
    // ...
    super.onSaveInstanceState(outState);
}

定義要還原的 updateValuesFromBundle() 方法也就是上一個活動例項中儲存的值 (如果有的話) 廣告。從活動的 onCreate() 方法，如請看以下程式碼範例：

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    // ...
    updateValuesFromBundle(savedInstanceState)
}

private fun updateValuesFromBundle(savedInstanceState: Bundle?) {
    savedInstanceState ?: return

    // Update the value of requestingLocationUpdates from the Bundle.
    if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
        requestingLocationUpdates = savedInstanceState.getBoolean(
                REQUESTING_LOCATION_UPDATES_KEY)
    }

    // ...

    // Update UI to match restored state
    updateUI()
}

Java

@Override
public void onCreate(Bundle savedInstanceState) {
    // ...
    updateValuesFromBundle(savedInstanceState);
}

private void updateValuesFromBundle(Bundle savedInstanceState) {
    if (savedInstanceState == null) {
        return;
    }

    // Update the value of requestingLocationUpdates from the Bundle.
    if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
        requestingLocationUpdates = savedInstanceState.getBoolean(
                REQUESTING_LOCATION_UPDATES_KEY);
    }

    // ...

    // Update UI to match restored state
    updateUI();
}

如要進一步瞭解如何儲存執行個體狀態，請參閱 Android Activity 類別參考資料。

注意：如要增加永久儲存空間，您可以將使用者偏好設定儲存在應用程式的 SharedPreferences。將共用偏好設定設為活動的 onPause() 方法，以及擷取 onResume() 中的偏好設定。如要進一步瞭解如何儲存偏好設定，請參閱儲存中鍵/值組合

其他資源

如需瞭解更多資訊，不妨參考以下資源：

範例

範例應用程式，示範如何在 Android 中接收位置更新資訊。

變更位置資訊設定

在背景中存取位置資訊