更改位置设置

如果您的应用需要请求位置或接收权限更新，则设备需要启用相应系统设置，例如 GPS 或 Wi-Fi 扫描。您的应用无需直接启用设备的 GPS 等服务，只需指定所需的精度/功耗级别和所需的更新间隔，设备就会自动对系统设置进行相应的更改。这些设置由 LocationRequest 数据对象定义。

本课程将向您展示如何使用设置客户端检查已启用的设置，并显示位置设置对话框，以便用户只需轻按一下即可更新其设置。

配置位置服务

为了使用 Google Play 服务和融合位置提供程序提供的位置服务，请使用设置客户端连接您的应用，然后检查当前位置设置，并在需要时提示用户启用所需设置。

其功能使用位置服务的应用必须请求位置权限，具体取决于这些功能的用例。

设置位置请求

要存储对融合位置提供程序的请求参数，请创建一个 LocationRequest。这些参数决定位置请求的精度级别。有关所有可用位置请求选项的详细信息，请参阅 LocationRequest 类参考。本课程设置更新间隔、最快更新间隔和优先级，如下所述

更新间隔

setInterval() - 此方法设置应用首选接收位置更新的速率（以毫秒为单位）。请注意，位置更新可能会比此速率快一些或慢一些，以优化电池使用情况，或者根本没有更新（例如，如果设备没有连接）。

最快更新间隔

setFastestInterval() - 此方法设置应用可以处理位置更新的**最快**速率（以毫秒为单位）。除非您的应用受益于比 setInterval() 中指定的速率更快地接收更新，否则您无需调用此方法。

优先级

setPriority() - 此方法设置请求的优先级，这会向 Google Play 服务位置服务提供有关使用哪些位置源的重要提示。支持以下值

PRIORITY_BALANCED_POWER_ACCURACY - 使用此设置请求位置精度在城市街区内，精度约为 100 米。这被认为是粗略的精度级别，并且可能会消耗更少的电量。使用此设置，位置服务可能会使用 WiFi 和蜂窝塔定位。但是，请注意，位置提供程序的选择取决于许多其他因素，例如哪些来源可用。
PRIORITY_HIGH_ACCURACY - 使用此设置请求尽可能精确的位置。使用此设置，位置服务更有可能使用 GPS 来确定位置。
PRIORITY_LOW_POWER - 使用此设置请求城市级精度，精度约为 10 公里。这被认为是粗略的精度级别，并且可能会消耗更少的电量。
PRIORITY_NO_POWER - 如果您需要对功耗的影响可以忽略不计，但仍希望在可用时接收位置更新，请使用此设置。使用此设置，您的应用不会触发任何位置更新，但会接收其他应用触发的定位。

创建位置请求并设置此代码示例中所示的参数

Kotlin

fun createLocationRequest() {
  val locationRequest = LocationRequest.Builder()
      .setIntervalMillis(10000)
      .setFastestIntervalMillis(5000)
      .setPriority(LocationRequest.PRIORITY_HIGH_ACCURACY)
      .build()
}

Java

protected void createLocationRequest() {
  LocationRequest locationRequest = LocationRequest.Builder()
      .setIntervalMillis(10000)
      .setFastestIntervalMillis(5000)
      .setPriority(LocationRequest.PRIORITY_HIGH_ACCURACY)
      .build();
}

优先级为 PRIORITY_HIGH_ACCURACY，结合您在应用清单中定义的 ACCESS_FINE_LOCATION 权限设置和 5000 毫秒（5 秒）的快速更新间隔，会导致融合位置提供程序返回精度在几英尺内的位置更新。这种方法适用于实时显示位置的地图应用。

性能提示：如果您的应用在收到位置更新后访问网络或执行其他长时间运行的任务，请将最快间隔调整为较慢的值。此调整可防止您的应用接收无法使用的更新。长时间运行的任务完成后，请将最快间隔重新设置为较快的值。

获取当前位置设置

连接到 Google Play 服务和位置服务 API 后，您可以获取用户设备的当前位置设置。为此，请创建一个LocationSettingsRequest.Builder，并添加一个或多个位置请求。以下代码片段显示了如何添加上一步中创建的位置请求

Kotlin

val builder = LocationSettingsRequest.Builder()
        .addLocationRequest(locationRequest)

Java

LocationSettingsRequest.Builder builder = new LocationSettingsRequest.Builder()
     .addLocationRequest(locationRequest);

接下来检查当前位置设置是否满足要求

Kotlin

val builder = LocationSettingsRequest.Builder()

// ...

val client: SettingsClient = LocationServices.getSettingsClient(this)
val task: Task<LocationSettingsResponse> = client.checkLocationSettings(builder.build())

Java

LocationSettingsRequest.Builder builder = new LocationSettingsRequest.Builder();

// ...

SettingsClient client = LocationServices.getSettingsClient(this);
Task<LocationSettingsResponse> task = client.checkLocationSettings(builder.build());

当Task 完成时，您的应用可以通过查看LocationSettingsResponse 对象中的状态代码来检查位置设置。要获取有关相关位置设置当前状态的更多详细信息，您的应用可以调用LocationSettingsResponse 对象的getLocationSettingsStates() 方法。

提示用户更改位置设置

要确定位置设置是否适合位置请求，请向验证位置设置的 Task 对象添加一个 OnFailureListener。然后，检查传递给 onFailure() 方法的 Exception 对象是否为 ResolvableApiException 类的实例，这表示必须更改设置。然后，通过调用 startResolutionForResult() 显示一个对话框，提示用户授权修改位置设置。

以下代码片段显示了如何确定用户的定位设置是否允许位置服务创建 LocationRequest，以及如何在必要时请求用户授权更改位置设置

Kotlin

task.addOnSuccessListener { locationSettingsResponse ->
    // All location settings are satisfied. The client can initialize
    // location requests here.
    // ...
}

task.addOnFailureListener { exception ->
    if (exception is ResolvableApiException){
        // Location settings are not satisfied, but this can be fixed
        // by showing the user a dialog.
        try {
            // Show the dialog by calling startResolutionForResult(),
            // and check the result in onActivityResult().
            exception.startResolutionForResult(this@MainActivity,
                    REQUEST_CHECK_SETTINGS)
        } catch (sendEx: IntentSender.SendIntentException) {
            // Ignore the error.
        }
    }
}

Java

task.addOnSuccessListener(this, new OnSuccessListener<LocationSettingsResponse>() {
    @Override
    public void onSuccess(LocationSettingsResponse locationSettingsResponse) {
        // All location settings are satisfied. The client can initialize
        // location requests here.
        // ...
    }
});

task.addOnFailureListener(this, new OnFailureListener() {
    @Override
    public void onFailure(@NonNull Exception e) {
        if (e instanceof ResolvableApiException) {
            // Location settings are not satisfied, but this can be fixed
            // by showing the user a dialog.
            try {
                // Show the dialog by calling startResolutionForResult(),
                // and check the result in onActivityResult().
                ResolvableApiException resolvable = (ResolvableApiException) e;
                resolvable.startResolutionForResult(MainActivity.this,
                        REQUEST_CHECK_SETTINGS);
            } catch (IntentSender.SendIntentException sendEx) {
                // Ignore the error.
            }
        }
    }
});

下一课，接收位置更新，将向您展示如何接收周期性的位置更新。

获取最后已知位置

请求位置更新