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 精度。
相关术语
相关资源
相关课程
- 地理位置
学习位置 API。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。