在執行階段要求位置資訊存取權

如果應用程式中的功能需要位置資訊存取權，請等到使用者與該功能互動後再提出權限要求。此工作流程遵循最佳做法，以在情境中要求執行階段權限。如需相關操作說明，請參閱要求應用程式權限指南。

圖 1 說明如何執行此程序的範例。該應用程式包含需要前景位置資訊存取權的「分享位置」功能。但應用程式並不會要求位置存取權，直至使用者選取「分享位置」按鈕。

圖 1 需要前景位置資訊存取權的位置資訊分享功能。如果使用者選取「僅在使用該應用程式時允許」，系統就會啟用這項功能。

使用者只授予大概位置資訊

在 Android 12 (API 級別 31) 以上版本中，即使應用程式要求取得 ACCESS_FINE_LOCATION 執行階段權限，使用者仍可以要求應用程式僅擷取大概位置資訊。

如要處理此潛在的使用者行為，請勿自行要求 ACCESS_FINE_LOCATION 權限。而是在單一執行階段要求中，要求 ACCESS_FINE_LOCATION 權限和 ACCESS_COARSE_LOCATION 權限。如果您嘗試僅要求 ACCESS_FINE_LOCATION，系統會忽略部分 Android 12 版本的要求。如果您的應用程式指定 Android 12 以上版本，系統會在 Logcat 中記錄下列錯誤訊息：

ACCESS_FINE_LOCATION must be requested with ACCESS_COARSE_LOCATION.

注意： 為了更尊重使用者隱私，建議您僅要求 ACCESS_COARSE_LOCATION。即使您只能存取大概位置資訊，也能滿足大多數用途。圖 2 顯示當您的應用程式指定 Android 12，且僅要求 ACCESS_COARSE_LOCATION 時，才會顯示的面向使用者對話方塊。

如果您的應用程式同時要求 ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION，系統權限對話方塊會包含下列選項：

• 精確：允許應用程式取得精確位置資訊。
• 概略：允許應用程式只取得大概位置資訊。

圖 3 顯示對話方塊中包含兩個可協助使用者做出選擇的視覺提示選項。使用者決定位置準確度後，只要輕觸三個按鈕中的其中一個，即可選取授予權限的時間長度。

在 Android 12 及以上版本中，無論應用程式的指定 SDK 版本為何，使用者皆可前往系統設定，為任何應用程式設定偏好位置準確度。即使您的應用程式安裝在搭載 Android 11 或以下版本的裝置上也是如此，隨後系統會讓使用者將裝置升級至 Android 12 或以上版本。

注意： 如果使用者透過權限對話方塊或系統設定將裝置降級，應用程式的位置存取權會從精確變為概略，且系統會重新啟動應用程式程序。因此，請務必遵循要求執行階段權限的最佳做法。

圖 2. 只有在應用程式要求 ACCESS_COARSE_LOCATION 時，才會顯示系統權限對話方塊。

圖 3. 應用程式在單一執行階段要求中同時要求 ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION 時，即會顯示系統權限對話方塊。

使用者的選擇會影響權限授予

下表根據使用者在權限執行階段對話方塊中選擇的選項，顯示系統授予應用程式的權限：

	精確度	概略
使用應用程式時	ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION	ACCESS_COARSE_LOCATION
僅允許這一次	ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION	ACCESS_COARSE_LOCATION
拒絕	沒有位置存取權	沒有位置存取權

如要判斷系統授予應用程式哪些權限，請查看權限要求傳回值。您可以在類似於下列的程式碼中使用 Jetpack 程式庫，也可以使用平台程式庫自行管理權限要求程式碼。

Kotlin

@RequiresApi(Build.VERSION_CODES.N)
fun requestPermissions() {
    val locationPermissionRequest = registerForActivityResult(
        ActivityResultContracts.RequestMultiplePermissions()
    ) { permissions ->
        when {
            permissions.getOrDefault(Manifest.permission.ACCESS_FINE_LOCATION, false) -> {
                // Precise location access granted.
            }
            permissions.getOrDefault(Manifest.permission.ACCESS_COARSE_LOCATION, false) -> {
                // Only approximate location access granted.
            }
            else -> {
                // No location access granted.
            }
        }
    }

    // Before you perform the actual permission request, check whether your app
    // already has the permissions, and whether your app needs to show a permission
    // rationale dialog. For more details, see Request permissions:
    // https://developer.android.com/training/permissions/requesting#request-permission
    locationPermissionRequest.launch(
        arrayOf(
            Manifest.permission.ACCESS_FINE_LOCATION,
            Manifest.permission.ACCESS_COARSE_LOCATION
        )
    )
}
LocationPermissionsActivity.kt

