Die Geocoding API ist ein Dienst, der einen Ort als Adresse, Breiten- und Längengradkoordinaten oder Orts-ID akzeptiert. Dabei wird die Adresse in Breiten- und Längengradkoordinaten und eine Orts-ID umgewandelt oder Breiten- und Längengradkoordinaten oder eine Orts-ID in eine Adresse.
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 enthält die folgenden Endpunkte:
- Geocoding einer Adresse: Geografische Koordinaten für Adressen. Wird auch als Forward Geocoding bezeichnet.
- Geocoding für einen Standort durchführen: Adressen für Sätze von Breiten- und Längengradkoordinaten. Auch als umgekehrte Geocodierung bezeichnet.
- Geocoding für Orte: Adresse anhand einer Orts-ID abrufen.
- Nach Zielen suchen: Sie können anhand einer Adresse, einer Orts-ID oder eines Standorts nach einem Ziel suchen.
Sie können festlegen, wo die Ergebnisse angezeigt werden, und die Ergebnisse auf eine bestimmte Region, einen bestimmten Bezirk oder eine bestimmte Postleitzahl beschränken.
Demo ansehen
Funktionsweise der Geocoding API
Die Geocoding API bietet sowohl Geocodierung als auch umgekehrte Geocodierung:
- Geocoding: Adressen wie „1600 Amphitheatre Parkway, Mountain View, CA, USA“ werden in Breiten- und Längengradkoordinaten oder Orts-IDs umgewandelt. Mit diesen Koordinaten können Sie Markierungen auf einer Karte platzieren oder die Karte im Ansichtsrahmen zentrieren oder neu positionieren.
- Umgekehrte Geocodierung: Breiten- und Längengradkoordinaten oder eine Orts-ID werden in eine menschenlesbare Adresse umgewandelt. Sie können Adressen für eine Vielzahl von Szenarien verwenden, einschließlich 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 zu Geocoding-Antworten. |
|
| Umgekehrte Geocodierung | Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie in der Dokumentation zur Antwort für die umgekehrte Geocodierung. | |
| Geocoding von Orten | Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie in der Dokumentation zur Geocoding-Antwort für Orte. | |
| Zielsuche | Gibt detaillierte Informationen zu verschiedenen Zielen basierend auf unterschiedlichen Eingabekriterien zurück, z. B. Adresse, Orts-ID oder Längen- und Breitengradkoordinaten. Weitere Informationen finden Sie in der Dokumentation zu Zielsuche. |
Kanäle für Einführungsphasen
Version 4 der Geocoding API hat separate Kanäle für GA-, Vorabversion- und experimentelle Funktionen. Wenn Sie Funktionen der Vorabversion oder experimentelle Funktionen verwenden möchten, müssen Sie in Ihrer Anfrage den richtigen Kanal angeben. Wenn Sie beispielsweise auf Funktionen des Destinations-Endpunkts in der experimentellen Version zugreifen möchten, verwenden Sie diese HTTP-Anfrage: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| Startphase | Kanalname |
|---|---|
| GA | /v4/ |
| Vorschau | /v4beta/ |
| Experimentell | /v4alpha/ |
- Eine Liste und Beschreibung aller verfügbaren REST-Ressourcen finden Sie in der REST-Referenz.
- Weitere Informationen zu den einzelnen Phasen finden Sie unter Phasen der Markteinführung.
Funktionen in der Geocoding API v4
Version 4 der Geocoding API bietet die folgenden neuen Funktionen.
Suchmethode für Zielorte
In Version 4 wird die Methode „Destination Search“ eingeführt, mit der Sie detaillierte Informationen zu verschiedenen Zielen anhand verschiedener Eingabekriterien wie Adresse, Orts-ID oder Breiten- und Längengrad abrufen können. Die Antwort enthält KI-basierte Zusammenfassungen und Navigationspunkt-Tokens mit Kontextinformationen, die für eine genaue Routenplanung an das Navigation SDK übergeben werden können.
Implementiert auf der Google Cloud-Standardplattform
Die Geocoding API v4 ist in der Dienstinfrastruktur von Google Cloud implementiert. Diese Implementierung bietet eine sicherere und vertrauenswürdigere Plattform mit erweiterten Sicherheitsoptionen wie OAuth. Dieses standardmäßige API-Design sorgt für eine gewisse Konsistenz zwischen den APIs, was die Entwicklung mit der Geocoding API v4 effizienter macht.
OAuth-Unterstützung hinzugefügt
Die Geocoding API v4 unterstützt die Verwendung von OAuth 2.0 für die 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 die Antwort enthalten soll. Bei den Methoden Adresse geocodieren, Ort geocodieren und Ort geocodieren werden standardmäßig alle Felder im Antwortobjekt zurückgegeben. Für die 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 über einen Browser bergen ein erhebliches Risiko für Diebstahl und Missbrauch von API-Schlüsseln, da Einschränkungen vom Typ „HTTP-Referrer“ keinen ausreichenden Schutz für Webdienst-Endpunkte bieten.
Wir empfehlen dringend, die Geocoding API v4 von Ihrem eigenen Backend-Server aufzurufen. Weitere Informationen zu sicheren Implementierungsmustern und Alternativen für clientseitige Anforderungen finden Sie unter Sicherheitsaspekte.