Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The PositionOptions
interface describes an object containing option properties to pass as a parameter of Geolocation.getCurrentPosition()
and Geolocation.watchPosition()
.
The PositionOptions
interface doesn't inherit any properties.
PositionOptions.enableHighAccuracy
Secure context
Boolean
that indicates the application would like to receive the best possible results. If true
and if the device is able to provide a more accurate position, it will do so. Note that this can result in slower response times or increased power consumption (with a GPS chip on a mobile device for example). On the other hand, if false
, the device can take the liberty to save resources by responding more quickly and/or using less power. Default: false
.PositionOptions.timeout
Secure context
long
value representing the maximum length of time (in milliseconds) the device is allowed to take in order to return a position. The default value is Infinity
, meaning that getCurrentPosition()
won't return until the position is available.PositionOptions.maximumAge
Secure context
long
value indicating the maximum age in milliseconds of a possible cached position that is acceptable to return. If set to 0
, it means that the device cannot use a cached position and must attempt to retrieve the real current position. If set to Infinity
the device must return a cached position regardless of its age. Default: 0.The PositionOptions
interface neither implements, nor inherits any method.
Specification | Status | Comment |
---|---|---|
Geolocation API The definition of 'PositionOptions' in that specification. | Recommendation | Initial definition |
Desktop | ||||||
---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | |
Basic support | 5 | Yes | 3.5 | 9 | 16
|
5 |
Secure context required | 50 | ? | 55 | No | 37 | Yes |
enableHighAccuracy |
5 | Yes | 3.5 | 9 | 16
|
5 |
timeout |
5 | Yes | 3.5 | 9 | 16
|
5 |
maximumAge |
5 | Yes | 3.5 | 9 | 16
|
5 |
Mobile | |||||||
---|---|---|---|---|---|---|---|
Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | iOS Safari | Samsung Internet | |
Basic support | Yes | 18 | Yes | 4 | 16
|
5 | ? |
Secure context required | 51
|
50 | ? | 55 | 37 | Yes | ? |
enableHighAccuracy |
Yes | 18 | Yes | 4 | 16
|
Yes | ? |
timeout |
Yes | 18 | Yes | 4 | 16
|
Yes | ? |
maximumAge |
Yes | 18 | Yes | 4 | 16
|
Yes | ? |
Geolocation
interface that uses it.
© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/PositionOptions