Geolocation: Methode getCurrentPosition()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

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

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

Beachten Sie, dass diese Funktion neben der Anforderung eines sicheren Kontexts möglicherweise durch die geolocation Permissions-Policy blockiert werden kann und außerdem explizite Zustimmung durch den Benutzer erfordert. Falls erforderlich, wird der Benutzer aufgefordert, wenn diese Methode aufgerufen wird. Der Berechtigungsstatus kann mithilfe der Benutzerberechtigung geolocation in der Permissions API abgefragt werden.

In diesem Artikel

Syntax

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

Parameter

success

Eine Callback-Funktion, die ein GeolocationPosition-Objekt als einzigen Eingabeparameter verwendet.

error Optional

Eine optionale Callback-Funktion, die ein GeolocationPositionError-Objekt als einzigen Eingabeparameter verwendet.

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öglichen zwischengespeicherten Standorts anzeigt, der akzeptabel ist. Wenn auf 0 gesetzt, bedeutet dies, dass das Gerät keinen zwischengespeicherten Standort verwenden kann und versuchen muss, die tatsächliche aktuelle Position zu ermitteln. Wenn auf Infinity gesetzt, muss das Gerät unabhängig von dessen 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 erlaubt ist, um eine Position zurückzugeben. Der Standardwert ist Infinity, was bedeutet, dass getCurrentPosition() nicht zurückgibt, bis die Position 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 es dies tun. Beachten Sie, dass dies zu langsameren Reaktionszeiten oder erhöhtem Stromverbrauch führen kann (beispielsweise mit einem GPS-Chip auf einem mobilen Gerät). Andererseits kann das Gerät bei false Ressourcen sparen, indem es schneller reagiert und/oder weniger Strom 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);

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Geolocation API
Geolocation
Instanzmethoden
Verwandte Seiten für Geolocation API
Anleitungen
1. Verwendung der Geolocation API