Geocoding API – Übersicht

Die Geocoding API ist ein Dienst, der einen Ort als Adresse, Breiten- und Längengrade oder Orts-ID akzeptiert. Sie wandelt die Adresse in Breiten- und Längengrade und eine Orts-ID um oder wandelt Breiten- und Längengradkoordinaten oder eine Orts-ID in eine Adresse um.

Vorteile der Geocoding API

Verwenden Sie die Geocoding API für Websites oder mobile Apps, wenn Sie Geocoding-Daten in Karten verwenden möchten, die über eine der Google Maps Platform APIs bereitgestellt werden. Mit der Geocoding API können Sie Adressen verwenden, um Markierungen auf einer Karte zu platzieren oder eine Markierung auf einer Karte in eine Adresse umzuwandeln. Dieser Dienst wurde entwickelt, um vordefinierte, statische Adressen zu geocodieren, um Anwendungsinhalte auf einer Karte zu platzieren.

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 Längen- und Breitengradkoordinaten.
  • Adressen für Orts-IDs

Sie können steuern, wo die Ergebnisse angezeigt werden, und die Ergebnisse auf eine bestimmte Region, einen Landkreis oder eine Postleitzahl beschränken.

Funktionsweise der Geocoding API

Das Geocoding API führt sowohl Geocoding als auch umgekehrtes Geocoding aus:

  • Geocoding: Adressen wie „1600 Amphitheatre Parkway, Mountain View, CA“ werden in Breiten- und Längengrade oder Orts-IDs umgewandelt. Sie können diese Koordinaten verwenden, um Markierungen auf einer Karte zu platzieren oder die Karte innerhalb des Ansichtsframes zu zentrieren oder neu zu positionieren.
  • Umgekehrte Geocodierung: Damit wandeln Sie Breiten- und Längengradkoordinaten oder eine Orts-ID in eine für Menschen lesbare Adresse um. Sie können Adressen für eine Vielzahl von Szenarien verwenden, einschließlich Lieferungen oder Abholungen.

In der folgenden Demo wird anhand des Geocoding-Dienstes über die Maps JavaScript API die Funktionsweise der Geocoding API veranschaulicht. Ö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 und die von jedem Endpunkt zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Geocoding Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie im Leitfaden zu Geocoding-Anfragen und -Antworten unter Ergebnisse.
  • JSON
  • XML
Umgekehrte Geocodierung Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie unter Antworten zum umgekehrten Geocoding im Leitfaden Anfragen und Antworten zum umgekehrten Geocoding.
Orts-Geocoding Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie unter Antworten für das umgekehrte Geocoding im Leitfaden Anfrage und Antwort für das Place Geocoding.

Geocoding API verwenden

1 Jetzt einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung für die Einrichtung.
2 Geocoding-Anfrage senden 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 zum umgekehrten Geocoding senden Geben Sie zusammen mit Ihrem API-Schlüssel Koordinaten für Breiten- und Längengrad an, um Adresskomponenten für die nächstgelegene menschenlesbare Adresse für diesen Ort zu erhalten. Weitere Informationen finden Sie unter Anfragen zum umgekehrten Geocoding .
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 Sie können Geocoding-Daten in Ihre eigene App einbinden. Mit Geocoding-Daten können Sie Adressen aus Kartenmarkierungen abrufen oder Markierungen auf einer Karte basierend auf 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. Laden Sie sie von GitHub herunter. Dort finden Sie auch eine Installationsanleitung und Beispielcode.

Nächste Schritte