Geolocation.getCurrentPosition()

Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Mit der Methode Geolocation.getCurrentPosition() kann die Position des Gerätes bestimmt werden.

Syntax

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

Parameter

success
Eine Funktion, die nach erfolgreicher Positionsbestimmung aufgerufen wird. Sie erhält ein Objekt vom Typ GeolocationPosition als Parameter.
error Optional
Eine Funktion, die im Fehlerfall aufgerufen wird. Sie erhält ein Objekt vom Typ GeolocationPositionError als Parameter.
options Optional
Ein Objekt vom Typ PositionOptions. Es enthält:
  • maximumAge: Die Positionsbestimmung darf höchstens diese Zeit in Millisekunden zurückliegen. Falls 0, muss ein aktueller Wert ermittelt werden, falls Infinity, sollte kein aktueller Wert ermittelt werden.
    Vorgabe: 0.
  • timeout: Wartezeit in Millisekunden, bis die Positionsbestimmung abgebrochen und, so gegeben, die Funktion error aufgerufen wird. Bei Infinity keine Begrenzung.
    Vorgabe: Infinity.
  • enableHighAccuracy: true, um eine genauere Position zu ermitteln, jedoch möglicherweise zu Lasten von Wartezeit und Energieverbrauch.
    Vorgabe: false.

Beispiel

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

Spezifikationen

Spezifikation Status Kommentar
Geolocation API Empfehlung Erste Spezifikation.

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung Internet
getCurrentPositionChrome Vollständige Unterstützung 5Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 3.5IE Vollständige Unterstützung 9Opera Vollständige Unterstützung 10.6Safari Vollständige Unterstützung 5WebView Android Vollständige Unterstützung ≤37Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung 11Safari iOS Vollständige Unterstützung 5Samsung Internet Android Vollständige Unterstützung 1.0

Legende

Vollständige Unterstützung  
Vollständige Unterstützung

Siehe auch