获取最近一次的已知位置

使用 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 中获取当前位置,请查看以下资料:

示例