要求位置存取權

為保護使用者隱私，使用定位服務的應用程式必須要求位置存取權。

要求位置存取權時，請遵循要求任何其他執行階段權限時所採取的相同最佳做法。就位置存取權而言，系統包括與位置相關的多項權限，此為一項重要的差異。您要求哪些權限以及如何要求這些權限，視應用程式使用狀況適用的位置資訊需求而定。

本頁面說明不同類型的地點規定，並指引如何在各種情況下要求位置存取權。

位置資訊存取權限類型

每種權限都具有以下特性：

• 類別：前景位置資訊或背景位置資訊。
• 準確度：精確位置或大概位置。

前景位置資訊

如果您的應用程式包含只會分享或接收位置資訊一次，或只在指定時間內分享位置資訊的功能，則必須取得前景位置資訊存取權才能執行該功能。以下提供幾個範例：

• 使用者可以利用導航應用程式提供的功能，取得即時路線導航。
• 使用者可以利用訊息應用程式，將自己目前的位置分享給其他使用者。

如果應用程式的特定功能會在下列任一情況下存取裝置的目前位置，系統就會判定您的應用程式將使用前景位置資訊：

• 屬於應用程式的活動會顯示在畫面上。

• 您的應用程式正在執行前景服務。執行前景服務時，系統會透過顯示常駐通知來吸引使用者的注意。應用程式會在處於背景時保留存取權，例如當使用者按下裝置上的「主畫面」按鈕或關閉裝置螢幕時。

  此外，建議您宣告 location 的前景服務類型，如以下程式碼片段所示。在 Android 10 (API 級別 29) 以上版本中，您必須宣告此前景服務類型。

  <!-- Recommended for Android 9 (API level 28) and lower. -->
  <!-- Required for Android 10 (API level 29) and higher. -->
  <service
      android:name="MyNavigationService"
      android:foregroundServiceType="location" ... >
      <!-- Any inner elements would go here. -->
  </service>

應用程式要求 ACCESS_COARSE_LOCATION 權限或 ACCESS_FINE_LOCATION 權限時，您必須宣告應用程式需要使用前景位置資訊，如以下程式碼片段所示：

<manifest ... >
  <!-- Always include this permission -->
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

  <!-- Include only if your app benefits from precise location access. -->
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>

背景位置資訊

如果應用程式中的特定功能會持續與其他使用者分享位置或使用 Geofencing API，應用程式就需要背景位置資訊存取權。以下提供幾個範例：

• 使用者可以利用家庭成員位置資訊分享應用程式提供的功能，與家庭成員持續分享位置資訊。
• 使用者可以利用 IoT 應用程式提供的功能設定家用裝置，讓這些裝置在使用者外出時關閉，並在回家時重新開啟。

只有應用程式在符合「前景位置資訊」一節所述以外的情況下存取裝置的目前位置時，系統才會判定應用程式將使用背景位置資訊。背景位置資訊精確度與前景位置資訊精確度相同，具體取決於應用程式宣告的位置存取權。

在 Android 10 (API 級別 29) 以上版本中，您必須在應用程式的資訊清單中宣告 ACCESS_BACKGROUND_LOCATION 權限，才能在執行階段要求背景位置資訊存取權。而在舊版 Android 上，當您的應用程式獲得前景位置資訊存取權時，該應用程式也會自動獲得背景位置資訊存取權。

<manifest ... >
  <!-- Required only when requesting background location access on
       Android 10 (API level 29) and higher. -->
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
</manifest>

精確度

Android 支援下列級別的定位準確度：

概略

提供裝置位置預估值。如果此位置預估值來自 LocationManagerService 或 FusedLocationProvider，則此預估值準確度為約 3 平方公里 (約 1.2 平方英里)。宣告 ACCESS_COARSE_LOCATION 權限 (而非 ACCESS_FINE_LOCATION 權限) 時，應用程式可接收達到此準確度的位置。

精確度

提供盡可能準確的裝置位置預估值。如果位置預估值來自 LocationManagerService 或 FusedLocationProvider，則此預估值通常約在 50 公尺 (160 英尺) 內，有時甚至不會超過幾公尺 (10 英尺)。宣告 ACCESS_FINE_LOCATION 權限時，應用程式可接收達到此準確度的位置。

