17370845950

Geolocation API需HTTPS或localhost安全上下文及用户授权，支持getCurrentPosition获取单次位置和watchPosition持续监听，须检查兼容性、权限状态并处理常见错误与限制。

JavaScript 的地理位置 API（Geolocation API）可以获取用户设备的经纬度等位置信息，但必须在安全上下文（HTTPS 或 localhost）中使用，且需用户明确授权。

调用 getCurrentPosition 获取一次位置

这是最常用的方式，适合只需要当前位置的场景（比如“显示附近门店”）。它会触发浏览器弹出权限请求。

• 基本用法：navigator.geolocation.getCurrentPosition(成功回调, 失败回调, 配置选项)
• 成功回调接收一个 Position 对象，其中 position.coords.latitude 和 position.coords.longitude 就是经纬度
• 失败回调接收一个 PositionError 对象，常见错误码：PERMISSION_DENIED（用户拒绝）、POSITION_UNAVAILABLE（定位失败）、TIMEOUT（超时）
• 配置选项可设 enableHighAccuracy: true（尝试高精度，如 GPS，但更耗电/慢）、timeout: 5000（毫秒）、maximumAge: 60000（允许返回 1 分钟内的缓存位置）

监听位置变化：watchPosition

适合需要持续追踪的场景（比如导航、运动轨迹记录）。

• 用法类似：const watchId = navigator.geolocation.watchPosition(成功回调, 失败回调, 配置选项)
• 它会返回一个唯一 ID（watchId），可用于后续停止监听：navigator.geolocation.clearWatch(watchId)
• 每次位置变化（或精度提升）都会触发成功回调，不是固定时间间隔
• 注意及时清理，避免内存泄漏或后台持续耗电

使用前检查兼容性与权限状态

不是所有浏览器都支持，而且用户可能已拒绝过权限，直接调用会静默失败。

• 先判断是否存在：if ("geolocation" in navigator)
• 检查当前权限状态（Chrome/Firefox 支持）：navigator.permissions.query({name:"geolocation"})，返回 "granted"、"denied" 或 "prompt"
• 若为 "denied"，说明用户已永久拒绝，此时应引导用户手动开启（比如显示设置提示）

处理常见问题与注意事项

实际开发中容易踩坑，提前了解能少走弯路。

• HTTP 站点无法使用：非 HTTPS 或非 localhost 会直接报错 SecurityError，部署前务必启用 HTTPS
• 移动端可能返回粗略位置：Wi-Fi 或基站定位精度低（几百米），开启 GPS 并设 enableHighAccuracy: true 可改善（但不保证）
• 用户未响应权限弹窗时，回调不会触发：建议加个 UI 提示（如加载动画），并设置超时逻辑兜底
• 部分安卓 WebView 或微信内置浏览器限制严格：可能默认禁用或需额外配置，建议降级方案（如 IP 地理定位 + 手动选择城市）

基本上就这些。核心就是：安全上下文 + 用户授权 + 合理处理回调和异常。不复杂但容易忽略细节。