Omówienie interfejsu Geocoding API

Geocoding API to usługa, która akceptuje miejsce jako adres, współrzędne szerokości i długości geograficznej lub identyfikator miejsca. Konwertuje adres na współrzędne szerokości i długości geograficznej oraz identyfikator miejsca lub konwertuje współrzędne szerokości i długości geograficznej lub identyfikator miejsca w adres.

Dlaczego warto korzystać z interfejsu Geocoding API

Jeśli chcesz korzystać z danych geokodowania na mapach dostarczanych przez jeden z interfejsów Google Maps Platform API, użyj interfejsu Geocoding API na potrzeby witryny lub aplikacji mobilnej. Dzięki interfejsowi Geocoding API możesz używać adresów do umieszczania znaczników na mapie lub konwertować znacznik na mapie na adres. Ta usługa służy do geokodowania wstępnie zdefiniowanych, statycznych adresów na potrzeby umieszczania treści aplikacji na mapie.

Do czego służy interfejs Geocoding API

Za pomocą interfejsu Geocoding API możesz uzyskać dane geokodowania dotyczące jednego lub większej liczby adresów lub miejsc, m.in.:

  • Współrzędne geograficzne adresów.
  • Adresy dla zestawów współrzędnych szerokości i długości geograficznej.
  • Adresy dla identyfikatorów miejsc.

Możesz kontrolować, gdzie będą wyświetlane wyniki, oraz ograniczyć je do konkretnego regionu, hrabstwa lub kodu pocztowego.

Jak działa interfejs Geocoding API

Geocoding API wykonuje zarówno geokodowanie, jak i odwrotne geokodowanie:

  • Geokodowanie: konwertuje adresy, np. „1600 Amphitheatre Parkway, Mountain View, CA” na szerokość i długość geograficzną lub identyfikatory miejsc. Tych współrzędnych można używać do umieszczania znaczników na mapie oraz wyśrodkowania lub zmiany położenia mapy w ramce widoku.
  • Odwrotne geokodowanie: konwertuje współrzędne szerokości i długości geograficznej lub identyfikator miejsca na adres czytelny dla człowieka. Możesz używać adresów w różnych sytuacjach, m.in. w przypadku dostaw lub odbioru.

W poniższej prezentacji wykorzystano usługę Geocoding za pomocą interfejsu Maps JavaScript API, aby zademonstrować sposób działania interfejsu Geocoding API. Otwórz mapę w osobnej karcie, aby zobaczyć więcej opcji i szczegółów.

Zasoby

Poniższa tabela zawiera podsumowanie zasobów dostępnych przez Geocoding API oraz dane zwracane przez każdy punkt końcowy.

Zasoby danych Zwrócone dane Format zwrotu
Geokodowanie Zwraca adres, komponenty adresu i typy adresów. Zapoznaj się z sekcją Wyniki w przewodniku Żądanie i odpowiedzi na potrzeby geokodowania.
  • JSON
  • XML
Odwrotne geokodowanie Zwraca adres, komponenty adresu i typy adresów. Zapoznaj się z sekcją Odwrotne odpowiedzi geokodowania w przewodniku Odwrotne żądania i odpowiedzi geokodujące.
Geokodowanie miejsc Zwraca adres, komponenty adresu i typy adresów. Zapoznaj się z sekcją Odwrotne odpowiedzi geokodowania w przewodniku Umieszczanie żądań i odpowiedzi na potrzeby geokodowania.

Jak korzystać z interfejsu Geocoding API

1 Rozpocznij konfigurację. Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji.
2 Wypróbuj żądanie geokodowania Po uzyskaniu klucza interfejsu API możesz rozpocząć testowanie interfejsu Geocoding API bezpośrednio z poziomu cURL lub przeglądarki. Musisz podać prawidłowe parametry wyszukiwania adresów lub komponentów. Więcej informacji znajdziesz w sekcji Parametry geokodowania.
3 Spróbuj użyć odwrotnego żądania geokodowania Podaj współrzędne szerokości i długości geograficznej wraz z kluczem interfejsu API, aby uzyskać komponenty adresu najbliższego zrozumiałego dla człowieka adresu w tej lokalizacji. Więcej informacji znajdziesz w artykule Odwrotne żądania geokodowania.
4 Podstawowe informacje o odpowiedziach Wszystkie punkty końcowe w interfejsie Geocoding API zwracają te same dane w formacie JSON lub XML. Wyjaśnienie danych, kodów stanu i komunikatów o błędach znajdziesz w sekcji Odpowiedzi geokodowania.
5 Wykorzystaj dane geokodowania we własnej aplikacji. Możesz używać danych geokodowania, by uzyskiwać adresy ze znaczników mapy oraz dodawać znaczniki na mapie na podstawie znanego adresu.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w wybranym języku, używając jednej z tych bibliotek klienta:

Klient Java, klient Python, klient Go i klient Node.js dla usług Map Google to obsługiwane przez społeczność biblioteki klienta udostępniane na zasadach open source licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej