Die Geocoding API ist ein Dienst, der einen Ort als Adresse, Breiten- und Längengradkoordinaten oder Orts-ID akzeptiert. Damit 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.
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 Zielorten suchen: Sie können anhand einer Adresse, Orts-ID oder eines Standorts nach einem Zielort 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. Sie können diese Koordinaten verwenden, um Markierungen auf einer Karte zu platzieren oder die Karte im Ansichtsrahmen zu zentrieren oder neu zu 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 Methoden 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. Adresse, 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.
Suchmethode für Ziel
In Version 4 wird die Methode „Zielortsuche“ eingeführt, mit der Sie detaillierte Informationen zu verschiedenen Zielorten auf Grundlage unterschiedlicher Eingabekriterien wie Adresse, Orts-ID oder Breiten- und Längengradkoordinaten abrufen können. Die Antwort enthält KI-basierte Zusammenfassungen und Tokens für Navigationspunkte 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 Einheitlichkeit 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. Bei den Methoden Geocode an address, Geocode a location und Place geocoding werden standardmäßig alle Felder im Antwortobjekt zurückgegeben. Für die Methode Search for destinations (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.
API-Sicherheit
Die Geocoding API v4 ist als Server-zu-Server-API konzipiert. Direkte clientseitige Aufrufe über einen Browser setzen API-Schlüssel einem erheblichen Risiko von Diebstahl und Missbrauch aus, da HTTP-Referrer-Einschränkungen keinen ausreichenden Schutz für Webdienstendpunkte 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.
Feedback
Dies ist eine Funktion in der Vorabversion. Wir freuen uns über Feedback unter geocoding-feedback-channel@google.com.