Geolocation: getCurrentPosition() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die getCurrentPosition() Methode des Geolocation-Interfaces wird verwendet, um die aktuelle Position des Geräts zu ermitteln.

Beachten Sie, dass neben der Notwendigkeit eines sicheren Kontexts diese Funktion möglicherweise durch die geolocation Permissions-Policy blockiert wird und auch die ausdrückliche Erlaubnis durch den Benutzer erforderlich ist. Falls erforderlich, wird der Benutzer aufgefordert, wenn diese Methode aufgerufen wird. Der Berechtigungsstatus kann mit der geolocation-Berechtigung im Permissions API abgefragt werden.

Syntax

js
getCurrentPosition(success)
getCurrentPosition(success, error)
getCurrentPosition(success, error, options)

Parameter

success

Eine Callback-Funktion, die ein GeolocationPosition-Objekt als einziges Eingabeparameter übernimmt.

error Optional

Eine optionale Callback-Funktion, die ein GeolocationPositionError-Objekt als einziges Eingabeparameter übernimmt.

options Optional

Ein optionales Objekt, das die folgenden Parameter enthält:

maximumAge Optional

Ein positiver long-Wert, der das maximale Alter in Millisekunden eines möglicherweise zwischengespeicherten Standorts angibt, der akzeptabel ist, zurückgegeben zu werden. Wenn auf 0 gesetzt, bedeutet dies, dass das Gerät keinen zwischengespeicherten Standort verwenden kann und versuchen muss, die echte aktuelle Position zu erhalten. Wenn auf Infinity gesetzt, muss das Gerät unabhängig vom Alter einen zwischengespeicherten Standort zurückgeben. Standard: 0.

timeout Optional

Ein positiver long-Wert, der die maximale Zeitspanne (in Millisekunden) darstellt, die dem Gerät zur Verfügung steht, um einen Standort zurückzugeben. Der Standardwert ist Infinity, was bedeutet, dass getCurrentPosition() nicht zurückkehrt, bis der Standort verfügbar ist.

enableHighAccuracy Optional

Ein boolescher Wert, der angibt, dass die Anwendung die bestmöglichen Ergebnisse erhalten möchte. Wenn true und das Gerät in der Lage ist, eine genauere Position bereitzustellen, wird dies geschehen. Beachten Sie, dass dies zu langsameren Reaktionszeiten oder erhöhtem Stromverbrauch führen kann (zum Beispiel mit einem GPS-Chip auf einem Mobilgerät). Andererseits, wenn false, kann das Gerät die Freiheit haben, Ressourcen zu sparen, indem es schneller antwortet und/oder weniger Energie verbraucht. Standard: false.

Rückgabewert

Keiner (undefined).

Beispiele

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

Spezifikationen

Specification
Geolocation
# getcurrentposition-method

Browser-Kompatibilität

Siehe auch