大网数据广告活动
Web 标准与前端开发

Geolocation:getCurrentPosition() 方法

· 52CE 我爱测

`Geolocation.getCurrentPosition()`** 方法用来获取设备当前位置。

Geolocation API

Geolocation.getCurrentPosition() 方法用来获取设备当前位置。

语法

getCurrentPosition(success)
getCurrentPosition(success, error)
getCurrentPosition(success, error, options)

参数

  • success
    • : 以 GeolocationPosition 对象作为其唯一输入参数的回调函数。
  • error
    • : 以 GeolocationPositionError 对象作为其唯一输入参数的可选回调函数。
  • options
    • : 一个包含以下参数的可选对象:
      • maximumAge
        • : 一个正的 long 值,表示可接受的缓存位置的最大存在时间(以毫秒为单位)。如果设置为 0,则设备不能使用缓存位置,必须尝试检索当前的真实位置;如果设置为 Infinity,则设备必须返回缓存位置而不考虑其存在时间。默认值:0。
      • timeout
        • : 一个正的 long 值,表示设备允许获取位置的最长时间(以毫秒为单位)。默认值为 Infinity,意味着 getCurrentPosition() 会一直等待直到位置可用才返回。
      • enableHighAccuracy
        • : 一个布尔值,指示应用程序希望接收尽可能精确的位置结果。如果为 true,且设备能够提供更高精度的位置,则会启用高精度模式;这可能导致响应时间变慢或功耗增加(例如移动设备上的 GPS 芯片)。如果为 false,设备可通过更快响应和/或更少功耗来节省资源。默认值:false。

示例

const options = {
  enableHighAccuracy: true,
  timeout: 5000,
  maximumAge: 0,
};

function success(pos) {
  const crd = pos.coords;

  console.log("你当前的位置是:");
  console.log(`纬度:${crd.latitude}`);
  console.log(`经度:${crd.longitude}`);
  console.log(`海拔约 ${crd.accuracy} 米。`);
}

function error(err) {
  console.warn(`错误(${err.code}):${err.message}`);
}

navigator.geolocation.getCurrentPosition(success, error, options);

标准

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。