Metody Geocoding API w wersji 4 mają domyślny limit 25 zapytań na sekundę. Informacje o tym, jak poprosić o zwiększenie limitu, znajdziesz w artykule Wyświetlanie limitów i zarządzanie nimi. Jako usługę wybierz Geocoding API.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Pierwsze kroki z interfejsem Geocoding API w wersji 4

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Geocoding API w wersji 4 udostępnia 2 główne grupy funkcji: wyszukiwanie miejsc docelowych z uwzględnieniem rozbudowanych atrybutów hiperlokalnych oraz podstawowe geokodowanie (konwersja współrzędnych na adres). Nie wiesz, którą metodę wybrać? Zobacz Wybieranie metody geokodowania.

Search for destinations (SearchDestinations): pobiera szczegółowe informacje o miejscu docelowym, w tym wejścia do budynków, punkty nawigacyjne, kontury budynków i terenów, miejsca docelowe i pobliskie punkty orientacyjne.
Geocoding (GeocodeAddress): konwertuje adresy ulic na współrzędne szerokości i długości geograficznej, aby umieścić podstawowe znaczniki lub wyśrodkować mapę.
Odwrotne geokodowanie (GeocodeLocation): konwertuje współrzędne geograficzne na adres ulicy zrozumiały dla człowieka.
Geokodowanie miejsca (GeocodePlace): znajduje sformatowany adres i współrzędne dla znanego identyfikatora miejsca.

Przykładowe żądania i odpowiedzi

Dostęp do interfejsu Geocoding API można uzyskać przez interfejs HTTP. Poniżej znajdziesz przykłady szybkiego rozpoczęcia korzystania z funkcji Wyszukiwanie miejsc docelowych, geokodowanie bezpośrednie i odwrotne geokodowanie.

Żądanie i odpowiedź dotyczące wyszukiwania miejsc docelowych (hiperlokalne dane o przyjazdach)

W tym przykładzie wysyłane jest żądanie HTTP POST do SearchDestinations dla adresu „1600 Amphitheatre Parkway, Mountain View, CA”. Pamiętaj, że SearchDestinations wymaga nagłówka X-Goog-FieldMask określającego pola do zwrócenia:

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"

Poniżej znajdziesz przykładową odpowiedź SearchDestinations, która zawiera wielokąt obrysu budynku, preferowane wejścia, punkty nawigacyjne, do których można wyznaczyć trasę, i pobliskie punkty orientacyjne:

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

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

Poniższy przykład żąda szerokości i długości geograficznej adresu „1600 Amphitheatre Parkway, Mountain View, CA” i określa, że dane wyjściowe muszą 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 przetestować, wpisując adres URL w przeglądarce (pamiętaj, aby zastąpić YOUR_API_KEY rzeczywistym 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 programistó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)

Ten przykład żąda adresu odpowiadającego danej szerokości i długości geograficznej na Brooklynie w Nowym Jorku 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” rzeczywistym kluczem interfejsu API). Odpowiedź zawiera zrozumiały dla człowieka adres odpowiadający szerokości i długości geograficznej.

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

Poniżej znajdziesz przykładową odpowiedź 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 go włączyć i uzyskać odpowiednie dane uwierzytelniające. 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.