地理位置:clearWatch() 方法

基线 广泛可用

此功能已成熟,并在许多设备和浏览器版本中正常工作。自 2015 年 7 月.

报告反馈

安全上下文:此功能仅在安全上下文(HTTPS)中可用,部分或所有支持的浏览器中均可使用。

语法

Geolocation
clearWatch(id)

接口的clearWatch()方法用于注销先前使用Geolocation.watchPosition()安装的位置/错误监控处理程序。

js

参数

id

当安装要删除的处理程序时,Geolocation.watchPosition()方法返回的 ID 号。

示例

Geolocation
let id;
let target;
let options;

function success(pos) {
  const crd = pos.coords;

  if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
    console.log("Congratulations, you've reached the target!");
    navigator.geolocation.clearWatch(id);
  }
}

function error(err) {
  console.error(`ERROR(${err.code}): ${err.message}`);
}

target = {
  latitude: 0,
  longitude: 0,
};

options = {
  enableHighAccuracy: false,
  timeout: 5000,
  maximumAge: 0,
};

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

规范

返回值
地理位置
# 无 (
undefined).

浏览器兼容性

规范

另请参阅