Geolocation API
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die Geolocation-API ermöglicht es dem Benutzer, Webanwendungen ihren Standort mitzuteilen, falls sie dies wünschen. Aus Datenschutzgründen wird der Benutzer um Erlaubnis gebeten, Standortinformationen zu übermitteln.
WebExtensions, die das Geolocation-Objekt verwenden möchten, müssen die Berechtigung "geolocation" zu ihrem Manifest hinzufügen. Das Betriebssystem des Benutzers wird den Benutzer beim ersten Anfordern auffordern, den Zugriff auf den Standort zu erlauben.
Konzepte und Verwendung
Häufig möchte man in Ihrer Webanwendung die Standortinformationen eines Benutzers abrufen, um beispielsweise ihren Standort auf einer Karte darzustellen oder personalisierte Informationen bereitzustellen, die für ihren Standort relevant sind.
Auf die Geolocation-API wird über einen Aufruf von navigator.geolocation zugegriffen; dies führt dazu, dass der Browser des Benutzers ihn um Erlaubnis bittet, auf seine Standortdaten zuzugreifen. Wenn sie dies erlauben, verwendet der Browser die bestmögliche Funktionalität des Geräts, um auf diese Informationen zuzugreifen (z.B. GPS).
Der Entwickler kann nun auf diese Standortinformationen auf verschiedene Weise zugreifen:
Geolocation.getCurrentPosition(): Ruft den aktuellen Standort des Geräts ab.Geolocation.watchPosition(): Registriert eine Handlerfunktion, die automatisch bei jeder Änderung der Geräteposition aufgerufen wird und den aktualisierten Standort zurückgibt.
In beiden Fällen nimmt der Methodenaufruf bis zu drei Argumente entgegen:
- Ein obligatorischer Erfolgscallback: Wenn das Abrufen der Standortinformationen erfolgreich ist, wird der Callback mit einem
GeolocationPosition-Objekt als einzigem Parameter ausgeführt, das Zugriff auf die Standortdaten bietet. - Ein optionaler Fehlercallback: Wenn das Abrufen der Standortinformationen fehlgeschlagen ist, wird der Callback mit einem
GeolocationPositionError-Objekt als einzigem Parameter ausgeführt, das Zugriffsinformationen darüber bietet, was schiefgelaufen ist. - Ein optionales Objekt, das Optionen für das Abrufen der Standortdaten bereitstellt.
Für weitere Informationen zur Verwendung der Geolocation lesen Sie Verwenden der Geolocation-API.
Schnittstellen
Geolocation-
Die Hauptklasse dieser API — enthält Methoden, um die aktuelle Position des Benutzers abzurufen, Änderungen ihrer Position zu überwachen und eine zuvor gesetzte Überwachung zu löschen.
GeolocationPosition-
Repräsentiert die Position eines Benutzers. Eine
GeolocationPosition-Instanz wird durch einen erfolgreichen Aufruf einer der inGeolocationenthaltenen Methoden, in einem Erfolgscallback zurückgegeben und enthält einen Zeitstempel sowie eineGeolocationCoordinates-Objektinstanz. GeolocationCoordinates-
Repräsentiert die Koordinaten der Position eines Benutzers; eine
GeolocationCoordinates-Instanz enthält Breitengrad, Längengrad und andere wichtige verwandte Informationen. GeolocationPositionError-
Ein
GeolocationPositionErrorwird durch einen fehlgeschlagenen Aufruf einer der inGeolocationenthaltenen Methoden, in einem Fehlercallback zurückgegeben und enthält einen Fehlercode und eine Fehlermeldung.
Erweiterungen auf andere Schnittstellen
-
Der Einstiegspunkt in die API. Gibt eine
Geolocation-Objektinstanz zurück, von der aus alle anderen Funktionalitäten zugänglich sind.
Sicherheitsüberlegungen
Die Geolocation-API ermöglicht es Benutzern, in sicheren Kontexten programmgesteuert auf Standortinformationen zuzugreifen.
Der Zugriff kann weiter durch die Permissions Policy Direktive geolocation gesteuert werden.
Die Standard-Berechtigungsliste für geolocation ist self, was den Zugriff auf Standortinformationen nur in gleichartigen eingebetteten Frames erlaubt.
Die Nutzung durch Dritte wird durch Setzen eines Permissions-Policy-Response-Headers ermöglicht, um einer bestimmten Drittpartei-Quelle die Berechtigung zu erteilen:
Permissions-Policy: geolocation=(self b.example.com)
Das allow="geolocation"-Attribut muss dann dem iframe-Element hinzugefügt werden, dessen Quellen von dieser Quelle stammen:
<iframe src="https://b.example.com" allow="geolocation"></iframe>
Geolocation-Daten können Informationen preisgeben, die der Gerätebesitzer nicht teilen möchte.
Daher müssen Benutzer explizit über eine Aufforderung die Erlaubnis erteilen, wenn entweder Geolocation.getCurrentPosition() oder Geolocation.watchPosition() aufgerufen wird (es sei denn, der Berechtigungsstatus ist bereits granted oder denied).
Die Lebensdauer einer gewährten Berechtigung hängt vom Benutzeragenten ab und kann zeitbasiert, sitzungsbasiert oder sogar dauerhaft sein.
Die Permissions API geolocation-Berechtigung kann verwendet werden, um zu testen, ob der Zugriff, um Standortinformationen zu verwenden, granted, denied oder prompt ist (erfordert die Anerkennung einer Aufforderung durch den Benutzer).
Beispiele
Siehe Verwenden der Geolocation-API für Beispielcode.
Spezifikationen
| Specification |
|---|
| Geolocation # geolocation_interface |
Browser-Kompatibilität
Verfügbarkeit
Da die Standortbestimmung auf Basis von Wi-Fi oft von Google bereitgestellt wird, kann die Standard-Geolocation-API in China nicht verfügbar sein. Sie können lokale Drittanbieter wie Baidu, Autonavi oder Tencent nutzen. Diese Dienste verwenden die IP-Adresse des Benutzers und/oder eine lokale App, um die Positionierung zu verbessern.
Siehe auch
- Verwenden der Geolocation-API
- Who moved my geolocation? (Hacks-Blog)