Geolocation.getCurrentPosition()

Secure context

This feature is available only in secure contexts (en-US) (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 (en-US) als Parameter.
error Optional
Eine Funktion, die im Fehlerfall aufgerufen wird. Sie erhält ein Objekt vom Typ GeolocationPositionError (en-US) als Parameter.
options Optional
Ein Objekt vom Typ PositionOptions (en-US). 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