浏览器需用户主动授权且仅HTTPS或localhost下生效，调用getCurrentPosition前须确认环境；HTTP页面静默失败，iframe中受限；拒绝后无重试API，需引导手动开启；options参数影响精度、超时与缓存；返回仅为经纬度，需地理编码API转地址。
浏览器不会自动给你地理位置，必须用户主动授权，且仅在 HTTPS 或 localhost 环境下生效。
调用 navigator.geolocation.getCurrentPosition 前必须确认协议和上下文
HTTP 页面直接调用会静默失败（Chrome 甚至不触发错误回调），连提示都不会弹。只有 HTTPS 或 http://localhost（含 127.0.0.1）才能触发权限请求。
- 本地开发时用
live-server、python -m http.server或 VS Code Live Server 插件，确保地址是http://localhost:xxxx - 部署到线上必须配 HTTPS，GitHub Pages 默认支持，但自建 Nginx/Apache 需配置证书
- 不能在 iframe 里调用（除非父页面显式声明
geolocation权限，且 iframe 的sandbox属性允许）
用户拒绝或忽略授权后，getCurrentPosition 不会重试
一旦用户点“拒绝”或关闭弹窗，后续调用只会进 error 回调，且浏览器不会再弹提示。没有“重新申请”API，只能引导用户手动开启：
- 检查
error.code：值为1表示用户拒绝（PERMISSION_DENIED），2是位置不可用（POSITION_UNAVAILABLE） - 在错误回调里显示友好提示，比如：“请前往浏览器地址栏左侧图标 → ‘位置’ → 选择‘允许’”
- 不要循环调用；可加按钮让用户手动重试，但首次调用后需等用户手动改设置才有效
getCurrentPosition 的 options 参数影响实际行为
第三个参数 options 控制精度、超时和缓存策略，不是可有可无的：
立即学习“前端免费学习笔记（深入）”；
-
enableHighAccuracy: true会尝试 GPS（移动端更准），但耗电、响应慢，且某些设备（如无 GPS 的平板）可能直接失败 -
timeout: 5000单位是毫秒，设太短（如 1000）容易因网络延迟或定位初始化失败而进 error -
maximumAge: 60000表示可接受 1 分钟内的缓存位置，避免重复定位；设0强制实时获取 - 生产环境建议至少设
timeout和maximumAge，否则默认无限等待，用户会以为卡死
navigator.geolocation.getCurrentPosition(
(pos) => console.log(pos.coords.latitude, pos.coords.longitude),
(err) => console.error("定位失败:", err.code, err.message),
{ enableHighAccuracy: false, timeout: 8000, maximumAge: 30000 }
);
定位成功后拿到的是经纬度，不是地址
getCurrentPosition 返回的 coords 对象只含 latitude、longitude、accuracy 等原始数据，不带城市名或街道。要转成文字地址，必须调用第三方地理编码 API：
- 浏览器端可用
fetch调 Google Maps Geocoding API（需 API Key + 启用计费）、Mapbox Geocoding 或国内高德/腾讯地图 Web SDK - 注意跨域限制：高德/腾讯要求 referer 白名单，Google 要求 HTTPS + Key 绑定域名
- 别在前端硬编码 API Key，尤其 Google Key 若没限制 referer，会被盗刷
- 更稳妥的做法是把经纬度发给自己的后端，由服务端调用地理编码接口再返回结构化地址
用户授权是一次性的，但浏览器对“已拒绝”的记忆非常顽固；真正难的不是写那几行 JS，而是处理好各种拒绝路径、降级方案和地理编码的边界情况。
