Google 致力于为黑人社区推动种族平等。查看具体举措

获取最近一次的已知位置

使用 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 服务已经重启,且在服务重启后,没有已请求位置信息的活跃一体化位置信息提供程序客户端。为避免这种情况,您可以创建新客户端并自行请求位置信息更新。如需了解详情,请参阅接收位置信息更新

保持当前的最佳估算值

您可能认为最近的 getLastLocation() 调用中包含的 Location 对象是最准确的信息。不过,由于位置信息的准确度不尽相同,因此最近的值并不一定是最佳值。您应该添加根据多个条件选择要显示哪些位置信息的逻辑。这组条件也因应用的用例和现场测试的结果而异。

如需验证从 getLastLocation() 返回的位置信息的准确度,请完成以下步骤:

  • 检查检索到的位置信息是否明显新于之前提取的位置信息。
  • 检查位置信息所声明的准确度是优于还是劣于之前的估算值。
  • 检查与新位置信息关联的提供程序。确定您对此提供程序的信任程度是否高于您的应用所缓存的位置信息中使用的提供程序。