JavaScript通过Geolocation API获取用户位置,需HTTPS/localhost安全上下文及用户授权;先检测支持性,再用getCurrentPosition获取单次位置或watchPosition监听变化,并处理权限、超时等错误。
JavaScript 通过浏览器提供的 Geolocation API 获取用户地理位置,但必须在安全上下文(https:// 或 localhost)中运行,且需用户明确授权。
不是所有环境都支持该 API,使用前应先检测:
if ("geolocation" in navigator) {
console.log("支持地理定位");
} else {
console.log("不支持地理定位");
}
这是最常用的方法,异步获取一次精确位置。需传入成功和失败回调:
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
}
);
适合需要持续跟踪的场景(如导航应用),返回一个唯一 watchId,可用于后续取消监听:
const watchId = navigator.geolocation.watchPosition(
(position) => {
console.log("位置已更新:", position.coords);
},
(error) => {
console.error("监听失败:", error);
}
);
// 后续可调用以下
代码停止监听
// navigator.geolocation.clearWatch(watchId);
注意: