Geocoding API to usługa, która umożliwia geokodowanie i odwrotne geokodowanie adresów.
Geokodowanie to proces konwertowania adresów (np. adresu ulicznego) na współrzędne geograficzne (np. szerokość i długość geograficzną), których można używać do umieszczania znaczników na mapie lub do pozycjonowania mapy.
Odwrotne geokodowanie to proces konwertowania współrzędnych geograficznych na adres zrozumiały dla człowieka.
Za pomocą interfejsu Geocoding API możesz też znaleźć adres podany w identyfikatorze miejsca.
Przykładowe żądanie i odpowiedź
Dostęp do Geocoding API uzyskujesz przez interfejs HTTP. Oto przykłady żądań geokodowania i odwrotnego geokodowania.
Żądanie i odpowiedź geokodowania (wyszukiwanie współrzędnych geograficznych)
W tym przykładzie żądamy współrzędnych geograficznych „1600 Amphitheatre Parkway, Mountain View, CA” i określamy, że dane wyjściowe muszą być w formacie JSON.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Możesz to przetestować, 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.
Aby dowiedzieć się więcej o tworzeniu adresów URL żądań geokodowania i dostępnych parametrach oraz interpretowaniu odpowiedzi, zapoznaj się z przewodnikiem dla deweloperów.
Poniżej znajduje się przykładowa odpowiedź geokodowania w formacie JSON:
{ "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" }
Zapytanie i odpowiedź dotyczące odwrotnego geokodowania (wyszukiwanie adresu)
W tym przykładzie żądamy adresu odpowiadającego podanym współrzędnym geograficznym w Brooklynie w stanie Nowy Jork w Stanach Zjednoczonych. Określa on, że dane wyjściowe muszą być w formacie JSON.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEYAby to sprawdzić, wpisz adres URL w przeglądarce (pamiętaj, aby zastąpić ciąg „YOUR_API_KEY” swoim kluczem API). Odpowiedź zawiera adres zrozumiały dla człowieka, który zawiera szerokość i długość geograficzną.
Aby dowiedzieć się więcej o tworzeniu adresów URL żądań odwrotnego geokodowania i dostępnych parametrach oraz interpretowaniu odpowiedzi, zapoznaj się z przewodnikiem dla programistów.
Poniżej znajduje się przykład odpowiedzi z odwrotnego geokodowania w formacie JSON:
{ "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" }
Zacznij kodować z naszych bibliotek klienta
Biblioteki klienta ułatwiają tworzenie aplikacji korzystających z interfejsów API usługi internetowej Map Google dzięki prostej, natywnej implementacji typowych zadań, takich jak uwierzytelnianie, ograniczanie liczby żądań i automatyczne ponowne próby. Interfejs Geocoding API jest dostępny w kliencie Java, kliencie Python, kliencie Go i kliencie Node.js dla usług Map Google.
Uwierzytelnianie, limity, ceny i zasady
Uwierzytelnianie
Aby korzystać z interfejsu Geocoding API, musisz najpierw go włączyć 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 interfejsu API.
Więcej informacji
Za pomocą Geocoding API możesz robić jeszcze więcej. Więcej demonstracji, przykładów, dostępnych parametrów, kodów stanu i komunikatów o błędach oraz innych informacji znajdziesz w przewodniku Geocoding API dla deweloperów.
Przewodnik dla programistów Geocoding API opisuje usługę internetową Geocoding API. Jest on przeznaczony dla programistów stron internetowych i aplikacji mobilnych, którzy chcą używać danych geokodowania w mapach udostępnianych przez jeden z interfejsów API Google Maps Platform.