Geolocation API 可在用户授权后获取其地理位置,支持地图、天气等基于位置的服务。通过 navigator.geolocation.getCurrentPosition() 获取当前位置,包含纬度、经度、精度等信息,并需处理用户拒绝或定位失败的错误。使用 watchPosition() 可持续监听位置变化,配合 clearWatch() 停止监听,且 API 仅在 HTTPS 或 localhost 环境下可用。

JavaScript 的 Geolocation API 可以让用户授权网站获取其地理位置信息,实现基于位置的服务,比如地图标记、本地天气、附近商家等。这个功能依赖浏览器支持,并需要用户明确授权。
如何使用 Geolocation API 获取当前位置
Geolocation API 位于 navigator.geolocation 对象中,最常用的方法是 getCurrentPosition(),用于获取用户的当前地理坐标。
示例代码:
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(
function(position) {
const lat = position.coords.latitude;
const lng = position.coords.longitude;
console.log(`纬度: ${lat}, 经度: ${lng}`);
},
function(error) {
console.error("获取位置失败:", error.message);
}
);
} else {
console.log("当前浏览器不支持地理定位");
}上面的代码首先检查浏览器是否支持地理定位,然后调用 getCurrentPosition() 方法。该方法接收两个回调函数:第一个处理成功获取的位置数据,第二个处理错误情况。
立即学习“Java免费学习笔记(深入)”;
位置数据包含哪些信息
position.coords 提供详细的坐标信息,常用属性包括:
- latitude:纬度(十进制)
- longitude:经度(十进制)
- accuracy:位置精度(米)
- altitude:海拔(米,可能为 null)
- altitudeAccuracy:海拔精度(米)
- heading:移动方向(0-360 度,可能为 null)
- speed:速度(米/秒,可能为 null)
时间戳可以通过 position.timestamp 获取。
iWebMall 是一款高性能高扩展能力的开源 LAMP 电子商务软件,定位为大中型电子商务平台软件,服务于有建立电子商务需求的商业客户。这些商业客户不必学习任何计算机编程代码知识,只需要使用 iWebMall 软件他们就可以轻松建立一个功能强大的网上商城,实现用户注册、产品展示、在线定购、在线支付等电子商务功能;iWebMall 集成了产品发布与查询、会员注册登录、购物车、在线订单、在线支付、在
处理定位错误和用户拒绝
当用户拒绝授权或定位失败时,会触发错误回调函数。error 对象包含 code 和 message 属性,code 值含义如下:
- 1:用户拒绝授权(PERMISSION_DENIED)
- 2:位置不可获取(POSITION_UNAVAILABLE)
- 3:请求超时(TIMEOUT)
增强的错误处理示例:
function showError(error) {
switch(error.code) {
case 1:
alert("请允许位置访问以继续使用此功能");
break;
case 2:
alert("无法获取您的位置,请检查网络或 GPS");
break;
case 3:
alert("定位请求超时,请重试");
break;
default:
alert("未知错误");
}
}监听位置变化(持续定位)
如果需要持续追踪用户位置(如导航应用),可以使用 watchPosition() 方法,它会在位置变化时反复触发回调。
const watchId = navigator.geolocation.watchPosition(
function(position) {
console.log("位置更新:", position.coords.latitude, position.coords.longitude);
},
showError,
{ enableHighAccuracy: true, timeout: 10000, maximumAge: 60000 }
);可选的第三个参数是一个配置对象,常见选项:
- enableHighAccuracy:是否启用高精度(如 GPS)
- timeout:最大等待时间(毫秒)
- maximumAge:缓存位置的最大有效期(毫秒)
使用 clearWatch(watchId) 可停止监听。
基本上就这些。Geolocation API 简单实用,但注意只能在 HTTPS 环境下运行(本地开发 localhost 除外),且必须获得用户许可。









