PositionOptions - 描述了 Geolocation 的方法的参数选项字典
PositionOptions 字典描述了一个包含选项属性的对象，该对象作为 Geolocation.getCurrentPosition() 和 Geolocation.watchPosition() 的参数传递。
属性
PositionOptions.enableHighAccuracy 安全上下文
一个 Boolean，表示应用程序希望获得最佳结果。如果为 true，并且设备能够提供更准确的位置，则可以提供。请注意，这可能导致响应时间变慢或功耗增加（例如，在移动设备上使用 GPS 芯片）。另一方面，如果为 false，则设备可以通过更快地响应和 / 或使用更少的功率来自由地节省资源。默认值：false。
PositionOptions.timeout 安全上下文
一个 long 正数值，表示允许设备返回位置的最大时间长度（以毫秒为单位）。默认值为 Infinity，这意味着 getCurrentPosition() 直到该位置可用时才返回。
PositionOptions.maximumAge 安全上下文
一个 long 正数值，表示可以接受返回的可能缓存位置的最长有效时间（以毫秒为单位）。如果设置为 0，则意味着设备不能使用缓存的位置，而必须尝试检索实际的当前位置。如果设置为 Infinity，则设备必须返回缓存的位置，而缓存是多久之前的。默认值：0。
规范
| 规范 | 状态 | 备注 |
|---|---|---|
| Geolocation API PositionOptions 的定义 |
推荐 | 初始定义 |
桌面浏览器兼容性
| 特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| 基础支持 | 5 | 支持 | 3.5 | 9 | 16 10 — 15 | 5 |
enableHighAccuracy | 5 | 支持 | 3.5 | 9 | 16 10 — 15 | 5 |
maximumAge | 5 | 支持 | 3.5 | 9 | 16 10 — 15 | 5 |
| Secure context required | 50 | 未知 | 55 | 不支持 | 37 | 支持 |
timeout | 5 | 支持 | 3.5 | 9 | 16 10 — 15 | 5 |
移动浏览器兼容性
| 特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| 基础支持 | 支持 | 18 | 未知 | 4 | 未知 | 16 10.1 — 14 | 5 |
enableHighAccuracy | 支持 | 18 | 未知 | 4 | 未知 | 16 10.1 — 14 | 支持 |
maximumAge | 支持 | 18 | 未知 | 4 | 未知 | 16 10.1 — 14 | 支持 |
| Secure context required | 511 | 50 | 未知 | 55 | 未知 | 37 | 支持 |
timeout | 支持 | 18 | 未知 | 4 | 未知 | 16 10.1 — 14 | 支持 |
1. Android Nougat（7）及更高版本的应用程序才需要安全上下文。参见 bug 603574。
相关链接
- 使用地理位置 API
- 使用它的
Geolocation接口。