请求位置信息权限

为了保护用户隐私，使用位置信息服务的应用必须请求位置权限。

多项权限都与位置信息相关。具体请求哪项权限以及请求相关权限的方式取决于应用用例的位置信息要求。

本页介绍了不同类型的位置信息要求，并说明了如何在每种情况下请求位置信息权限。

如需请求位置信息权限，请遵循所有运行时权限的最佳实践。

位置信息访问权限的类型

每项权限都具有以下特征组合：

前台位置信息

如果应用的某项功能仅分享或接收一次位置信息，或者只在特定的一段时间内分享或接收位置信息，则该功能需要前台位置信息访问权限。以下是此类情况的一些示例：

  • 在导航应用中，某项功能可让用户查询精细导航路线。
  • 在即时通讯应用中，某项功能可让用户与其他用户分享自己目前所在的位置。

如果应用的功能在下列某种情况下访问设备当前的位置信息，系统就会认为应用需要使用前台位置信息：

  • 属于应用的某个 activity 可见。

  • 应用的某个前台服务正在运行中。当有前台服务在运行时，系统会显示一条常驻通知来提醒用户注意。当应用被置于后台时（例如当用户按设备上的主屏幕按钮或关闭设备的显示屏时），其位置信息访问权限会得到保留。

    此外，您应声明 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 权限访问确切位置信息，您可以请求用户允许该应用获取确切位置信息。

后台位置信息授权提醒

在 Android 10（API 级别 29）及更高版本中，当应用中的功能在用户授予后台位置信息访问权限后首次在后台访问设备位置信息时，系统会安排向用户发送一条通知。此通知旨在提醒用户他们已允许您的应用始终有权访问设备位置信息。示例通知如图 8 所示。

检查应用的 SDK 依赖项中的位置信息要求

检查您的应用是否使用依赖于位置信息权限（尤其是 ACCESS_FINE_LOCATION 权限）的 SDK。如需了解详情，请参阅 Medium 上关于了解 SDK 依赖项的行为的博文。

其他资源

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

Codelab

视频

示例