navigator.geolocation 在非HTTPS、旧浏览器或权限禁用时为undefined；需先检测存在性，再调用getCurrentPosition()并传入success、error及options参数（含enableHighAccuracy、timeout、maximumAge）；可用watchPosition()监听变化，但受节流和后台暂停限制；移动端需注意iOS手势触发、Android WebView配置及X5内核兼容问题。
为什么 navigator.geolocation 有时返回 undefined 或报错
不是所有环境都支持地理定位，navigator.geolocation 在非 HTTPS 页面、某些旧版浏览器（如 IE9 及以下）、或用户禁用位置权限时会不可用。直接调用 getCurrentPosition() 前必须先检查是否存在：
if (!navigator.geolocation) {
console.error('当前浏览器不支持地理位置');
return;
}注意：即使存在，也**不保证一定能获取成功**——用户拒绝授权、GPS 未开启、网络定位失败都会触发 error 回调。
getCurrentPosition() 的三个参数怎么填才不踩坑
这个方法接受三个参数：success、error 和可选的 options。最容易忽略的是第三个参数——它控制精度、超时和是否强制使用高精度设备：
-
enableHighAccuracy: true会尝试用 GPS（耗电、慢），但多数移动浏览器默认为false，仅用 Wi-Fi/基站粗略定位 -
timeout: 5000单位是毫秒，不设可能卡住几秒甚至更久 -
maximumAge: 60000表示可接受 1 分钟内缓存的位置，避免重复请求
getCurrentPosition(success)（没传 error，出错就静默失败）；推荐写法：navigator.geolocation.getCurrentPosition(
(pos) => console.log(pos.coords.latitude, pos.coords.longitude),
(err) => console.warn('定位失败:', err.code, err.message),
{ enableHighAccuracy: false, timeout: 8000, maximumAge: 30000 }
);
如何监听位置变化而不是只取一次
用 watchPosition() 替代 getCurrentPosition()，它返回一个 watchId，可用于后续取消监听：
const watchId = navigator.geolocation.watchPosition(注意：
(pos) => updateMap(pos.coords),
(err) => console.error(err),
{ maximumAge: 10000 }
);
// 后续需要停止时：
navigator.geolocation.clearWatch(watchId);
watchPosition() 不是“实时高频推送”，浏览器会按需节流（比如移动中才更新），且每次回调仍受 same-origin 和 HTTPS 限制。若页面切到后台，部分浏览器会暂停更新。
移动端常见问题：iOS Safari 拒绝定位、Android WebView 白屏
iOS Safari 要求用户**手动开启“网站跟踪”或“位置服务”权限**，且首次调用必须由用户手势（如点击按钮）触发，不能在页面加载时自动执行；Android WebView 需显式启用定位权限并设置 WebSettings.setGeolocationEnabled(true)，否则 navigator.geolocation 直接为 undefined。另外，微信内置浏览器（X5 内核）对 geolocation 支持不稳定，建议降级 fallback 到 IP 地址粗略定位（如调用后端接口查 ipinfo.io）。
立即学习“Java免费学习笔记（深入）”；
