HTML 地理位置 watchPosition() 方法

watchPosition() 方法是 HTML Geolocation API 的一部分，用于实时监视设备的地理位置。这个方法会连续地获取设备的位置，并将其送到一个回调函数中处理。该回调函数可以在设备位置更新时被执行。

方法语法

以下是使用 watchPosition() 方法的基本语法：

navigator.geolocation.watchPosition(success[, error[, options]])

• success: 必需。一个回调函数，它会在成功获取设备位置时被执行。
• error: 可选。一个回调函数，它会在获取设备位置时出现错误时被执行。
• options: 可选。一个对象，其中包含一个或多个可选参数。

方法参数

success

success 参数是一个回调函数，用于处理成功获取设备位置的情况。该函数的语法如下：

function success(position) {
    // 处理设备位置信息
}

其中，position 参数是一个对象，包含设备位置信息的各种属性。例如，经纬度等信息。

error

error 参数是一个回调函数，用于处理获取设备位置时发生错误的情况。该函数的语法如下：

function error(error) {
    switch(error.code) {
        case error.PERMISSION_DENIED:
            // 用户拒绝了位置请求
            break;
        case error.POSITION_UNAVAILABLE:
            // 位置信息不可用
            break;
        case error.TIMEOUT:
            // 获取位置信息超时
            break;
        case error.UNKNOWN_ERROR:
            // 未知错误
            break;
    }
}

其中，error 参数也是一个对象，包含错误信息的各种属性。例如，错误代码、错误消息等信息。

options

options 参数是一个对象，它包含一个或多个可选参数，用于定制设备位置获取的一些行为。以下是可用参数的列表：

• enableHighAccuracy: 是否启用高精度控制，默认值为 false。如果将其设置为 true，则将尝试获取更高精度的位置信息，但这会增加设备使用电量和网络带宽的成本。
• timeout: 获取位置信息的最长时间（毫秒），如果超过该时间，则 error 回调函数将被执行。
• maximumAge: 可接受的最大位置信息缓存时间（毫秒），如果设备已经有一份最近的位置信息，且其时间戳在该缓存时间之内，则不会再次获取位置信息。

示例代码

以下代码展示了如何使用 watchPosition() 方法获取设备位置信息：

navigator.geolocation.watchPosition(success, error, options);

function success(position) {
    console.log(`纬度: ${position.coords.latitude}  经度: ${position.coords.longitude}`);
}

function error(error) {
    console.log(`错误信息: ${error.message}`);
}

该代码会在控制台输出设备的地理位置信息。其中，success 回调函数会在每次成功获取设备位置时被执行，而 error 回调函数会在获取设备位置时出现错误时被执行。您可以在 options 参数中自定义一些参数，以满足您的需求。