Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

HTMLGeolocationElement: position-Eigenschaft

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

Die position-Eigenschaft des HTMLGeolocationElement-Interfaces ist eine schreibgeschützte Eigenschaft, die ein GeolocationPosition-Objekt zurückgibt, das die Position des Benutzers darstellt, wenn die Standortdaten erfolgreich abgerufen wurden.

Die abgerufene Position kann aktuell sein oder nicht. Die Position des Benutzers wird nur einmal ermittelt, wenn die Steuerungstaste des <geolocation>-Elements gedrückt wird, es sei denn, Sie setzen das watch-Attribut auf true. In diesem Fall wird jedes Mal, wenn sich das Gerät des Benutzers bewegt, eine neue Position abgerufen. Um die aktuelle Position des Benutzers abzurufen, sollten Sie die position-Eigenschaft als Antwort auf das location-Ereignis lesen.

Wenn das Abrufen der Standortdaten fehlschlägt, werden die zugehörigen Fehlerinformationen in der HTMLGeolocationElement.error-Eigenschaft verfügbar sein.

Wert

Ein GeolocationPosition-Objekt oder null, falls das Abrufen der Standortdaten fehlgeschlagen ist oder die Daten noch nicht abgerufen wurden.

Beispiele

Grundlegende Verwendung

html
<geolocation autolocate></geolocation>
js
const geo = document.querySelector("geolocation");
geo.addEventListener("location", () => {
  if (geo.position) {
    console.log(
      `(${geo.position.coords.latitude},${geo.position.coords.longitude})`,
    );
  } else if (geo.error) {
    console.log(geo.error.message);
  }
});

Sehen Sie sich unser Einbetten von Karten-Beispiel für ein praktisches Beispiel an, das position enthält.

Spezifikationen

Specification
The HTML Permission Elements
# dom-htmlgeolocationelement-position

Browser-Kompatibilität

Siehe auch