JavaScript地理位置API需用户授权，通过navigator.geolocation提供getCurrentPosition()和watchPosition()等方法获取经纬度等信息，仅支持HTTPS或localhost环境。
JavaScript 中的地理位置 API（Geolocation API）是浏览器提供的一套标准接口，用于在用户授权的前提下获取其设备的大致物理位置信息，比如纬度、经度、海拔、速度和方向等。
地理位置 API 的核心方法
它主要通过 navigator.geolocation 对象提供功能，最常用的是：
- getCurrentPosition()：一次性获取当前位置（推荐用于简单定位）
- watchPosition()：持续监听位置变化（适合导航、运动类应用）
- clearWatch()：停止监听（配合 watchPosition 使用）
如何安全地获取用户位置
浏览器不会自动暴露位置，必须由用户主动授权。调用前需检查兼容性，并处理用户拒绝或出错的情况：
git-staged-commit-message
下载
仅从仓库的暂存文件生成 Git 提交消息。当用户要求 Codex 根据暂存更改、缓存差异、Git 索引或已通过 `git add` 添加的文件来编写、起草、创建或建议提交消息时使用；切勿代表用户执行提交操作。
- 先判断
navigator.geolocation是否存在 - 使用
getCurrentPosition(successCallback, errorCallback, options) -
successCallback 接收一个
position对象，其中position.coords.latitude和position.coords.longitude是关键坐标 -
errorCallback 会收到错误码（如
PERMISSION_DENIED、POSITION_UNAVAILABLE、TIMEOUT） -
options 可设置
enableHighAccuracy（是否启用高精度，可能更耗电）、timeout（毫秒）、maximumAge（缓存位置最大年龄）
一个最小可用示例
下面代码能直接运行在支持 HTTPS 的页面中（注意：现代浏览器要求地理位置 API 必须在安全上下文，即 HTTPS 或 localhost）：
立即学习“Java免费学习笔记（深入）”；
if ("geolocation" in navigator) {
navigator.geolocation.getCurrentPosition(
(pos) => {
const { latitude, longitude } = pos.coords;
console.log("纬度:", latitude, "经度:", longitude);
},
(err) => {
console.error("定位失败:", err.message);
},
{ enableHighAccuracy: true, timeout: 5000 }
);
} else {
console.log("当前浏览器不支持地理位置");
}
需要注意的关键点
- 仅在 HTTPS 或
localhost下可用（HTTP 站点会被浏览器阻止） - 用户首次访问会弹出权限提示，拒绝后需手动在浏览器设置中开启
- 返回的位置精度有限，尤其在室内或 GPS 信号弱时，可能依赖 Wi-Fi 或基站定位
- 部分浏览器（如 Safari）对后台页面或快速连续调用有策略限制
- 不能用于追踪用户，每次调用都需用户明确授权，且权限可随时撤销
基本上就这些。用起来不复杂但容易忽略权限和协议要求，实际项目中建议加一层友好提示（比如“点击获取附近门店”），并做好降级处理（如默认城市、手动选择）。
