Erste Schritte

Die Geocoding API ist ein Dienst, der Geocoding und umgekehrte Geocodierung ermöglicht. von Adressen.

<ph type="x-smartling-placeholder">

Geocoding ist der Vorgang zum Konvertieren von Adressen, z. B. einer Adresse. in geografische Koordinaten wie Längen- und Breitengrade umwandeln, mit denen Sie Markierungen setzen können. auf der Karte platzieren oder die Karte positionieren.

Bei der umgekehrten Geocodierung werden geografische Koordinaten konvertiert. in eine visuell lesbare Adresse umwandeln.

Sie können auch die Geocoding API verwenden, um die Adresse einer mit einer Orts-ID angegeben.

Beispielanforderung und -antwort

Der Zugriff auf die Geocoding API erfolgt über eine HTTP-Schnittstelle. Folge ich sind Beispiele für Geocoding- und umgekehrte Geocodierung-Anfragen.

Anforderung und Antwort für Geocoding (Suche nach Längen- und Breitengrad)

Im folgenden Beispiel wird der Breiten- und Längengrad von „1600 Amphitheatre Parkway, Mountain View, CA" angezeigt. Außerdem 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.

Entwicklerleitfaden ansehen finden Sie weitere Informationen <ph type="x-smartling-placeholder"></ph> Erstellung von URLs für Geocoding-Anfragen und verfügbare Parameter und Antwort zu verstehen.

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 entspricht in Brooklyn, New York, USA. 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 visuell lesbare Adresse für den Breiten- und Längengrad. Standort.

Entwicklerleitfaden ansehen finden Sie weitere Informationen <ph type="x-smartling-placeholder"></ph> Erstellung von URLs für Anfragen zum umgekehrten Geocoding und verfügbare Parameter und Antwort zu verstehen.

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 die Entwicklung mit den Google Maps Web Service APIs durch die Bereitstellung einfacher, native Implementierungen gängiger Aufgaben wie Authentifizierung, Drosselung und automatische Wiederholungsversuche. Die Geocoding API ist verfügbar in der Java-Client Python-, Go- und Node.js-Client für Google Maps-Dienste.

Authentifizierung, Kontingente, Preise und Richtlinien

Authentifizierung

Damit Sie die Geocoding API verwenden können, müssen Sie zuerst die API aktivieren und rufen Sie die richtigen Anmeldedaten für die Authentifizierung ab. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform

Kontingente und Preise

Informieren Sie sich über die Nutzung und Abrechnung finden Sie Details zu Kontingenten und Preisen für die Geocoding API.

Richtlinien

Die Nutzung der Geocoding API muss den API-Richtlinien:

Weitere Informationen

Die Geocoding API bietet Ihnen noch mehr Möglichkeiten. Weitere Informationen finden Sie in der <ph type="x-smartling-placeholder"></ph> Entwicklerleitfaden für die Geocoding API finden Sie weitere Demos. Beispiele, verfügbare Parameter, Statuscodes und Fehlermeldungen und andere Details.

Die <ph type="x-smartling-placeholder"></ph> Im Entwicklerleitfaden für die Geocoding API wird die Geocoding API-Webdienst. Es richtet sich an Entwickler von Websites und mobilen Apps. die Geocoding-Daten in Karten verwenden möchten, die von einem der Google Maps Platform- APIs