JavaScript 通过 Geolocation API 在安全上下文下获取用户位置,需检测 navigator.geolocation 支持性;常用 getCurrentPosition 获取单次定位,watchPosition 持续监听,须用户手势触发并优化权限提示与错误处理。

JavaScript 通过 Geolocation API 获取用户地理位置,它基于浏览器内置的定位能力(如 GPS、Wi-Fi、IP 地址等),无需额外库即可调用,但必须在安全上下文(https:// 或 localhost)中运行。
检查浏览器是否支持 Geolocation
使用前先判断兼容性,避免报错:
-
navigator.geolocation存在即表示支持 - 不支持时可降级为 IP 定位服务(如通过第三方 API 查询)
获取一次当前位置(getCurrentPosition)
这是最常用的方法,异步获取用户当前经纬度:
- 第一个参数是成功回调,接收
position对象,其中position.coords.latitude和position.coords.longitude是核心坐标 - 第二个参数是失败回调,常见错误包括用户拒绝授权、设备无定位能力、超时等
- 第三个参数是可选配置对象,例如:
{ enableHighAccuracy: true, timeout: 10000, maximumAge: 60000 }
监听位置变化(watchPosition)
适合需要持续追踪的场景(如导航类应用):
立即学习“Java免费学习笔记(深入)”;
- 返回一个唯一
watchId,可用于后续取消监听:navigator.geolocation.clearWatch(watchId) - 每次位置更新都会触发成功回调,注意避免频繁更新导致性能问题
- 建议结合防抖或距离阈值(如移动超 10 米再响应)优化体验
处理权限与用户体验
浏览器会弹出原生权限提示,但无法主动触发——必须由用户手势(如点击按钮)触发定位请求:
- 不要在页面加载时自动调用
getCurrentPosition,否则多数浏览器会静默拒绝 - 提供清晰文案说明用途(如“用于显示附近门店”),提升授权率
- 捕获错误码:
positionError.code为 1 表示用户拒绝,2 表示位置不可用,3 表示超时










