Skip to content

Geolocation API

一句话解释

Geolocation API 让浏览器请求用户的地理位置(纬度、经度),需用户授权。

用大白话说

Geolocation API 让你向浏览器请求用户当前位置。它返回一个 Position 对象,含坐标——纬度、经度、精度,以及可选的海拔、速度、朝向。浏览器会提示用户授权,因此仅在 HTTPS 下且经同意才可用。你调用 navigator.geolocation.getCurrentPosition(success, error, options) 做一次性读取,或用 watchPosition 在用户移动时持续接收更新(适用于导航应用)。选项可请求高精度、设置超时并控制旧读数缓存。适用场景:在地图上显示附近结果、把天气应用默认到用户城市、为帖子标注位置、以及逐向导航。务必处理错误回调(拒绝授权、位置不可用、超时)并提供优雅降级——绝不要让 UI 阻塞在地理位置上。

示例

javascript
navigator.geolocation.getCurrentPosition(
  (pos) => {
    const { latitude, longitude } = pos.coords;
    console.log(`You are at ${latitude.toFixed(4)}, ${longitude.toFixed(4)}`);
  },
  (err) => console.warn("Location denied:", err.message),
  { enableHighAccuracy: true, timeout: 10000 }
);

成功时 pos.coords 给出纬度/经度。错误回调处理拒绝或超时。enableHighAccuracy 请求 GPS 精度。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表