如果使用者授予大概位置存取權，則無論應用程式宣告的位置存取權為何，您的應用程式都只能存取大概位置。

即便使用者僅授予概略位置存取權，您的應用程式仍可正常運作。如果應用程式中的某項功能需要透過 ACCESS_FINE_LOCATION 權限來要求精確位置，您可以要求使用者允許應用程式存取精確位置。

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

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

圖 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_FINE_LOCATION 和 ACCESS_COARSE_LOCATION，系統權限對話方塊會包含下列選項：

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

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

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

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

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

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

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.
locationPermissionRequest.launch(arrayOf(
    Manifest.permission.ACCESS_FINE_LOCATION,
    Manifest.permission.ACCESS_COARSE_LOCATION))

ActivityResultLauncher<String[]> locationPermissionRequest =
    registerForActivityResult(new ActivityResultContracts
        .RequestMultiplePermissions(), result -> {
            Boolean fineLocationGranted = result.getOrDefault(
                    Manifest.permission.ACCESS_FINE_LOCATION, false);
            Boolean 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
});

要求提升為精確位置

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

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

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

最初只請求前景位置資訊

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

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

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

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

   建議您停用需要背景位置資訊存取權的功能，直到應用程式具備前景位置資訊存取權為止。

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

視情況請求背景位置資訊

權限對話方塊的內容取決於目標 SDK 版本

當應用程式功能在搭載 Android 10 (API 級別 29) 的裝置上要求背景位置資訊時，系統權限對話方塊包含名稱為「一律允許」的選項。如果使用者選取此選項，應用程式功能就會取得背景位置資訊存取權。

不過，在 Android 11 (API 級別 30) 及以上版本中，系統對話方塊不包含一律允許選項。使用者必須改為在設定頁面啟用背景位置資訊，如圖 7 所示。

使用者要求背景位置資訊存取權時，您可以遵循最佳做法，協助他們前往設定頁面。授予權限的程序視應用程式的目標 SDK 版本而定。

應用程式指定 Android 11 或以上版本

如果您的應用程式尚未取得 ACCESS_BACKGROUND_LOCATION 權限，且 shouldShowRequestPermissionRationale() 傳回 true，請向使用者顯示含有以下內容的教育性質 UI：

• 清楚說明應用程式功能需要存取背景位置資訊的原因。
• 使用者可以看到的授權背景位置資訊的選項設定標籤 (例如，圖 7 中的「一律允許」)。您可以呼叫 getBackgroundPermissionOptionLabel() 以取得此標籤。此方法的傳回值會根據使用者裝置的語言偏好設定進行本地化。
• 使用者拒絕權限的選項。如果使用者拒絕背景位置資訊存取權，他們應能繼續使用應用程式。

應用程式指定 Android 10 或以下版本

當應用程式功能要求背景位置資訊存取權時，使用者會看到系統對話方塊。此對話方塊包含前往設定頁面上的位置資訊存取權選項。

如果應用程式已經遵循要求位置存取權的最佳做法，則無須做出任何變更即可支援此行為。

使用者可影響背景位置資訊的精確度

如果使用者要求概略位置，使用者的位置存取權對話方塊也會選擇背景位置資訊。換句話說，如果使用者授予應用程式 ACCESS_BACKGROUND_LOCATION 權限，但只在前景中授予概略位置資訊存取權，應用程式在背景中也只有概略位置資訊存取權。

授予背景位置資訊權限的提醒

在 Android 10 以上版本中，使用者授予背景位置資訊存取權後，如果應用程式功能首次在背景中存取裝置位置資訊，系統會排程傳送給使用者的通知。此通知會提醒使用者，他們已經允許應用程式隨時存取裝置位置資訊。圖 8 顯示了通知範例。

查看應用程式 SDK 依附元件中的位置規定

查看應用程式是否使用任何依附於位置存取權的 SDK (尤其是 ACCESS_FINE_LOCATION 權限)。請參閱有關瞭解 SDK 依附元件行為的媒體文章。

其他資源

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

程式碼研究室

• 隱私權最佳做法

影片

• 如何找出可能在使用背景位置資訊的情形

範例

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