navigator.geolocation 是 BOM 中用于获取用户地理位置的标准 API，需用户授权且仅在安全上下文中可用；通过 getCurrentPosition 获取单次位置，watchPosition 监听变化，并需处理兼容性、权限及精度问题。
navigator.geolocation 是 BOM 中 navigator 对象提供的标准 API，用于获取用户设备的地理位置。它不直接返回坐标，而是通过异步方式（回调或 Promise）请求授权并读取位置信息，必须在用户明确授权后才能使用。
检查浏览器是否支持 geolocation
并非所有环境都支持该 API（如某些旧浏览器、HTTP 非安全上下文、iframe 沙盒限制等），使用前应先判断：
- 检查 navigator.geolocation 是否存在且为对象
- 注意：即使存在，也可能因隐私设置或策略被禁用
if ("geolocation" in navigator) {
// 可以调用 getCurrentPosition 等方法
} else {
console.log("当前浏览器不支持地理位置定位");
}
请求用户授权并获取一次坐标
调用 navigator.geolocation.getCurrentPosition() 发起定位请求。该方法接受 success 回调、error 回调和可选配置对象：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- success 回调接收一个 Position 对象，其 coords 属性包含 latitude（纬度）、longitude（经度）等字段
- error 回调接收一个 PositionError 对象，可通过 code 判断失败原因（如 1=用户拒绝、2=位置不可用、3=超时）
- 第三个参数为 options，常用 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 }
);
监听位置变化（可选）
若需持续追踪用户移动（如地图实时定位），可用 navigator.geolocation.watchPosition()。它返回一个唯一 watchId，可用于后续取消监听：
立即学习“Java免费学习笔记（深入）”；
- 行为类似 getCurrentPosition，但会在位置显著变化或时间间隔后重复触发 success 回调
- 调用 navigator.geolocation.clearWatch(watchId) 可停止监听
- 注意：频繁更新会增加电量消耗，生产环境建议合理设置 options（如 distanceFilter 或 interval）
注意事项与常见问题
实际使用中需特别注意以下几点：
- 必须在安全上下文（HTTPS 或 localhost）中运行，HTTP 页面会被现代浏览器阻止调用
- 用户首次访问时会弹出浏览器原生授权提示，无法绕过或预设同意
- 移动端可能返回粗略位置（如基于 WiFi 或基站），精度远低于 GPS；开启“高精度模式”有助于提升但非绝对保证
- 部分 Android WebView 或 iOS WKWebView 需额外配置权限（如 AndroidManifest.xml 添加 ACCESS_FINE_LOCATION）
- 不要假设 coords.accuracy 总是存在或准确，应做 null/undefined 判断
