Geocoding API w wersji 4 to usługa, która umożliwia geokodowanie, odwrotne geokodowanie adresów i identyfikatorów miejsc oraz uzyskiwanie informacji o miejscach docelowych.
Geokodowanie to proces przekształcania adresów (np. adresu ulicy) w 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 konwertowania współrzędnych geograficznych na adres zrozumiały 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 zapytań o geokodowanie i odwrotne geokodowanie.
Żądanie i odpowiedź geokodowania (wyszukiwanie szerokości i długości geograficznej)
W przykładzie poniżej wysyłamy prośbę o podanie szerokości i długości geograficznej dla adresu „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 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ź dotyczące 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_KEYMożesz to sprawdzić, wpisując adres URL w przeglądarce (pamiętaj, aby zastąpić „YOUR_API_KEY” prawdziwym kluczem interfejsu API). Odpowiedź zawiera adres zrozumiały dla człowieka dla lokalizacji o podanej szerokości i długości geograficznej.
Więcej informacji o tworzeniu adresów URL z prośbą o odwrotne geokodowanie, 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 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.