Die Geocoding API ist ein Dienst, der das Geocoding und die umgekehrte Geocodierung von Adressen ermöglicht.
Bei der Geocodierung werden Adressen (z. B. eine Adresse) in geografische Koordinaten (z. B. Breiten- und Längengrad) umgewandelt, mit denen Sie Markierungen auf einer Karte platzieren oder die Karte positionieren können.
Bei der umgekehrten Geocodierung werden geografische Koordinaten in eine Adresse in lesbarer Form umgewandelt.
Sie können auch die Geocoding API verwenden, um die Adresse für eine bestimmte Orts-ID zu ermitteln.
Beispielanforderung und -antwort
Der Zugriff auf das Geocoding API erfolgt über eine HTTP-Schnittstelle. 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 der Breiten- und Längengrad von „1600 Amphitheatre Parkway, Mountain View, CA“ angefordert und es wird angegeben, dass die Ausgabe im JSON-Format erfolgen muss.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Sie können dies 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 den Längen- und Breitengrad der Adresse.
Weitere Informationen zum Erstellen von Geocoding-Anfrage-URLs und verfügbaren Parametern sowie zur Erläuterung 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- und Längengrad in Brooklyn, NY, 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_KEY
Sie können dies 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 menschenlesbare Adresse für den Breiten- und Längengrad.
Weitere Informationen zum Erstellen von Anfrage-URLs für umgekehrtes Geocoding und zu verfügbaren Parametern sowie zur Erläuterung 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 Web Service APIs und ermöglichen einfache, native Implementierungen häufiger Aufgaben wie Authentifizierung, Anfragedrosselung und automatische Wiederholungsversuche. Die Geocoding API ist als Java-Client, Python-Client, Go-Client 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 erforderlichen Anmeldedaten zur Authentifizierung abrufen. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.
Kontingente und Preise
Weitere Informationen zu Kontingenten und Preisen für die Geocoding API finden Sie auf der Seite Nutzung und Abrechnung.
Richtlinien
Die Nutzung der Geocoding API muss den API-Richtlinien entsprechen.
Weitere Informationen
Die Geocoding API bietet Ihnen noch mehr Möglichkeiten. Im Entwicklerleitfaden für die Geocoding API finden Sie weitere Demos, Beispiele, verfügbare Parameter, Statuscodes und Fehlermeldungen sowie andere Details.
Im Entwicklerleitfaden für die Geocoding API wird der Webdienst der Geocoding API beschrieben. Sie richtet sich an Entwickler von Websites und mobilen Anwendungen, die Geocoding-Daten in Karten verwenden möchten, die über eine der Google Maps Platform APIs bereitgestellt werden.