Geolocation API 是浏览器原生地理定位接口,需用户授权且仅在 https 或 localhost 中可用;支持单次获取(getCurrentposition)和持续监听(watchPosition),需处理兼容性、错误及隐私限制。

Geolocation API 是浏览器原生支持的获取用户地理位置的接口,不需要额外库,但需要用户授权,且只在安全上下文(HTTPS 或 localhost)中可用。
基本用法:获取一次当前位置
调用 navigator.geolocation.getCurrentPosition() 即可请求当前经纬度。它接受两个回调函数:成功时执行第一个,失败时执行第二个。
- 成功回调接收一个
position对象,其中position.coords.latitude和position.coords.longitude是关键字段 - 失败回调接收一个
Error对象,error.code可判断原因(如 1=用户拒绝、2=位置不可用、3=超时) - 可选第三个参数是配置对象,比如
{ enableHighAccuracy: true, timeout: 5000, maximumAge: 60000 }
监听位置变化:持续跟踪移动
用 navigator.geolocation.watchPosition() 替代单次获取,它返回一个唯一 ID,可用于后续停止监听。
- 每次位置更新(哪怕微小变动)都会触发成功回调
- 建议在不需要时主动调用
navigator.geolocation.clearWatch(watchId)释放资源 - 注意:频繁更新会增加耗电,生产环境建议结合
maximumAge和timeout控制精度与频率
处理常见错误和兼容性
不是所有浏览器或环境都支持 Geolocation,需做兜底判断。
立即学习“Java免费学习笔记(深入)”;
- 先检查
'geolocation' in navigator,避免 TypeError - 用户拒绝授权后,再次调用不会弹窗,需引导用户手动开启(例如显示设置提示)
- 部分安卓 webview 或 ios safari 在非主文档上下文中可能受限,确保脚本在顶层页面运行
- 隐私模式下部分浏览器会直接返回错误,不要假设一定能拿到位置
简单实用示例(带错误友好提示)
复制到 HTTPS 页面即可运行:
if ('geolocation' in navigator) { navigator.geolocation.getCurrentPosition( (pos) => { const { latitude, longitude } = pos.coords; console.log(`纬度:${latitude},经度:${longitude}`); }, (err) => { const msg = { 1: '您拒接了位置访问', 2: '设备无法获取位置信息', 3: '获取位置超时了' }[err.code] || '未知错误'; alert('定位失败:' + msg); }, { timeout: 10000, enableHighAccuracy: false } ); } else { alert('您的浏览器不支持地理位置'); }
基本上就这些。用好 Geolocation API 的关键是尊重用户选择、做好降级处理、别盲目追求高精度。