geolocation api 返回 permission_denied 是因用户未授权，需确保 https 环境、检查权限状态并引导手动重置；超时或偏差大时应设 timeout/maximumage、启用高精度、剔除异常值并做坐标系转换。
Geolocation API 返回 PositionError.PERMISSION_DENIED 怎么办
浏览器没拿到授权，不是代码写错了，是用户没点“允许”或者之前点了“拒绝”且没重置。Chrome、Edge 默认首次访问会弹提示，但 Safari 和部分安卓 WebView 会静默拒绝，尤其在非 HTTPS 页面直接禁用整个 API。
- 确保页面跑在
https://或localhost上（HTTP 域名下navigator.geolocation可能为undefined） - 调用
getCurrentPosition()前，先检查权限状态：navigator.permissions.query({name: 'geolocation'})，返回'granted'/'denied'/'prompt' - 如果已是
denied，无法代码绕过；得引导用户手动进浏览器设置里重置位置权限（Chrome 地址栏左端点锁图标 → “网站设置” → “位置”）
getCurrentPosition() 一直不回调或超时
不是卡死，是底层定位源没响应——GPS 信号弱、Wi-Fi 未开启、设备在室内、Android 后台限制都可能导致。
- 务必传入
timeout和maximumAge参数，否则默认无限等待：navigator.geolocation.getCurrentPosition(success, error, { timeout: 10000, maximumAge: 30000 }) -
timeout是从发起请求到触发error回调的总时长，不是“等 GPS 启动”的时间 - 某些 Android 12+ 设备在省电模式下会主动丢弃定位请求，
error.code可能是2（POSITION_UNAVAILABLE），而非3（TIMEOUT）
定位坐标偏差大（比如偏移几百米）
浏览器没撒谎，它只是把系统给的原始结果原样吐出来。手机用的是混合定位（GPS + Wi-Fi + 基站），Wi-Fi 数据库过期、基站粗略估算、甚至地图坐标系转换都会导致偏差。
- 优先用
enableHighAccuracy: true，但这不保证精度提升，只告诉系统“请尽量用 GPS”，实际是否启用取决于设备硬件和系统策略 - 避免在电梯、地下车库、密集高楼间直接取单次结果；可连续调用几次，剔除明显异常值（如经纬度突变 > 0.01°）再取平均
- 注意：WGS84 坐标（浏览器返回）和国内地图 SDK（如高德、百度）用的坐标系不同，直接渲染会偏移 500 米以上；必须用对应 SDK 的转换接口，不能靠简单加减
iOS Safari 定位失败率特别高
iOS 对后台定位、非用户手势触发的定位非常敏感。Safari 甚至可能在页面加载完 30 秒后自动关闭定位服务。
立即学习“前端免费学习笔记（深入）”；
- 必须由用户真实交互（点击按钮、触摸事件）触发
getCurrentPosition()，不能放在onload或定时器里 - 不要依赖
watchPosition()长期运行——iOS 会在页面不可见或锁屏后迅速停止 - 若需持续定位，考虑用
Background Fetch+ 推送唤醒，或改用原生 App 封装（PWA 在 iOS 上定位能力受限严重）
