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

BCD tables only load in the browser

Siehe auch