Erste Schritte mit der Geocoding API v4

Entwickler im Europäischen Wirtschaftsraum (EWR)

Die Geocoding API v4 ist ein Dienst, der Geocoding, umgekehrte Geocodierung von Adressen und Orts-IDs sowie Zielinformationen bietet.

Beim Geocoding 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 menschenlesbare Adresse umgewandelt.

Sie können die Geocoding API auch verwenden, um die Adresse für eine bestimmte Orts-ID zu ermitteln und mit der Methode SearchDestinations detaillierte Informationen zu verschiedenen Zielen abzurufen.

Beispielanforderung und -antwort

Sie greifen über eine HTTP-Schnittstelle auf die Geocoding API zu. Im Folgenden finden Sie Beispiele für Geocoding- und umgekehrte Geocodierung-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.

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 angefordert, die einem bestimmten Breitengrad/Längengrad in Brooklyn, NY, USA, entspricht. 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_KEY

Sie können dies testen, indem Sie die URL in Ihren Webbrowser eingeben. Achten Sie darauf, dass Sie „YOUR_API_KEY“ durch Ihren tatsächlichen API-Schlüssel ersetzen. Die Antwort enthält eine menschenlesbare Adresse für den Standort mit dem angegebenen Breiten- und Längengrad.

Weitere Informationen zum Erstellen von URLs für Anfragen zur umgekehrten Geocodierung, zu den verfügbaren Parametern und zum Verstehen der Antwort finden Sie im Entwicklerhandbuch.

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.