Geocoding API – Übersicht

Entwickler im Europäischen Wirtschaftsraum (EWR)

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:

  • Geografische Koordinaten für Adressen.
  • Adressen für Gruppen von Breiten- und Längengraden.
  • Adressen für Orts-IDs.

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, USA“ 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-/Längengradkoordinaten oder eine Orts-ID in eine visuell lesbare Adresse um. Sie können Adressen für verschiedene Szenarien verwenden, z. B. für Lieferungen oder Abholungen.

In der folgenden Demo wird der Geocoding-Dienst über die Maps JavaScript API verwendet, um die Funktionsweise der Geocoding API zu veranschaulichen. Öffnen Sie die Karte auf einem separaten Tab, um weitere Optionen und Details zu sehen.

Ressourcen

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 im Leitfaden Geocoding-Anfrage und -Antwort im Abschnitt Ergebnisse.
  • JSON
  • XML
Umgekehrte Geocodierung Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie im Leitfaden für Anfragen und Antworten zur umgekehrten Geocodierung unter Antworten zur umgekehrten Geocodierung.
Geocoding von Orten Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie im Leitfaden zu Anfragen und Antworten für die Orts-Geocodierung unter Antworten für die umgekehrte Geocodierung.

Geocoding API verwenden

1 Einrichtung Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Einrichtungsanleitung.
2 Geocoding-Anfrage ausprobieren Sobald Sie einen API-Schlüssel haben, können Sie die Geocoding API direkt über curl oder einen Browser testen. Sie müssen die richtigen Suchparameter für Adress- oder Komponentensuchen angeben. Weitere Informationen finden Sie unter Geocoding-Parameter.
3 Umgekehrte Geocodierungsanfrage ausprobieren Geben Sie zusammen mit Ihrem API-Schlüssel die Breiten- und Längengradkoordinaten an, um Adresskomponenten für die nächstgelegene lesbare Adresse für diesen Ort abzurufen. Weitere Informationen finden Sie unter Anfragen zur umgekehrten Geocodierung.
4 Grundlagen zu Antworten Alle Endpunkte in der Geocoding API geben dieselben Daten entweder in JSON oder XML zurück. Eine Erläuterung der Daten, Statuscodes und Fehlermeldungen finden Sie unter Geocoding-Antworten.
5 Geocoding-Daten in Ihre eigene App einbinden Mit Geocoding-Daten können Sie Adressen aus Kartenmarkierungen abrufen oder Markierungen auf einer Karte auf Grundlage einer bekannten Adresse bereitstellen.

Verfügbare Clientbibliotheken

Rufen Sie diese API in der Sprache Ihrer Wahl über eine der folgenden Clientbibliotheken auf:

Die Java-, Python-, Go- und Node.js-Clients für Google Maps-Dienste sind von der Community unterstützte Clientbibliotheken, die unter der Apache 2.0-Lizenz als Open Source zur Verfügung gestellt werden. Sie können sie von GitHub herunterladen. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte