JavaScript地理定位API通过navigator.geolocation提供位置服务，需用户授权且仅在HTTPS或localhost下运行；主要方法包括getCurrentPosition()、watchPosition()和clearWatch()，使用时须处理PERMISSION_DENIED等错误并配置选项。
JavaScript 的地理定位（Geolocation）是浏览器提供的一套 API，用来获取用户设备的大致物理位置（如经纬度），前提是用户授权。
地理定位的核心：navigator.geolocation
它挂载在全局 navigator 对象下，主要通过三个方法操作：
- getCurrentPosition()：一次性获取当前位置（最常用）
- watchPosition()：持续监听位置变化（适合导航类应用）
- clearWatch()：停止监听
如何安全获取用户位置？
调用前必须确保页面运行在安全上下文（https 或 localhost），否则浏览器会直接拒绝。获取时需处理用户授权逻辑：
- 用户第一次访问会弹出浏览器原生提示（“是否允许网站查看位置？”）
- 如果用户拒绝或未响应，回调函数中的 error 参数会返回对应错误码（如 PERMISSION_DENIED、POSITION_UNAVAILABLE）
- 建议始终传入 success 和 error 两个回调，避免静默失败
基础用法示例
以下是最简可行代码：
立即学习“Java免费学习笔记（深入）”；
if ("geolocation" in navigator) {
navigator.geolocation.getCurrentPosition(
(position) => {
const { latitude, longitude } = position.coords;
console.log("纬度:", latitude, "经度:", longitude);
},
(error) => {
console.error("定位失败:", error.message);
},
{
enableHighAccuracy: false, // 是否启用高精度（耗电/慢），默认 false
timeout: 5000, // 最长等待毫秒数
maximumAge: 60000 // 接受缓存位置的最大时长（毫秒）
}
);
} else {
console.log("当前浏览器不支持地理定位");
}
常见注意事项
- 移动设备通常比桌面更准（结合 GPS、Wi-Fi、基站）
- 部分安卓 WebView 或旧版 iOS 可能限制后台定位或需要额外配置
- 隐私敏感场景下，应明确告知用户为何需要位置，并提供手动输入作为备选
- 不要假设坐标一定可用——网络不可用、飞行模式、权限被系统级关闭都会导致失败
基本上就这些。不复杂但容易忽略授权和错误处理，补上这两块，定位功能就能稳稳跑起来。
