The PositionOptions
interface describes an object containing option properties to pass as a parameter of Geolocation.getCurrentPosition()
and Geolocation.watchPosition()
.
Properties
The PositionOptions
interface doesn't inherit any property.
PositionOptions.enableHighAccuracy
- Is a
Boolean
that indicates the application would like to receive the best possible results. Iftrue
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, iffalse
, the device can take the liberty to save resources by responding more quickly and/or using less power. Default:false
. PositionOptions.timeout
- Is a positive
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 isInfinity
, meaning thatgetCurrentPosition()
won't return until the position is available. PositionOptions.maximumAge
- Is a positive
long
value indicating the maximum age in milliseconds of a possible cached position that is acceptable to return. If set to0
, it means that the device cannot use a cached position and must attempt to retrieve the real current position. If set toInfinity
the device must return a cached position regardless of its age. Default: 0.
Methods
The PositionOptions
interface neither implements, nor inherits any method.
Specifications
Specification | Status | Comment |
---|---|---|
Geolocation API The definition of 'PositionOptions' in that specification. |
Recommendation | Initial definition |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 5 | 3.5 (1.9.1) | 9 | 10.60 Not supported 15.0 16.0 |
5 |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | ? | ? | 4.0 (4) | ? | 10.60 | ? |
See also
- Using geolocation
- The
Geolocation
interface that uses it.