在 Wear OS 上检测位置

手表小巧、一览无余的外形特征使得 Wear OS 成为面向记录、报告和响应用户位置的应用的理想平台。例如，您可以构建应用，为用户提供其运动距离、速度和方向的实时更新信息，或者帮助用户一目了然地查看周围的环境。

如需了解详情，请参阅构建位置感知应用。

有些手表带有内置 GPS 传感器，可直接检索位置数据，而无需连接手机。当您在手表应用中请求获取位置数据时，系统将使用最节能的方法从手机或手表获取位置信息。因此，即使手表中没有 GPS 传感器，您仍然可以获取位置信息。

为降低位置数据获取对电池续航时间造成的不良影响，请确保您的应用调用传入 PRIORITY_BALANCED_POWER_ACCURACY 值的 setPriority()。不同的优先级设置可能会以不同的方式优化条状标签。

为尽可能节省电量，您应当使用 setInterval() 确保请求获取位置信息的频率不超过每分钟一次。

如以下部分所述，当没有传感器的手表与手机断开连接时，您的应用需要处理位置数据丢失。

选择方法

您可以通过多种方式为 Wear OS 应用提供位置数据。您可以使用一体化位置信息提供程序 (FLP) 或 Wear 健康服务 (WHS)。FLP 是一种 Google Play 服务 API。

请在以下情况下使用 FLP：

您目前需要位置数据（而不是一直需要），例如标记停放车辆的位置。
您一直需要位置数据，但不需要位置记录。

请在以下情况下使用 WHS：

您需要来自其他传感器的数据，或者未来可能需要来自其他传感器的数据。
您的应用是一款健身或锻炼应用，需要在特定时间间隔内跟踪位置数据。

对于与 iPhone 配对的手表，请参阅与 iPhone 配对的手表的位置数据。

使用一体化位置信息提供程序

在手表上，使用 FusedLocationProviderClient 获取位置数据。如果手表不带 GPS 传感器，FLP 将会自动使用手机提供的位置数据。如需了解详情，请参阅创建位置信息服务客户端。

如需了解如何请求位置信息更新和持续跟踪用户位置，请参阅请求位置信息更新。

检测内置 GPS

如果用户佩戴未内置 GPS 传感器的手表出去慢跑，并且忘记携带与之配对的手机，您的手表应用将无法通过已连接的设备获取位置数据。您的应用应检测这种情况并警告用户位置功能不可用。

如需确定手表是否带有内置 GPS 传感器，请调用传入 PackageManager.FEATURE_LOCATION_GPS 的 hasSystemFeature() 方法。以下代码可在您启动某个 activity 时检测手表是否带有内置 GPS 传感器：

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main_activity)

    if (!hasGps()) {
        Log.d(TAG, "This hardware doesn't have GPS.")
        // Fall back to functionality that doesn't use location or
        // warn the user that location function isn't available.
    }
}

private fun hasGps(): Boolean =
        packageManager.hasSystemFeature(PackageManager.FEATURE_LOCATION_GPS)

Java

protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main_activity);

    if (!hasGps()) {
        Log.d(TAG, "This hardware doesn't have GPS.");
        // Fall back to functionality that doesn't use location or
        // warn the user that location function isn't available.
    }

    ...
}

private boolean hasGps() {
    return getPackageManager().hasSystemFeature(PackageManager.FEATURE_LOCATION_GPS);
}

处理断开连接事件

如果手表没有内置 GPS 传感器并断开与手机的连接，则会丢失其位置数据流。如果您的应用需要不间断的数据流，您的应用必须检测连接是否断开，向用户发出警告，然后将功能适当降级。

与移动设备一样，当您使用 FusedLocationProviderClient.requestLocationUpdates() 请求位置信息更新时，您应传入 LocationCallback 或 PendingIntent。这两个选项均包含位置信息和 LocationAvailability 状态。

使用 LocationCallback 选项时，替换 onLocationAvailability() 以接收关于位置信息可用性状态的更新。

当使用 PendingIntent 选项并返回 Intent 时，使用 LocationAvailability.extractLocationAvailability(Intent) 从 Intent 提取位置可用性状态。

处理未找到位置事件

当 GPS 信号断开时，您可以检索用户手表最近一次的已知位置。如果无法修复 GPS 连接，或者手表没有内置 GPS 并与手机断开连接，检索最近一次的已知位置会很有帮助。如需了解详情，请参阅获取最近一次的已知位置。

使用批量调用刷新位置

如果您使用的是批量调用，请在屏幕重新开启（或从氛围模式返回）时调用 flushLocations()，以立即将任何批量位置返回给所有已注册的 LocationListeners、LocationCalllbacks 和 Pending Intents。