Pierwsze kroki z interfejsem Geocoding API w wersji 4

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Geocoding API w wersji 4 to usługa, która umożliwia geokodowanie i odwrotne geokodowanie adresów oraz identyfikatorów miejsc, a także udostępnia informacje o miejscach docelowych.

Geokodowanie to proces przekształcania adresów (np. adresu ulicy) na współrzędne geograficzne (np. szerokość i długość geograficzną), których możesz używać do umieszczania znaczników na mapie lub pozycjonowania mapy.

Odwrotne geokodowanie to proces przekształcania współrzędnych geograficznych na adres czytelny dla człowieka.

Możesz też użyć interfejsu Geocoding API, aby znaleźć adres dla danego identyfikatora miejsca i pobrać szczegółowe informacje o różnych miejscach docelowych za pomocą metody SearchDestinations.

Przykładowe żądanie i odpowiedź

Dostęp do Geocoding API uzyskujesz za pomocą interfejsu HTTP. Poniżej znajdziesz przykłady żądań geokodowania i odwrotnego geokodowania.

Żądanie i odpowiedź geokodowania (wyszukiwanie szerokości i długości geograficznej)

W tym przykładzie wysyłamy prośbę o podanie szerokości i długości geograficznej lokalizacji „1600 Amphitheatre Parkway, Mountain View, CA” oraz określamy, że dane wyjściowe mają być w formacie JSON.

curl -H "X-Goog-Api-Key: YOUR_API_KEY" \
"https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"

Możesz to sprawdzić, wpisując adres URL w przeglądarce (pamiętaj, aby zastąpić YOUR_API_KEY prawdziwym kluczem interfejsu API). Odpowiedź zawiera szerokość i długość geograficzną adresu.

Więcej informacji o  tworzeniu adresów URL żądań geokodowania, dostępnych parametrach i  interpretowaniu odpowiedzi znajdziesz w przewodniku dla deweloperów.

Poniżej znajdziesz przykładową odpowiedź geokodowania w formacie JSON:

{
  "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"
      ]
    }
  ]
}

Żądanie i odpowiedź odwrotnego geokodowania (wyszukiwanie adresu)

W tym przykładzie wysyłamy żądanie adresu odpowiadającego danym współrzędnym geograficznym w Brooklynie w stanie Nowy Jork w USA. Określa, że dane wyjściowe muszą być w formacie JSON.

https://geocode.googleapis.com/v4/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEY

Możesz to sprawdzić, wpisując adres URL w przeglądarce (pamiętaj, aby zastąpić „YOUR_API_KEY” swoim kluczem API). Odpowiedź zawiera adres w formacie zrozumiałym dla człowieka, który odpowiada lokalizacji określonej przez szerokość i długość geograficzną.

Więcej informacji o  tworzeniu adresów URL żądań odwrotnego geokodowania, dostępnych parametrach i  interpretowaniu odpowiedzi znajdziesz w przewodniku dla deweloperów.

Poniżej znajdziesz przykładową odpowiedź dotyczącą odwrotnego geokodowania w formacie JSON:

{
  "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[] ...
}

Uwierzytelnianie, limity, ceny i zasady

Uwierzytelnianie

Aby korzystać z interfejsu Geocoding API, musisz najpierw włączyć go i uzyskać odpowiednie dane logowania. Więcej informacji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.

Limity i ceny

Szczegółowe informacje o limitach i cenach interfejsu Geocoding API znajdziesz na stronie korzystanie i rozliczenia.

Zasady

Korzystanie z interfejsu Geocoding API musi być zgodne z zasadami dotyczącymi interfejsów API.