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)
- 每次位置变化（或精度提升）都会触发成功回调，不是固定时间间隔
- 注意及时清理，避免内存泄漏或后台持续耗电
使用前检查兼容性与权限状态
不是所有浏览器都支持，而且用户可能已拒绝过权限，直接调用会静默失败。
立即学习“Java免费学习笔记（深入）”；
- 先判断是否存在：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 地理定位 + 手动选择城市）
基本上就这些。核心就是：安全上下文 + 用户授权 + 合理处理回调和异常。不复杂但容易忽略细节。
