Die Geocoding API v4 bietet zwei Hauptfunktionen: die Zielsuche nach umfassenden hyperlokalen Attributen und die einfache Geocodierung (Umwandlung von Koordinaten in Adressen). Sie sind sich nicht sicher, welche Methode Sie verwenden sollen? Weitere Informationen finden Sie unter Geocoding-Methode auswählen.
- Nach Zielen suchen (
SearchDestinations): Ruft detaillierte Informationen zur Ankunft an einem Ziel ab, einschließlich Gebäudeeingängen, routingfähigen Navigationspunkten, Gebäude-/Geländeumrissen, Unterzielen und Sehenswürdigkeiten in der Nähe. - Geocoding (
GeocodeAddress): Wandelt Adressen in Breiten- und Längengradkoordinaten um, um einfache Markierungen zu platzieren oder eine Karte zu zentrieren. - Umgekehrte Geocodierung (
GeocodeLocation): Wandelt geografische Koordinaten in eine menschenlesbare Adresse um. - Geocoding für Orte (
GeocodePlace): Ermittelt die formatierte Adresse und die Koordinaten für eine bekannte Orts-ID.
Beispielanfragen und -antworten
Der Zugriff auf die Geocoding API erfolgt über eine HTTP-Schnittstelle. Unten finden Sie Kurzanleitungsbeispiele für die Suche nach Zielen, das Geocoding und die umgekehrte Geocodierung.
Anfrage und Antwort für die Suche nach Zielen (hyperlokale Ankunftsdaten)
Im folgenden Beispiel wird eine HTTP-POST-Anfrage an SearchDestinations für „1600 Amphitheatre Parkway, Mountain View, CA“ gesendet. Beachten Sie, dass für SearchDestinations ein X-Goog-FieldMask-Header erforderlich ist, in dem die zurückzugebenden Felder angegeben sind:
curl -X POST -d '{ "addressQuery": { "addressQuery": "1600 Amphitheatre Parkway, Mountain View, CA" } }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-FieldMask: destinations.primary.displayName,destinations.primary.formattedAddress,destinations.primary.location,destinations.primary.displayPolygon,destinations.entrances,destinations.navigationPoints,destinations.landmarks' \ -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4/geocode/destinations"
Unten sehen Sie ein Beispiel für eine SearchDestinations-Antwort mit dem Polygon des Gebäudegrundrisses, bevorzugten Eingängen, routingfähigen Navigationspunkten und Sehenswürdigkeiten in der Nähe:
{ "destinations": [ { "primary": { "displayName": { "text": "Googleplex", "languageCode": "en" }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "location": { "latitude": 37.4220656, "longitude": -122.0840897 }, "displayPolygon": { "type": "Polygon", "coordinates": [ [ [-122.084958, 37.422145], [-122.084112, 37.422610], [-122.083510, 37.421980], [-122.084958, 37.422145] ] ] } }, "entrances": [ { "location": { "latitude": 37.422189, "longitude": -122.084215 }, "tags": ["PREFERRED"] } ], "navigationPoints": [ { "navigationPointToken": "Eg...", "displayName": { "text": "Amphitheatre Pkwy Dropoff", "languageCode": "en" }, "location": { "latitude": 37.421912, "longitude": -122.084301 }, "travelModes": ["DRIVE"], "usages": ["DROPOFF", "PICKUP"] } ], "landmarks": [ { "place": { "displayName": { "text": "Charleston Park", "languageCode": "en" } }, "relationalDescription": { "text": "Adjacent to Charleston Park", "languageCode": "en" }, "straightLineDistanceMeters": 85.4 } ] } ] }
Anforderung und Antwort für Geocoding (Suche nach Längen- und Breitengrad)
Im folgenden Beispiel werden die Breiten- und Längengrade für „1600 Amphitheatre Parkway, Mountain View, CA“ angefordert und es wird angegeben, dass die Ausgabe im JSON-Format erfolgen muss.
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
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, zu den verfügbaren Parametern und zum Verstehen der Antwort finden Sie im Entwicklerhandbuch.
Nachfolgend ist ein Beispiel für eine Geocoding-Antwort im JSON-Format aufgeführt:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
Anforderung und Antwort für umgekehrtes Geocoding (Adresssuche)
Im folgenden Beispiel wird die Adresse für einen bestimmten Breiten- und Längengrad in Brooklyn, NY, USA, angefordert. Es wird zudem angegeben, dass die Ausgabe im JSON-Format erfolgen muss.
https://geocode.googleapis.com/v4/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYSie 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 Standort mit den angegebenen Breiten- und Längengraden.
Im Entwicklerhandbuch finden Sie weitere Informationen zum Erstellen von Anfrage-URLs für die umgekehrte Geocodierung, zu den verfügbaren Parametern und zum Verstehen der Antwort.
Nachfolgend ist ein Beispiel für eine Antwort für umgekehrtes Geocoding im JSON-Format aufgeführt:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
Authentifizierung, Kontingente, Preise und Richtlinien
Authentifizierung
Wenn Sie die Geocoding API verwenden möchten, müssen Sie sie zuerst aktivieren und die entsprechenden Authentifizierungsdaten 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 für die Geocoding API.
Richtlinien
Die Nutzung der Geocoding API muss den API-Richtlinien entsprechen.