Web/API/Geolocation/getCurrentPosition

From Get docs

Secure contextThis 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.

Syntax

navigator.geolocation.getCurrentPosition(success[, error[, [options]])

Parameters

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 PositionOptions object. Options includes:
maximumAge
  • integer (milliseconds) | infinity - maximum cached position age.
  • timeout: integer (milliseconds) - amount of time before the error callback is invoked, if 0 it will never invoke.
  • enableHighAccuracy: false | true

Examples

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);

Specifications

Specification Status Comment
Geolocation API Recommendation Initial specification.

Browser compatibility

Update compatibility data on GitHub

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
getCurrentPosition Chrome

Full support 5

Edge

Full support 12

Firefox

Full support 3.5

IE

Full support 9

Opera

Full support 10.6

Safari

Full support 5

WebView Android

Full support ≤37

Chrome Android

Full support 18

Firefox Android

Full support 4

Opera Android

Full support 11

Safari iOS

Full support 5

Samsung Internet Android

Full support 1.0

Legend

Full support  
Full support


See also