Geocoding API – Übersicht

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

Vorteile der Geocoding API

Wenn Sie Geocoding-Daten in Karten verwenden möchten, die über eine der Google Maps Platform APIs bereitgestellt werden, verwenden Sie die Geocoding API für Websites oder mobile Apps. 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 umwandeln. Dieser Dienst wurde für die Geocodierung vordefinierter statischer Adressen entwickelt, um Anwendungsinhalte auf einer Karte zu platzieren.

Möglichkeiten mit 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 Landkreis oder eine Postleitzahl beschränken.

Funktionsweise der Geocoding API

Die Geocoding API bietet sowohl die Geocodierung als auch die umgekehrte Geocodierung:

  • 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 innerhalb des Ansichtsrahmens zu zentrieren oder neu zu positionieren.
  • Umgekehrte Geocodierung: Wandelt Breiten- und Längengradkoordinaten oder eine Orts-ID in eine visuell lesbare Adresse um Sie können Adressen für verschiedene Szenarien verwenden, einschließlich Lieferungen oder Abholungen.

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

Weitere Informationen

In der folgenden Tabelle sind die über die Geocoding API verfügbaren Ressourcen und die von den einzelnen Endpunkten zurückgegebenen Daten aufgeführt.

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.
  • JavaScript Object Notation
  • XML
Umgekehrte Geocodierung Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie unter Antworten beim umgekehrten Geocoding im Leitfaden Anfrage und Antwort für umgekehrte Geocodierung.
Orts-Geocoding Gibt Adresse, Adresskomponenten und Adresstypen zurück. Weitere Informationen finden Sie unter Antworten zum umgekehrten Geocoding im Leitfaden „Place Geocoding“-Anfrage und ‐Antwort.

Geocoding API verwenden

1 Jetzt einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der nachstehenden 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. Für die Adress- oder Komponentensuche müssen die richtigen Lookup-Parameter angegeben werden. Weitere Informationen finden Sie unter Geocoding-Parameter.
3 Anfrage zum umgekehrten Geocoding ausführen Geben Sie zusammen mit dem API-Schlüssel Breiten- und Längengrade an, um Adresskomponenten für die nächstgelegene visuell lesbare Adresse für diesen Ort zu erhalten. Weitere Informationen finden Sie unter Anfragen für das umgekehrte Geocoding .
4 Grundlagen von Antworten Alle Endpunkte in der Geocoding API geben dieselben Daten im JSON- oder 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 basierend auf einer bekannten Adresse einfügen.

Verfügbare Clientbibliotheken

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

Der Java-, Python-, Go- und Node.js-Client 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