Android NDK开发详解用户位置信息之获取最近一次的已知位置

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

示例

示例应用演示了获取当前位置的最佳实践。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。

最后更新时间 (UTC)：2023-05-30。