Geolocation API调用失败主因是未满足HTTPS协议及用户交互触发要求；需通过点击等动作调用getCurrentPosition()，正确处理success/error回调及配置项；watchPosition需手动clearWatch；错误码1/2/3分别对应权限拒绝、位置不可用、超时。
Geolocation API 请求权限失败的常见原因
调用 navigator.geolocation.getCurrentPosition() 时，浏览器直接报错或静默失败，大概率不是代码写错了，而是环境不满足强制条件：必须在 HTTPS 协议下运行（本地 file:// 或 HTTP 页面会被拒绝）；Chrome、Edge 等现代浏览器还要求页面有用户交互触发（比如点击按钮），不能在页面加载时自动调用。
- 开发调试时用
localhost是允许的，哪怕没配 HTTPS - 部署到线上必须用 HTTPS，否则
getCurrentPosition()会立刻进入 error 回调，error.code通常是1（PERMISSION_DENIED） - 不要在
DOMContentLoaded或load事件里直接调用，改用按钮点击、表单提交等用户动作触发
如何正确调用 getCurrentPosition 并处理结果
getCurrentPosition() 接收三个参数：success 回调、error 回调、配置对象。它只获取一次位置，适合“点击定位”这类场景。注意：回调里的 position 对象嵌套较深，关键坐标在 position.coords.latitude 和 position.coords.longitude。
document.getElementById('locate-btn').addEventListener('click', () => {
navigator.geolocation.getCurrentPosition(
(position) => {
const lat = position.coords.latitude;
const lng = position.coords.longitude;
console.log(`纬度: ${lat}, 经度: ${lng}`);
},
(error) => {
console.error('定位失败:', error.code, error.message);
},
{
enableHighAccuracy: false, // 不强制 GPS，省电且更快
timeout: 5000, // 5 秒内没结果就报超时
maximumAge: 30000 
// 允许使用 30 秒内的缓存位置
}
);
});
watchPosition 与 getCurrentPosition 的核心区别
watchPosition() 会持续监听位置变化，返回一个唯一 watchId，可用于后续取消监听。它适合地图实时追踪、运动轨迹记录等场景。但要注意：它不会自动停止，忘记调用 navigator.geolocation.clearWatch(watchId) 会导致后台持续耗电和定位请求。
-
getCurrentPosition()：一次性获取，无返回值，适合简单定位 -
watchPosition()：返回数字 ID，每次位置变化都触发 success 回调，必须手动清理 - 两者 error 回调行为一致，但
watchPosition()可能被反复触发 - 高精度模式（
enableHighAccuracy: true）在部分安卓设备上可能始终返回0, 0，慎用
错误码含义与典型应对方式
Geolocation API 的 error 对象只有三个标准字段：code、message、PERMISSION_DENIED（1）、POSITION_UNAVAILABLE（2）、TIMEOUT（3）。浏览器不会抛异常，全靠你在 error 回调里判断。
-
error.code === 1：用户点了“拒绝”或浏览器策略阻止（如隐私模式）。可提示用户去设置里开启位置权限 -
error.code === 2：GPS 信号弱、飞行模式、设备无定位模块。建议降级显示城市级 IP 定位（需后端配合） -
error.code === 3：timeout设置过短，或网络/系统忙。可重试一次，或把timeout提高到 10000 - 所有 error 回调中，
error.message是浏览器自动生成的字符串，不同语言/版本内容不同，**不要用于逻辑判断**
watchPosition，而部分安卓 WebView 根本不支持 enableHighAccuracy。先确保 HTTPS + 用户触发，再谈精度和稳定性。
