為保護使用者隱私,使用定位服務的應用程式必須要求位置存取權。
要求位置存取權時,請遵循要求任何其他執行階段權限時所採取的相同最佳做法。就位置存取權而言,系統包括與位置相關的多項權限,此為一項重要的差異。您要求哪些權限以及如何要求這些權限,視應用程式使用狀況適用的位置資訊需求而定。
本頁面說明不同類型的地點規定,並指引如何在各種情況下要求位置存取權。
位置資訊存取權限類型
每種權限都具有以下特性:
前景位置資訊
如果您的應用程式包含只會分享或接收位置資訊一次,或只在指定時間內分享位置資訊的功能,則必須取得前景位置資訊存取權才能執行該功能。以下提供幾個範例:
- 使用者可以利用導航應用程式提供的功能,取得即時路線導航。
- 使用者可以利用訊息應用程式,將自己目前的位置分享給其他使用者。
如果應用程式的特定功能會在下列任一情況下存取裝置的目前位置,系統就會判定您的應用程式將使用前景位置資訊:
- 屬於應用程式的活動會顯示在畫面上。
您的應用程式正在執行前景服務。執行前景服務時,系統會透過顯示常駐通知來吸引使用者的注意。應用程式在背景執行時仍會保留位置存取權,例如使用者按下裝置的「主畫面」按鈕或關閉裝置螢幕時。
此外,建議您宣告
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 或以上版本。
使用者的選擇會影響權限授予
下表根據使用者在權限執行階段對話方塊中選擇的選項,顯示系統授予應用程式的權限:
精確度 | 概略 | |
---|---|---|
使用應用程式時 | ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION |
ACCESS_COARSE_LOCATION |
僅允許這一次 | ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION |
ACCESS_COARSE_LOCATION |
拒絕 | 沒有位置存取權 | 沒有位置存取權 |
如要判斷系統授予應用程式哪些權限,請查看權限要求傳回值。您可以在類似於下列的程式碼中使用 Jetpack 程式庫,也可以使用平台程式庫自行管理權限要求程式碼。
Kotlin
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))
Java
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
權限。
如要要求使用者將應用程式位置存取權從概略位置升級至精確位置,請按照下列步驟執行:
- 如有需要,請說明應用程式需要該權限的原因。
- 再次要求
ACCESS_FINE_LOCATION
與ACCESS_COARSE_LOCATION
權限。由於使用者已經允許系統向應用程式授予大概位置權限,此時的系統對話方塊有所不同,如 圖 4 與圖 5 所示:
最初只請求前景位置資訊
即使應用程式中的多項功能需要位置存取權,其中可能只有部分功能需要背景位置資訊存取權。因此,建議應用程式執行位置存取權漸進式要求,先要求取得前景位置資訊存取權,然後取得背景位置資訊存取權。藉由執行漸進式要求,使用者能進一步瞭解需要背景位置資訊存取權的功能,因此握有更多掌控權和資訊透明度。
圖 6 顯示了專為處理漸進式要求設計的應用程式範例。「顯示目前位置」和「建議臨近位置」功能都需要前景位置資訊存取權。不過,只有「建議附近位置」功能需要背景位置資訊存取權。
執行漸進式要求的程序如下:
-
首先,應用程式應引導使用者存取需要前景位置資訊存取權的功能,如圖 1 中的「分享位置資訊」功能,或圖 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 中的位置存取權,請參閱下列資料:
程式碼研究室
影片
範例
- 這個範例應用程式示範位置存取權的使用方式。