GeolocationCoordinates: longitude-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2020 browserübergreifend verfügbar.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die schreibgeschützte Eigenschaft longitude der Schnittstelle GeolocationCoordinates ist eine Zahl, die den Längengrad einer geografischen Position in Dezimalgrad angibt.
Zusammen mit einem Zeitstempel, der als Unix-Zeit in Millisekunden angegeben wird und den Zeitpunkt der Messung bezeichnet, ist das GeolocationCoordinates-Objekt Teil der Schnittstelle GeolocationPosition. Diese Schnittstelle definiert den Objekttyp, den Funktionen der Geolocation API zurückgeben, wenn sie eine geografische Position ermitteln.
Wert
Der Wert von longitude ist der geografische Längengrad des Ortes auf der Erde, den das Coordinates-Objekt beschreibt, angegeben in Dezimalgrad. Der Wert ist durch die Spezifikation des World Geodetic System 1984 (WGS 84) definiert.
Hinweis: Der Nullmeridian (auch als Referenzmeridian bezeichnet) stimmt nicht genau mit dem Greenwich-Meridian überein, an den die meisten Menschen dabei denken. Stattdessen handelt es sich um den IERS-Referenzmeridian, der 5,3 Bogensekunden (102 Meter / 335 Fuß) östlich des Greenwich-Meridians liegt. Dies ist derselbe Standard, den auch das Global Positioning System (GPS) verwendet.
Beispiele
In diesem einfachen Beispiel rufen wir den Standort der nutzenden Person ab und zeigen die ermittelten Koordinaten an, sobald sie zurückgegeben wurden.
HTML
Der HTML-Code zur Darstellung der Ergebnisse sieht so aus:
<p>
Your location is <span id="latitude">0.00</span>° latitude by
<span id="longitude">0.00</span>° longitude.
</p>
<button id="get-location">Get My Location</button>
JavaScript
Der folgende JavaScript-Code richtet einen Event-Listener ein, der die Standortinformationen abruft und anzeigt, wenn die nutzende Person auf eine Schaltfläche klickt.
let button = document.getElementById("get-location");
let latText = document.getElementById("latitude");
let longText = document.getElementById("longitude");
button.addEventListener("click", () => {
navigator.geolocation.getCurrentPosition((position) => {
let lat = position.coords.latitude;
let long = position.coords.longitude;
latText.innerText = lat.toFixed(2);
longText.innerText = long.toFixed(2);
});
});
Nachdem Variablen eingerichtet wurden, um einfacher auf das button-Element und die beiden Elemente zur Anzeige von Breiten- und Längengrad zuzugreifen, wird der Event-Listener durch einen Aufruf von addEventListener() für das <button>-Element eingerichtet. Wenn die nutzende Person auf die Schaltfläche klickt, rufen wir die Standortinformationen ab und zeigen sie an.
Beim Eintreffen eines click-Events rufen wir getCurrentPosition() auf, um die aktuelle Position des Geräts anzufordern. Da diese Anfrage asynchron ist, übergeben wir eine Callback-Funktion, die ein GeolocationPosition-Objekt mit der ermittelten Position erhält.
Aus dem GeolocationPosition-Objekt lesen wir mit position.coords.latitude und position.coords.longitude den Breiten- und Längengrad der nutzenden Person aus, um die angezeigten Koordinaten zu aktualisieren. Die beiden <span>-Elemente werden mit den entsprechenden Werten aktualisiert, nachdem diese auf zwei Dezimalstellen gerundet wurden.
Ergebnis
Sie können das Beispiel hier ausprobieren:
Spezifikationen
| Spezifikation |
|---|
| Geolocation # latitude-longitude-and-accuracy-attributes |
Browser-Kompatibilität
Siehe auch
- Verwendung der Geolocation API
- Die Schnittstelle
GeolocationCoordinates, zu der diese Eigenschaft gehört. - Die Schnittstelle
GeolocationPosition. Sie ist die übergeordnete Schnittstelle für die Geolokalisierungsdaten, die von den Geolocation-API-FunktionenGeolocation.getCurrentPosition()undwatchPosition()zurückgegeben werden.