Die Geocoding API ist ein Dienst, der einen Ort als Adresse, Breiten- und Längengradkoordinaten oder Orts-ID akzeptiert. Sie wandelt die Adresse in Breiten- und Längengradkoordinaten und eine Orts-ID um oder wandelt Breiten- und Längengradkoordinaten oder eine Orts-ID in eine Adresse um.
Möglichkeiten mit der Geocoding API
Mit der Geocoding API können Sie Geocoding-Daten für eine oder mehrere Adressen oder Orte abrufen, darunter:
Diese Version der Geocoding API v4 umfasst die folgenden Endpunkte:
- Adresse geocodieren : geografische Koordinaten für Adressen. Wird auch als Vorwärtsgeocoding bezeichnet.
- Ort geocodieren : Adressen für Sätze von Breiten- und Längengradkoordinaten. Wird auch als umgekehrte Geocodierung bezeichnet.
- Ortsgeocoding : Adresse anhand einer Orts-ID abrufen.
- Nach Zielen suchen : Ziel anhand einer Adresse, Orts-ID oder eines Ortes suchen.
Sie können festlegen, wo die Ergebnisse angezeigt werden, und die Ergebnisse auf eine bestimmte Region, ein bestimmtes Land oder eine bestimmte Postleitzahl beschränken.
Demo ansehen
Funktionsweise der Geocoding API
Die Geocoding API führt sowohl Geocoding als auch umgekehrte Geocodierung durch:
- Geocoding: Wandelt Adressen wie „1600 Amphitheatre Parkway, Mountain View, CA“ in Breiten- und Längengradkoordinaten oder Orts-IDs um. Mit diesen Koordinaten können Sie Markierungen auf einer Karte platzieren oder die Karte im Ansichtsrahmen zentrieren oder neu positionieren.
- Umgekehrte Geocodierung: Wandelt Breiten- und Längengradkoordinaten oder eine Orts-ID in eine für Menschen lesbare Adresse um. Sie können Adressen für eine Vielzahl von Szenarien verwenden, z. B. für Lieferungen oder Abholungen.
In der folgenden Tabelle sind die über die Geocoding API verfügbaren Ressourcen sowie die von den einzelnen Methoden zurückgegebenen Daten zusammengefasst.
| Datenressourcen | Zurückgegebene Daten | Rückgabeformat |
|---|---|---|
| Geocoding | Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie in der Dokumentation zur Geocode-Antwort. |
|
| Umgekehrte Geocodierung | Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie in der Dokumentation zur Antwort auf die umgekehrte Geocodierung. | |
| Ortsgeocoding | Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie in der Dokumentation zur Antwort auf das Ortsgeocoding. | |
| Zielsuche | Gibt detaillierte Informationen zu verschiedenen Zielen basierend auf unterschiedlichen Eingabekriterien zurück, z. B. eine Adresse, Orts-ID oder Breiten- und Längengradkoordinaten. Weitere Informationen finden Sie in der Dokumentation zur Zielsuche. |
Funktionen in der Geocoding API v4
Version 4 der Geocoding API bietet die folgenden neuen Funktionen.
Methode zur Zielsuche
Version 4 führt eine Methode zur Zielsuche ein, mit der Sie detaillierte Informationen zu verschiedenen Zielen basierend auf unterschiedlichen Eingabekriterien abrufen können, z. B. eine Adresse, Orts-ID oder Breiten- und Längengrad koordinaten. Die Antwort enthält KI-gestützte Zusammenfassungen und Navigationstokens , die Kontextinformationen enthalten, die an das Navigation SDK für eine genaue Routenplanung übergeben werden können.
Implementiert auf der Google Cloud-Standardplattform
Die Geocoding API v4 wird in der Dienst infrastruktur von Google Cloud implementiert. Diese Implementierung bietet eine sicherere und zuverlässigere Plattform mit erweiterten Sicherheitsoptionen wie OAuth. Dieses Standard-API-Design sorgt für Konsistenz zwischen den APIs und verbessert die Effizienz der Entwicklung mit der Geocoding API v4.
OAuth-Unterstützung hinzugefügt
Die Geocoding API v4 unterstützt die Verwendung von OAuth 2.0 zur Authentifizierung. Google unterstützt gängige OAuth 2.0-Szenarien, z. B. für einen Webserver.
Unterstützung für Feldmasken hinzugefügt
Verwenden Sie Feldmasken, um anzugeben, welche Informationen in der Antwort zurückgegeben werden sollen. Bei den Methoden „Adresse geocodieren“, „Ort geocodieren“ und „Orts geocoding“ werden standardmäßig alle Felder im Antwortobjekt zurückgegeben. Bei der Methode „Nach Zielen suchen“ müssen Sie in der API-Anfrage eine Feldmaske angeben.
API-Sicherheit
Die Geocoding API v4 ist als Server‑zu‑Server-API konzipiert. Direkte clientseitige Aufrufe aus einem Browser setzen API-Schlüssel einem erheblichen Risiko von Diebstahl und Missbrauch aus, da Einschränkungen vom Typ „HTTP-Referrer“ keinen ausreichenden Schutz für Webdienstendpunkte bieten.
Wir empfehlen dringend, die Geocoding API v4 von Ihrem eigenen Back-End-Server aufzurufen. Weitere Informationen zu sicheren Implementierungsmustern und Alternativen für clientseitige Anforderungen finden Sie unter Sicherheits überlegungen.