HTMLGeolocationElement: location-Ereignis

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Das location-Ereignis der HTMLGeolocationElement-Schnittstelle wird ausgelöst, wenn der Browser Standortdaten empfängt oder wenn eine Anfrage nach Standortdaten fehlgeschlagen ist und Fehlerinformationen vorliegen.

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

addEventListener("location", (event) => { })

Alternativ können Sie der Ereignisbehandlereigenschaft der Schnittstelle einen Wert zuweisen:

onlocation = (event) => { }

Ereignistyp

Ein Event.

Beispiele

Mit `location` auf Standortdaten und Fehler reagieren

In unserer Demo einer eingebetteten Karte (Quellcode) verwenden wir einen location-Ereignisbehandler, um auf empfangene Standortdaten und Fehler zu reagieren:

geo.addEventListener("location", () => {
  if (geo.position) {
    console.log(
      `${geo.position.coords.latitude},${geo.position.coords.longitude}`,
    );
    drawMap(geo.position.coords.latitude, geo.position.coords.longitude, geo);
  } else if (geo.error) {
    console.log(geo.error.message);
  }
});

Wenn Standortdaten erfolgreich zurückgegeben werden, greifen wir über die Eigenschaft HTMLGeolocationElement.position darauf zu und lesen die Werte für Breiten- und Längengrad aus. Wir geben diese Werte in der Konsole aus und stellen sie anschließend auf einer Karte dar, indem wir sie zusammen mit einer Referenz auf das HTMLGeolocationElement-Objekt an die Funktion drawMap() übergeben. Wenn die Datenanfrage fehlschlägt, greifen wir über die Eigenschaft HTMLGeolocationElement.error auf den Fehler zu und geben die Fehlermeldung in der Konsole aus.

Eine vollständige Erläuterung dieses Beispiels finden Sie auf der Hauptseite zu HTMLGeolocationElement.