Java

private void requestPermissions() {

    ActivityResultLauncher<String[]> locationPermissionRequest =
            registerForActivityResult(new ActivityResultContracts
                            .RequestMultiplePermissions(), result -> {

                Boolean fineLocationGranted = null;
                Boolean coarseLocationGranted = null;

                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
                    fineLocationGranted = result.getOrDefault(
                            Manifest.permission.ACCESS_FINE_LOCATION, false);
                    coarseLocationGranted = result.getOrDefault(
                            Manifest.permission.ACCESS_COARSE_LOCATION,false);
                }

                if (fineLocationGranted != null && fineLocationGranted) {
                    // Precise location access granted.
                } else if (coarseLocationGranted != null && coarseLocationGranted) {
                    // Only approximate location access granted.
                } else {
                    // No location access granted.
                }
            }
        );

    // ...

    // Before you perform the actual permission request, check whether your app
    // already has the permissions, and whether your app needs to show a permission
    // rationale dialog. For more details, see Request permissions.
    locationPermissionRequest.launch(new String[] {
            Manifest.permission.ACCESS_FINE_LOCATION,
            Manifest.permission.ACCESS_COARSE_LOCATION
    });
}
LocationPermissionsActivityJava.java

要求提升為精確位置

您可以要求使用者將應用程式的存取權從概略位置升級為精確位置。不過，在您要求使用者將應用程式的存取權升級為精確位置前，請考慮您的應用程式用途是否確實需要該等級的精確度。如果您的應用程式需要透過藍牙或 Wi-Fi 與臨近裝置配對，建議使用夥伴模式裝置配對或藍牙權限，而非要求 ACCESS_FINE_LOCATION 權限。

如要要求使用者將應用程式位置存取權從概略位置升級至精確位置，請按照下列步驟執行：

1. 如有需要，請說明應用程式需要該權限的原因。
2. 再次要求 ACCESS_FINE_LOCATION 與 ACCESS_COARSE_LOCATION 權限。由於使用者已經允許系統向應用程式授予大概位置權限，此時的系統對話方塊有所不同，如圖 4 和圖 5 所示：

圖 4. 使用者先前選取的使用者概略和使用應用程式時 (在圖 3 所示對話方塊中)。

圖 5. 使用者先前選取的使用者概略和僅允許這一次 (在圖 3 所示對話方塊中)。

最初只請求前景位置資訊

即使應用程式中的多項功能需要位置存取權，其中可能只有部分功能需要背景位置資訊存取權。因此，建議應用程式執行位置存取權漸進式要求，先要求取得前景位置資訊存取權，然後取得背景位置資訊存取權。藉由執行漸進式要求，使用者能進一步瞭解需要背景位置資訊存取權的功能，因此握有更多掌控權和資訊透明度。

注意：如果您的應用程式指定 Android 11 (API 級別 30) 或以上版本，系統會強制執行此最佳做法。如果您同時要求取得前景位置資訊存取權和背景位置資訊存取權，系統會忽略要求，且不會授予應用程式任何權限。

圖 6 顯示了專為處理漸進式要求設計的應用程式範例。「顯示目前位置」和「建議臨近位置」功能都需要前景位置資訊存取權。不過，只有「建議附近位置」功能需要背景位置資訊存取權。

圖 6. 兩項功能均須位置存取權，但只有「建議鄰近功能」功能需要背景位置資訊存取權。

執行漸進式要求的程序如下：

1. 首先，應用程式應引導使用者存取需要前景位置資訊存取權的功能，如圖 1 中的「分享位置資訊」功能，或圖 2 中的「顯示目前位置資訊」功能。

   在應用程式擁有前景位置資訊存取權之前，建議您禁止使用者存取需要背景位置資訊存取權的功能。

2. 若使用者日後探索需要背景位置資訊存取權的功能，您可以要求背景位置資訊存取權。

其他資源

如要進一步瞭解 Android 中的位置存取權，請參閱下列資料：

程式碼研究室

• 隱私權最佳做法

影片

• 如何尋找可能的背景位置資訊使用方式

範例

• 這個範例應用程式示範位置存取權的使用方式。