在运行时请求位置信息访问权限

当应用中的功能需要位置信息访问权限时，请等到用户与该功能互动时再发出权限请求。本工作流遵循在上下文中请求运行时权限的最佳实践，如介绍如何请求应用权限的指南中所述。

图 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_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 的对话框中）。

最初仅请求在前台访问位置信息

即使应用中有多项功能需要位置信息访问权限，可能其中也只有部分功能需要后台位置信息访问权限。因此，建议应用对位置权限执行递增请求，先请求前台位置信息访问权限，再请求后台位置信息访问权限。执行递增请求可以为用户提供更大的控制权和透明度，因为他们可以更好地了解应用中的哪些功能需要后台位置信息访问权限。

图 6 显示了旨在处理递增请求的应用示例。“显示当前位置”和“推荐附近的地点”这两项功能都需要前台位置信息访问权限。不过，只有“推荐附近的地点”功能需要后台位置信息访问权限。

启用前台位置信息访问权限的按钮与启用后台位置信息访问权限的按钮相距半个屏幕之远
图 6. 这两项功能都需要位置信息访问权限，但只有“推荐附近的地点”功能需要后台位置信息访问权限。

执行递增请求的过程如下所示：

  1. 首先，应用应该引导用户留意到需要前台位置信息访问权限的功能，例如图 1 中的“分享位置信息”功能或图 2 中的“显示当前位置”功能。

    在应用有权访问前台位置信息之前，建议您停止让用户访问需要后台位置信息访问权限的功能。

  2. 稍后，等到用户探索需要后台位置信息访问权限的功能时，您可以请求在后台访问位置信息的权限。

其他资源

如需详细了解 Android 中的位置权限，请查看以下资料：

Codelab

视频

示例