在 Wear OS 上检测位置

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

请参阅以下相关资源：

使应用能够感知用户的地理位置

有些手表带有内置 GPS 传感器，可直接检索位置数据，而无需共享网络的手机。不过，当您在手表应用中请求获取位置数据时，您不必担心位置数据的来源；系统会通过最高效的方法获取该数据。但是，正如以下各部分所述，您的应用确实需要处理位置数据丢失的情况。

建议您使用一体化位置信息提供程序在手表上获取位置数据。此外，本文档还介绍了如何检查手表上的位置传感器、接收位置数据和监控已共享网络的数据连接。另请参阅与 iPhone 配对的手表的位置数据。

为降低位置数据获取对电池续航时间造成的不良影响，您应该确保应用调用设置为 PRIORITY_BALANCED_POWER_ACCURACY 的 setPriority()。您应该使用 setInterval() 确保请求位置数据的频率不超过每分钟一次。

注意：本文档假定您知道如何使用 Google Play Services API 检索位置数据。

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

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

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

检测内置 GPS

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

如需确定手表是否带有内置 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 does not use location or
        // warn the user that location function is not 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 does not use location or
        // warn the user that location function is not available.
    }

    ...
}

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

处理断开连接事件

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

如需检测网络共享数据连接是否断开，请使用 NodeApi 的 GetConnectedNodesResult 方法。例如：

初始化 GoogleApiClient 并创建一个调用 NodeApi 的方法，例如一个名为 inspectNodes 的方法：

Kotlin

private lateinit var googleApiClient: GoogleApiClient
private var wearableConnected = false

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    googleApiClient = GoogleApiClient.Builder(this)
            .addApi(Wearable.API)
            .addConnectionCallbacks(object : GoogleApiClient.ConnectionCallbacks {
                override fun onConnected(connectionHint: Bundle?) {
                    inspectNodes()
                }

                override fun onConnectionSuspended(cause: Int) {}
            })
            .build()

}

private fun inspectNodes() {
    Wearable.NodeApi
            .getConnectedNodes(googleApiClient)
            .setResultCallback(this, 1000, TimeUnit.MILLISECONDS)
}

Java

private GoogleApiClient googleApiClient;
private boolean wearableConnected = false;

@Override
public void onCreate() {
    super.onCreate();

    googleApiClient = new GoogleApiClient.Builder(this)
            .addApi(Wearable.API)
            .addConnectionCallbacks(new GoogleApiClient.ConnectionCallbacks() {
                @Override
                public void onConnected(Bundle connectionHint) {
                    inspectNodes();
                }

                @Override
                public void onConnectionSuspended(int cause) {
                }
            })
            .build();
}

private void inspectNodes(){
    Wearable.NodeApi.getConnectedNodes(googleApiClient).setResultCallback(this, 1000, TimeUnit.MILLISECONDS);
}

使用以下回调方法获取使用 inspectNodes 方法的结果：

Kotlin

override fun onResult(getConnectedNodesResult: NodeApi.GetConnectedNodesResult) {
    wearableConnected = false
    getConnectedNodesResult.nodes.forEach { node ->
        wearableConnected = wearableConnected or node.isNearby
    }
    Log.v("TEST", "wearableConnected: $wearableConnected")
}

Java

@Override
public void onResult(NodeApi.GetConnectedNodesResult getConnectedNodesResult) {
    if (getConnectedNodesResult != null && getConnectedNodesResult.getNodes() != null){
        wearableConnected = false;
        for (Node node : getConnectedNodesResult.getNodes()){
            if (node.isNearby()){
                wearableConnected = true;
            }
        }
    }
    Log.v("TEST", "wearableConnected: " + wearableConnected);
}

处理“未找到此地点”

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