javascript地理位置API如何使用_如何获取用户的位置信息？

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)
• 每次位置变化（或精度提升）都会触发成功回调，不是固定时间间隔
• 注意及时清理，避免内存泄漏或后台持续耗电

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

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

标签： javascript java git 微信 浏览器 安卓 ai wi-fi 常见问题 地理位置