Die Geocoding API ist ein Dienst für die Geocodierung und umgekehrte Geokodierung von Adressen.
Beim Geocoding werden Adressen (z. B. eine Straßenadresse) in geografische Koordinaten (z. B. Breiten- und Längengrad) umgewandelt. Anhand dieser Koordinaten können Sie dann Markierungen auf einer Karte platzieren oder die Karte positionieren.
Bei der umgekehrten Geocodierung werden geografische Koordinaten in eine visuell lesbare Adresse umgewandelt.
Sie können über die Geocoding API auch die Adresse für eine bestimmte Orts-ID ermitteln.
Beispielanforderung und -antwort
Sie greifen über eine HTTP-Schnittstelle auf die Geocoding API zu. Im Folgenden finden Sie Beispiele für Geocoding- und umgekehrte Geocoding-Anfragen.
Anforderung und Antwort für Geocoding (Suche nach Längen- und Breitengrad)
Im folgenden Beispiel werden die geografische Breite und Länge von „1600 Amphitheatre Parkway, Mountain View, CA“ angefordert und die Ausgabe im JSON-Format angegeben.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Du kannst das testen, indem du die URL in deinen Webbrowser eingibst. Ersetze dabei YOUR_API_KEY durch deinen tatsächlichen API-Schlüssel.
Die Antwort enthält den Längen- und Breitengrad der Adresse.
Weitere Informationen zum Erstellen von URLs für Geocodierungsanfragen, zu verfügbaren Parametern und zur Auswertung der Antwort finden Sie im Entwicklerhandbuch.
Nachfolgend ist ein Beispiel für eine Geocoding-Antwort im JSON-Format aufgeführt:
{ "results" : [ { "address_components" : [ { "long_name" : "1600", "short_name" : "1600", "types" : [ "street_number" ] }, { "long_name" : "Amphitheatre Parkway", "short_name" : "Amphitheatre Pkwy", "types" : [ "route" ] }, { "long_name" : "Mountain View", "short_name" : "Mountain View", "types" : [ "locality", "political" ] }, { "long_name" : "Santa Clara County", "short_name" : "Santa Clara County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "California", "short_name" : "CA", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "94043", "short_name" : "94043", "types" : [ "postal_code" ] } ], "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry" : { "location" : { "lat" : 37.4267861, "lng" : -122.0806032 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 37.4281350802915, "lng" : -122.0792542197085 }, "southwest" : { "lat" : 37.4254371197085, "lng" : -122.0819521802915 } } }, "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE", "plus_code" : { "compound_code" : "CWC8+R3 Mountain View, California, United States", "global_code" : "849VCWC8+R3" }, "types" : [ "street_address" ] } ], "status" : "OK" }
Anforderung und Antwort für umgekehrtes Geocoding (Adresssuche)
Im folgenden Beispiel wird die Adresse angefordert, die einem bestimmten Breiten-/Längengrad in Brooklyn, New York, USA entspricht. Es wird zudem angegeben, dass die Ausgabe im JSON-Format erfolgen muss.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEYSie können das testen, indem Sie die URL in Ihren Webbrowser eingeben. Ersetzen Sie dabei „YOUR_API_KEY“ durch Ihren tatsächlichen API-Schlüssel. Die Antwort enthält eine visuell lesbare Adresse für den Breiten- und Längengrad.
Weitere Informationen zum Erstellen von URLs für Anfragen zur umgekehrten Geocodierung, zu verfügbaren Parametern und zur Auswertung der Antwort finden Sie im Entwicklerhandbuch.
Nachfolgend ist ein Beispiel für eine Antwort für umgekehrtes Geocoding im JSON-Format aufgeführt:
{ "plus_code" : { "compound_code" : "P27Q+MC New York, NY, USA", "global_code" : "87G8P27Q+MC" }, "results" : [ { "address_components" : [ { "long_name" : "279", "short_name" : "279", "types" : [ "street_number" ] }, { "long_name" : "Bedford Avenue", "short_name" : "Bedford Ave", "types" : [ "route" ] }, { "long_name" : "Williamsburg", "short_name" : "Williamsburg", "types" : [ "neighborhood", "political" ] }, { "long_name" : "Brooklyn", "short_name" : "Brooklyn", "types" : [ "political", "sublocality", "sublocality_level_1" ] }, { "long_name" : "Kings County", "short_name" : "Kings County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "New York", "short_name" : "NY", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "11211", "short_name" : "11211", "types" : [ "postal_code" ] } ], "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA", "geometry" : { "location" : { "lat" : 40.7142484, "lng" : -73.9614103 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 40.71559738029149, "lng" : -73.9600613197085 }, "southwest" : { "lat" : 40.71289941970849, "lng" : -73.96275928029151 } } }, "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE", "plus_code" : { "compound_code" : "P27Q+MC Brooklyn, New York, United States", "global_code" : "87G8P27Q+MC" }, "types" : [ "bakery", "cafe", "establishment", "food", "point_of_interest", "store" ] }, ... Additional results truncated in this example[] ... ], "status" : "OK" }
Codierung mit unseren Clientbibliotheken
Clientbibliotheken erleichtern die Entwicklung mit den Google Maps Webservice-APIs, da sie einfache, native Implementierungen gängiger Aufgaben wie Authentifizierung, Drosselung von Anfragen und automatische Wiederholungsversuche bieten. Die Geocoding API ist im Java-, Python-, Go- und Node.js-Client für Google Maps-Dienste verfügbar.
Authentifizierung, Kontingente, Preise und Richtlinien
Authentifizierung
Wenn Sie die Geocoding API verwenden möchten, müssen Sie zuerst die API aktivieren und die entsprechenden Anmeldedaten für die Authentifizierung abrufen. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.
Kontingente und Preise
Auf der Seite Nutzung und Abrechnung finden Sie Details zu den Kontingenten und Preisen, die für die Geocoding API festgelegt sind.
Richtlinien
Die Nutzung der Geocoding API muss den API-Richtlinien entsprechen.
Weitere Informationen
Die Geocoding API bietet noch mehr Möglichkeiten. Weitere Demos, Beispiele, verfügbare Parameter, Statuscodes und Fehlermeldungen sowie weitere Informationen finden Sie im Entwicklerleitfaden für die Geocoding API.
Im Entwicklerleitfaden für die Geocoding API wird der Geocoding API-Webdienst beschrieben. Sie richtet sich an Website- und App-Entwickler, die Geocoding-Daten in Karten verwenden möchten, die von einer der APIs der Google Maps Platform bereitgestellt werden.