使用 Google Play 服务地理位置 API,您的应用可以请求获取用户设备最近一次的已知位置。在大多数情况下,您感兴趣的是用户的当前位置,通常也就是设备最近一次的已知位置。
具体来说,使用一体化位置信息提供程序可检索设备最近一次的已知位置。一体化位置信息提供程序是 Google Play 服务中的一个地理位置 API。它负责管理底层定位技术,并提供一个简单的 API,以便您指定准确度高或耗电量低等比较笼统的要求。它还可以优化设备的电池电量消耗。
注意:当您的应用在后台运行时,获取位置信息访问权限对应用的核心功能至关重要,但同时需要向用户提供适当的声明。
本课向您介绍如何使用一体化位置信息提供程序中的 getLastLocation()
方法发出获取设备位置信息的单个请求。
设置 Google Play 服务
如需访问一体化位置信息提供程序,您的应用开发项目必须包含 Google Play 服务。通过 SDK 管理器下载 Google Play 服务组件并进行安装,然后将内容库添加至您的项目。如需了解详情,请参阅介绍如何设置 Google Play 服务的指南。
指定应用权限
如果应用的功能需要使用位置信息服务,应用必须根据这些功能的使用场景来请求位置信息权限。
创建位置信息服务客户端
在 Activity 的 onCreate()
方法中,按如下代码段所示,创建一个一体化位置信息提供程序客户端的实例。
Kotlin
private lateinit var fusedLocationClient: FusedLocationProviderClient override fun onCreate(savedInstanceState: Bundle?) { // ... fusedLocationClient = LocationServices.getFusedLocationProviderClient(this) }
Java
private FusedLocationProviderClient fusedLocationClient; // .. @Override protected void onCreate(Bundle savedInstanceState) { // ... fusedLocationClient = LocationServices.getFusedLocationProviderClient(this); }
获取最近一次的已知位置
创建位置信息服务客户端后,就可以获取用户设备最近一次的已知位置。当应用连接到这些设备后,您就可以使用一体化位置信息提供程序的 getLastLocation()
方法来检索设备的位置。此调用返回的位置信息的准确度取决于您在应用清单中设置的权限,如介绍如何请求位置信息权限的指南中所述。
如需请求最近一次的已知位置,请调用 getLastLocation()
方法。以下代码段说明了这一请求以及简单的响应处理方法:
Kotlin
fusedLocationClient.lastLocation .addOnSuccessListener { location : Location? -> // Got last known location. In some rare situations this can be null. }
Java
fusedLocationClient.getLastLocation() .addOnSuccessListener(this, new OnSuccessListener<Location>() { @Override public void onSuccess(Location location) { // Got last known location. In some rare situations this can be null. if (location != null) { // Logic to handle location object } } });
getLastLocation()
方法会返回一个 Task
,供您用来获取具有地理位置经纬度坐标的 Location
对象。在以下情况下,该位置信息对象可能为 null
:
- 设备设置中关闭了位置信息服务。即使之前检索到了最近一次的位置信息,结果也可能为
null
,因为停用位置信息服务也会清除缓存。 - 设备从未记录自己的位置信息。新设备或者已经恢复为出厂设置的设备可能会发生此情况。
- 设备上的 Google Play 服务已经重启,且在服务重启后,没有已请求位置信息的活跃一体化位置信息提供程序客户端。为避免这种情况,您可以创建新客户端并自行请求位置信息更新。如需了解详情,请参阅接收位置信息更新。
选择最佳位置信息估算值
FusedLocationProviderClient
提供了多种检索设备位置信息的方法。根据应用的使用场景,从以下选项中选择一项:
getLastLocation()
可更快地获取位置信息估算值,并最大限度地减少应用对电池用量的消耗。但是,如果最近没有其他客户端主动使用位置信息,则位置信息可能会过时。getCurrentLocation()
可以更一致、更及时地获取更准确的位置信息。不过,这种方法会导致系统在设备上进行主动位置信息计算。我们推荐使用这种方法来获取最新位置信息,并建议您尽可能使用这种方法。与使用
requestLocationUpdates()
自行启动和管理位置信息更新等替代方案相比,这种方法更安全。如果您的应用调用requestLocationUpdates()
,则在无法获取位置信息,或者获取新位置后请求未正确停止时,会消耗大量电量。
其他资源
如需详细了解如何在 Android 中获取当前位置,请查看以下资料:
示例
- 示例应用演示了获取当前位置的最佳实践。