Die Geocoding API ist ein Dienst, der einen Ort als Adresse, Breiten- und Längengradkoordinaten oder Orts-ID akzeptiert. Der Dienst 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.
Funktionen 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:
- (Vorschau) Geocoding einer Adresse: Geografische Koordinaten für Adressen. Wird auch als Forward Geocoding bezeichnet.
- (Vorabversion) Standort geocodieren: Adressen für Gruppen von Breiten- und Längengraden. Wird auch als umgekehrte Geocodierung bezeichnet.
- (Vorabversion) Orts-Geocoding: Mit dieser Funktion können Sie eine Adresse anhand einer Orts-ID abrufen.
- (Vorabversion) Nach Zielen suchen: Sie können anhand einer Adresse, Orts-ID oder eines Standorts nach einem Ziel suchen.
Sie können festlegen, wo die Ergebnisse angezeigt werden, und sie auf eine bestimmte Region, einen bestimmten Bezirk oder eine bestimmte Postleitzahl beschränken.
Funktionsweise der Geocoding API
Die Geocoding API bietet sowohl Geocoding als auch umgekehrtes Geocoding:
- 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 lesbare Adresse um. Sie können Adressen für verschiedene Szenarien verwenden, z. B. für Lieferungen oder Abholungen.
In der folgenden Tabelle sind die über die Geocoding API verfügbaren Ressourcen sowie die Daten, die von den einzelnen Endpunkten zurückgegeben werden, 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 bei der umgekehrten 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 auf Grundlage unterschiedlicher Eingabekriterien zurück, z. B. eine Adresse, eine Orts-ID oder Längen- und Breitengradkoordinaten. Weitere Informationen finden Sie in der Dokumentation zur Zielsuche. |
Funktionen in der Geocoding API v4
Version 4 der Geocoding API bietet diese neuen Funktionen.
Endpunkt für die Suche nach Reisezielen
In Version 4 wird ein Endpunkt für die Zielortsuche eingeführt, mit dem Sie detaillierte Informationen zu verschiedenen Zielorten basierend auf unterschiedlichen Eingabekriterien wie einer Adresse, einer Orts-ID oder Breiten- und Längengradkoordinaten abrufen können. Die Antwort enthält KI-basierte Zusammenfassungen und Navigationspunkt-Tokens mit Kontextinformationen, die für ein präzises Routing an das Navigation SDK übergeben werden können.
Auf der Google Cloud-Standardplattform implementiert
Die Geocoding API v4 wird in der Dienstinfrastruktur in Google Cloud implementiert. Diese Implementierung bietet eine sicherere und vertrauenswürdige Plattform mit erweiterten Sicherheitsoptionen wie OAuth. Dieses standardisierte 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
Mit Feldmasken können Sie angeben, welche Informationen in der Antwort zurückgegeben werden sollen. Für die Endpunkte Geocode an address (Adresse geocodieren), Geocode a location (Standort geocodieren) und Place geocoding (Orts-Geocodierung) werden standardmäßig alle Felder im Antwortobjekt zurückgegeben. Für den Endpunkt Nach Zielorten suchen müssen Sie in der API-Anfrage eine Feldmaske angeben.
Kostenlose Nutzung während der Vorschau
Die Geocoding API v4 befindet sich in der Pre-GA-Vorschauphase. Während der Vorschauphase fallen keine Gebühren für die API-Nutzung an. API-Aufrufe werden auf der Abrechnungsseite in der Cloud Console angezeigt, aber es fallen keine Gebühren an.
Feedback
Dies ist eine Funktion in der Vorabversion. Wir freuen uns über Feedback unter geocoding-feedback-channel@google.com.