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

Die position-Eigenschaft des schreibgeschützten HTMLGeolocationElement-Interfaces gibt ein GeolocationPosition-Objekt zurück, das die Position des Benutzers bei erfolgreichem Abruf von Standortdaten darstellt.

Die abgerufene Position kann aktuell oder nicht aktuell sein. Die Position des Benutzers wird nur einmal abgerufen, wenn die Schaltfläche des <geolocation>-Elements gedrückt wird, es sei denn, Sie setzen das watch-Attribut auf true. In diesem Fall wird eine neue Position jedes Mal abgerufen, wenn sich das Gerät des Benutzers bewegt. Um die aktuelle Position des Benutzers zu lesen, sollten Sie die position-Eigenschaft in Reaktion auf das Auslösen des location-Ereignisses ablesen.

Wenn der Abruf von Standortdaten scheitert, sind die zugehörigen Fehlermeldungen in der HTMLGeolocationElement.error-Eigenschaft verfügbar.

Wert

Ein GeolocationPosition-Objekt oder null, wenn der Abruf von Standortdaten gescheitert 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 Beispiel zu eingebetteten Karten für ein praxisnahes Beispiel an, das position umfasst.

Spezifikationen

This feature does not appear to be defined in any specification.

Browser-Kompatibilität

Siehe auch