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.
js
getCurrentPosition(success) getCurrentPosition(success, error) 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
Optional
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
Optional
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
Optional
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
.
None (undefined
).
js
const options = { enableHighAccuracy: true, timeout: 5000, maximumAge: 0, }; function success(pos) { const 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–2023 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