原生移动开发 / 系统课时
按场景申请定位权限
按场景申请定位权限
定位权限不要按“应用需要定位”一次性申请,而要按真实场景拆成前台、后台以及精确、近似两个维度。前台地图通常只需前台定位;持续后台跟踪才涉及后台定位;Android 12 及以上还必须正确处理用户选择“近似位置”的结果。
学习目标
- 能根据业务行为选择前台、后台、精确或近似定位权限
- 能正确请求
ACCESS_FINE_LOCATION与ACCESS_COARSE_LOCATION - 能处理用户只授予近似位置、拒绝权限以及后续升级精确位置的情况
先从真实业务判断权限范围
定位权限有两个独立维度:访问时机和精度。前台定位表示应用在可见界面或符合条件的前台服务场景中访问位置;后台定位则用于应用不处于这些前台场景时仍需要持续访问的位置能力。精度上又分为 precise 和 approximate。Android 官方建议先申请前台定位,再根据确有需要的功能单独申请后台定位。Android 定位权限官方文档
可以先把业务拆成几个问题:用户是否正在主动使用定位功能?离开页面后是否仍必须持续获得位置?业务是否真的需要街道级或更高精度?能否接受一个区域级的位置结果?答案分别决定前台、后台以及精确、近似的申请范围。
例如“查看当前位置”和“附近门店推荐”通常属于前台定位场景;“持续记录运动轨迹”可能需要在应用进入后台后继续获取位置,因此需要进一步评估后台定位或前台服务方案,而不能因为前一个功能也用了位置就一并申请全部权限。

Android 12 以上的精确与近似
当应用需要处理 Android 12 及以上的定位权限时,如果需要支持精确位置,应在同一次运行时请求中同时请求 ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION。系统会让用户选择 Precise 或 Approximate;如果用户选择 Approximate,即使应用声明了 ACCESS_FINE_LOCATION,应用实际获得的也仍然只是近似位置。Android 位置运行时权限官方说明
因此业务代码不要只检查 ACCESS_FINE_LOCATION。判断“是否能够继续”应该根据功能的最低要求来做:如果附近推荐只需要粗粒度范围,拥有 ACCESS_COARSE_LOCATION 就可以继续;只有确实依赖精确坐标的功能,才应该在已有授权基础上进一步请求升级。
下面是一个前台定位请求的 Kotlin 片段示例,依赖 AndroidX Activity Result API。它故意只关注授权结果,不把具体的定位 SDK 调用混入权限判断。
private val requestLocation = registerForActivityResult(
ActivityResultContracts.RequestMultiplePermissions()
) { permissions ->
val precise = permissions[Manifest.permission.ACCESS_FINE_LOCATION] == true
val approximate = permissions[Manifest.permission.ACCESS_COARSE_LOCATION] == true
when {
precise -> startLocationFeature(precision = "precise")
approximate -> startLocationFeature(precision = "approximate")
else -> handleLocationDenied()
}
}
private fun requestForegroundLocation() {
requestLocation.launch(
arrayOf(
Manifest.permission.ACCESS_FINE_LOCATION,
Manifest.permission.ACCESS_COARSE_LOCATION
)
)
}
private fun startLocationFeature(precision: String) {
Log.d("LocationPermission", "authorized precision=$precision")
}
private fun handleLocationDenied() {
Log.d("LocationPermission", "location permission denied")
}预期结果
用户选择 Precise:输出 authorized precision=precise。
用户选择 Approximate:输出 authorized precision=approximate。
用户选择 Deny:输出 location permission denied。这里的 precision 只是业务层用于区分授权结果的字符串,不代表定位 SDK 返回的实际坐标精度。获得权限后,仍应根据业务选择合适的定位 API 与更新策略。
前台需要,后台再单独申请
后台定位不要和前台定位一次性打包请求。对于 Android 11 及以上,如果应用同时请求前台和后台定位,系统不会按普通的一次性授权流程授予这两类权限;官方建议采用增量请求:先让用户授权前台定位,再在真正进入后台定位功能时处理后台授权。Android 后台定位官方文档
Manifest 可以明确声明后台定位,但是否应该申请它取决于功能本身。配置示例如下:
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
</manifest>生效结果
应用声明了前台定位能力和后台定位能力。
实际授权仍由用户选择决定,声明权限不会自动获得授权。
Android 11 及以上应先处理前台定位,再根据确有必要的后台功能处理后台授权。如果业务只是“打开地图时显示当前位置”,不要为了未来可能增加的功能提前申请后台定位。这样做既增加权限解释成本,也会让当前用户难以理解应用为什么需要更广泛的定位访问。
近似位置也要有可用路径
用户选择 Approximate 并不等于定位功能全部失败。Android 官方明确要求应用正确处理只获得近似位置的情况,而且用户可以在运行时授权时或系统设置中改变位置精度。Android 运行时位置权限行为
因此在业务层最好定义一个最低可用精度。例如门店列表可以用近似位置计算附近区域,但精细导航、对地理围栏边界要求很严格的功能可能确实需要更高精度。此时先完成前台定位授权,再在用户触发具体功能时说明“精确位置用于完成该功能”,然后重新请求精确与近似权限。
不要把“用户选择近似”立即翻译成错误提示。更好的做法是让能工作的功能继续运行,对确实需要精确位置的单个功能单独说明原因,并允许用户继续使用其他不依赖精确位置的能力。
验收时检查四种关键状态
定位权限测试不能只测一次“允许”。至少要验证精确、近似、拒绝以及授权后进入下一业务状态的路径,并在 Android 12 及以上设备上确认精确权限升级流程。特别要注意:用户可以在设置中改变定位精度,因此应用每次真正访问定位能力前都应重新检查当前授权状态,而不是永久缓存上一次结果。
最终的权限设计应与用户正在执行的场景绑定:能用近似位置完成,就不要强求精确;只在前台需要,就不要提前扩大到后台;只有当核心功能确实依赖更高授权范围时,才在对应场景中解释并请求更高权限。