前端Wiki/词条/地理定位 Geolocation

地理定位 Geolocation

定义通过浏览器 API 获取用户当前的地理位置坐标（经纬度）

navigator.geolocation.getCurrentPosition 是入口：成功回调拿到 coords.latitude（纬度）、longitude（经度）、accuracy（精度米数），失败回调返回错误码（1 拒绝授权、2 位置不可用、3 超时）。这是异步 API，且必须在 HTTPS 环境下才能调用。

watchPosition 可以持续监听位置变化，适合做导航轨迹，不用了要调 clearWatch 注销。拿到的只是经纬度，展示给用户还要配合地图 SDK 或逆地理编码服务。请注意定位属于敏感权限，不授权就拒绝，不要反复弹窗骚扰用户。

getCurrentPosition 是异步的，且仅 HTTPS 下可用
错误码 1 表示用户拒绝授权，2 表示位置不可用，3 表示超时
watchPosition 持续监听，不再使用时要 clearWatch 注销

JavaScript

if (navigator.geolocation) {
  navigator.geolocation.getCurrentPosition(
    function (pos) {
      console.log('纬度:', pos.coords.latitude);
      console.log('经度:', pos.coords.longitude);
      console.log('精度(米):', pos.coords.accuracy);
    },
    function (err) {
      console.log('定位失败，错误码:', err.code, '原因:', err.message);
    },
    { enableHighAccuracy: true, timeout: 5000 }
  );
} else {
  console.log('当前浏览器不支持地理定位');
}

⚠ 常见误区

以为同步调用能直接拿到坐标，实际必须走回调
在 file:// 或 HTTP 下调用 geolocation 直接被拒绝
拿到经纬度就当详细地址——还需要逆地理编码服务

🔗 相关词条地理定位浏览器