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. 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.

Was Sie mit der Geocoding API tun können

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 Sätze von Breiten- und Längengradkoordinaten.
  • Adressen für Orts-IDs.

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.

Funktionsweise der Geocoding API

Die Geocoding API bietet sowohl Geocodierung als auch umgekehrte Geocodierung:

  • 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- und Längengradkoordinaten oder eine Orts-ID in eine menschenlesbare Adresse um. Sie können Adressen für eine Vielzahl von Szenarien verwenden, einschließlich 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 in 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 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 im Leitfaden Geocoding-Anfrage und -Antwort unter Ergebnisse.
  • JSON
  • XML
Umgekehrte Geocodierung Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie im Leitfaden zu Anfragen und Antworten für die umgekehrte Geocodierung unter Antworten für die umgekehrte Geocodierung.
Geocoding von Orten Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie im Leitfaden zu Geocoding-Anfragen und ‑Antworten für Orte unter Antworten bei umgekehrter Geocodierung.

Geocoding API verwenden

1 Einrichten 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 die Adress- oder Komponentensuche angeben. Weitere Informationen finden Sie unter Geocoding-Parameter.
3 Anfrage zur umgekehrten Geocodierung ausprobieren Geben Sie die Längen- und Breitengradkoordinaten zusammen mit Ihrem API-Schlüssel an, um Adresskomponenten für die nächstgelegene menschenlesbare Adresse für diesen Standort zu erhalten. Weitere Informationen finden Sie unter Anfragen zur umgekehrten Geocodierung.
4 Grundlagen zu Antworten Alle Methoden in der Geocoding API geben dieselben Daten entweder im JSON- oder im XML-Format 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 anhand einer bekannten Adresse platzieren.

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. Laden Sie sie von GitHub herunter. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte