Geocoding API to usługa, która umożliwia geokodowanie i odwrotne geokodowanie adresów.
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 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.
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 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.
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 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 deweloperów.
Poniżej znajdziesz przykładową 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" }
Żą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://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEYMożesz to sprawdzić, wpisując adres URL w przeglądarce (pamiętaj, aby zastąpić ciąg „YOUR_API_KEY” swoim 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:
{ "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ć, korzystając z naszych bibliotek klienta
Biblioteki klienta ułatwiają tworzenie aplikacji z wykorzystaniem interfejsów API usług internetowych Map Google, ponieważ zawierają wbudowane implementacje typowych zadań, takich jak uwierzytelnianie, ograniczanie liczby żądań i automatyczne ponawianie prób. Interfejs Geocoding API jest dostępny w klientach Java, Python, Go i 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 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.
Więcej informacji
Interfejs Geocoding API oferuje więcej możliwości. Dodatkowe wersje demonstracyjne, przykłady, dostępne parametry, kody stanu i komunikaty o błędach oraz inne szczegóły znajdziesz w przewodniku dla programistów dotyczącym interfejsu Geocoding API.
Przewodnik dla programistów korzystających z interfejsu Geocoding API zawiera opis usługi sieciowej Geocoding API. Jest on przeznaczony dla programistów stron internetowych i aplikacji mobilnych, którzy chcą używać danych geokodowania na mapach udostępnianych przez interfejsy API Google Maps Platform.