大网数据广告活动
Web 标准与前端开发

Geolocation.watchPosition()

· 52CE 我爱测

`Geolocation.watchPosition()`** 用于注册监听器,在设备的地理位置发生改变的时候自动被调用。也可以选择特定的错误处理函数。

Geolocation API

Geolocation.watchPosition() 用于注册监听器,在设备的地理位置发生改变的时候自动被调用。也可以选择特定的错误处理函数。

该方法会返回一个 ID,如要取消监听可以通过 Geolocation.clearWatch() 传入该 ID 实现取消的目的。

语法

watchPosition(success)
watchPosition(success, error)
watchPosition(success, error, options)

参数

  • success
    • : 成功时候的回调函数,同时传入一个 Position 对象当作参数。
  • error
    • : 失败时候的回调函数,可选,会传入一个 PositionError 对象当作参数。
  • options
    • : 一个可选的 PositionOptions 对象。

示例

var id, target, options;

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

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

function error(err) {
  console.warn("ERROR(" + err.code + "): " + err.message);
}

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

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

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

规范

浏览器兼容性

参见

  • 使用地理位置定位
  • 该方法属于 Geolocation,可以通过 NavigatorGeolocation.geolocation 访问。
  • 取消监听的方法: Geolocation.clearWatch()
  • 另一个类似的方法: Geolocation.getCurrentPosition()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。