JavaScript通过Geolocation API获取用户位置,需HTTPS/localhost安全上下文及用户授权;先检测支持性,再用getCurrentPosition获取单次位置或watchPosition监听变化,并处理权限、超时等错误。

JavaScript 通过浏览器提供的 Geolocation API 获取用户地理位置,但必须在安全上下文(https:// 或 localhost)中运行,且需用户明确授权。
检查浏览器是否支持地理定位
不是所有环境都支持该 API,使用前应先检测:
if ("geolocation" in navigator) {
console.log("支持地理定位");
} else {
console.log("不支持地理定位");
}
调用 getCurrentPosition 获取当前位置
这是最常用的方法,异步获取一次精确位置。需传入成功和失败回调:
- 成功回调接收一个
Position对象,其中coords包含纬度(latitude)、经度(longitude)、海拔、精度等 - 失败回调接收一个
PositionError对象,可判断是用户拒绝(PERMISSION_DENIED)、位置不可用(POSITION_UNAVAILABLE)还是超时(TIMEOUT) - 可选配置项如
enableHighAccuracy(启用高精度,可能更耗电)、timeout(毫秒)、maximumAge(允许返回缓存位置的最大毫秒数)
navigator.geolocation.getCurrentPosition(
(position) => {
const { latitude, longitude } = position.coords;
console.log(`纬度:${latitude},经度:${longitude}`);
},
(error) => {
switch (error.code) {
case error.PERMISSION_DENIED:
console.log("用户拒绝了位置访问");
break;
case error.POSITION_UNAVAILABLE:
console.log("位置信息不可用");
break;
case error.TIMEOUT:
console.log("请求超时");
break;
}
},
{
enableHighAccuracy: true,
timeout: 10000,
maximumAge: 60000
}
);
监听位置变化(watchPosition)
适合需要持续跟踪的场景(如导航应用),返回一个唯一 watchId,可用于后续取消监听:
立即学习“Java免费学习笔记(深入)”;
const watchId = navigator.geolocation.watchPosition(
(position) => {
console.log("位置已更新:", position.coords);
},
(error) => {
console.error("监听失败:", error);
}
);
// 后续可调用以下代码停止监听
// navigator.geolocation.clearWatch(watchId);
注意事项与常见问题
注意:
- HTTP 网站(非 HTTPS)在现代浏览器中默认禁用 Geolocation API(Chrome 50+、Firefox 50+ 等)
- 用户首次访问会弹出浏览器原生权限提示,无法绕过或预设同意
- 移动设备上可能返回粗略位置(如基于 Wi-Fi 或基站),开启 GPS 可提升精度
- 部分隐私模式或系统级位置关闭会导致直接失败,需友好提示用户检查设置











