Geolocation API可获取用户位置,需先检测支持性。1. 使用navigator.geolocation判断是否支持;2. 调用getCurrentPosition()获取单次定位,含经纬度、精度和时间戳,可配置高精度、超时和缓存有效期;3. 用watchPosition()持续监听位置变化,通过clearWatch()停止;4. 错误处理包括权限拒绝、位置不可用和超时,需友好提示。注意隐私合规与备用方案。

HTML5 的 Geolocation API 提供了一种简单的方式,让网页能够获取用户的地理位置信息。这个功能在移动设备和现代浏览器中广泛支持,适用于天气应用、地图服务、本地推荐等场景。
1. 检测浏览器是否支持地理定位
在使用地理定位前,应先检测当前浏览器是否支持 navigator.geolocation 接口。
示例代码:
if (navigator.geolocation) {
// 支持地理定位
navigator.geolocation.getCurrentPosition(
function(position) {
console.log("纬度: " + position.coords.latitude);
console.log("经度: " + position.coords.longitude);
},
function(error) {
console.error("获取位置失败: ", error.message);
}
);
} else {
console.log("您的浏览器不支持地理定位。");
}
2. 获取当前位置(单次定位)
使用 getCurrentPosition() 方法可获取用户当前的一次性位置。
立即学习“前端免费学习笔记(深入)”;
该方法接受两个主要参数:成功回调函数和失败回调函数,还可传入一个配置对象。
- position.coords.latitude:纬度
- position.coords.longitude:经度
- position.coords.accuracy:定位精度(米)
- position.timestamp:获取时间戳
可选参数说明:
- enableHighAccuracy:是否启用高精度模式(如 GPS),默认 false
- timeout:等待响应的最长时间(毫秒)
- maximumAge:缓存位置的最大有效期(毫秒)
示例:
navigator.geolocation.getCurrentPosition(
showPosition,
showError,
{
enableHighAccuracy: true,
timeout: 10000,
maximumAge: 60000
}
);
3. 持续监听位置变化
如果需要持续追踪用户位置(例如导航应用),可以使用 watchPosition() 方法。
它会持续返回位置更新,直到调用 clearWatch() 停止监听。
示例:
let watchId = navigator.geolocation.watchPosition(
function(position) {
console.log("实时位置:", position.coords.latitude, position.coords.longitude);
},
function(error) {
console.error("监听位置出错:", error.message);
},
{ enableHighAccuracy: true }
);
// 停止监听
// navigator.geolocation.clearWatch(watchId);
4. 处理常见错误
用户可能拒绝授权或定位失败,需通过错误回调处理以下情况:
- error.PERMISSION_DENIED:用户拒绝了定位请求
- error.POSITION_UNAVAILABLE:位置信息不可用(如无 GPS 信号)
- error.TIMEOUT:获取位置超时
建议向用户友好提示问题原因。
基本上就这些。Geolocation 功能强大但依赖用户授权和设备能力,使用时注意隐私合规,并提供备用方案。










