Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The Geolocation.getCurrentPosition()
method is used to get the current position of the device.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The Geolocation.getCurrentPosition()
method is used to get the current position of the device.
navigator.geolocation.getCurrentPosition(success, error, [options])
success
A callback function that takes a GeolocationPosition
object as its sole input parameter.
error
Optional
An optional callback function that takes a GeolocationPositionError
object as its sole input parameter.
options
Optional
An optional object including the following parameters:
maximumAge
Is a positive 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.
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 is Infinity
, meaning that getCurrentPosition()
won't return until the position is available.
enableHighAccuracy
Is a boolean value 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
.
var options = { enableHighAccuracy: true, timeout: 5000, maximumAge: 0 }; function success(pos) { var crd = pos.coords; console.log('Your current position is:'); console.log(`Latitude : ${crd.latitude}`); console.log(`Longitude: ${crd.longitude}`); console.log(`More or less ${crd.accuracy} meters.`); } function error(err) { console.warn(`ERROR(${err.code}): ${err.message}`); } navigator.geolocation.getCurrentPosition(success, error, options);
Specification |
---|
Geolocation API # getcurrentposition-method |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
getCurrentPosition |
5
|
12
|
3.5
|
9
|
10.6
|
5
|
≤37
|
18
|
4
|
11
|
≤3
|
1.0
|
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Geolocation/getCurrentPosition