Omówienie interfejsu Geocoding API

Geokodowanie API to usługa, która akceptuje miejsce jako adres, szerokość i długość geograficzną lub identyfikator miejsca. Ta funkcja konwertuje adres na współrzędne geograficzne i identyfikator miejsca albo konwertuje je na adres lub współrzędne.

Dlaczego warto korzystać z interfejsu Geocode API

Jeśli chcesz używać danych geokodowania w mapach dostarczanych przez jeden z interfejsów Google Maps Platform API, możesz użyć interfejsu Geocoding API dla witryny lub aplikacji mobilnej. W przypadku Geocode API możesz używać adresów do umieszczania znaczników na mapie lub konwertowania znacznika na mapę na adres. Ta usługa służy do geokodowania wstępnie zdefiniowanych, statycznych adresów przeznaczonych do umieszczania treści aplikacji na mapie.

Co można zrobić za pomocą interfejsu Geocode API

Za pomocą interfejsu Geocoding API możesz uzyskać dane geokodowania dla co najmniej 1 adresu lub miejsca, w tym:

  • współrzędne geograficzne adresów;
  • Adresy dla współrzędnych szerokości i długości geograficznej.
  • Adresy dotyczące identyfikatorów miejsc.

Możesz określić, gdzie mają pojawiać się wyniki, oraz wyświetlać je w określonym regionie, hrabstwie lub kodzie pocztowym.

Jak działa interfejs Geocoding API

Geokodowanie API obsługuje geokodowanie i odwrotne geokodowanie:

  • Geokodowanie: przekształca adresy, takie jak „1600 Amphitheatre Parkway, Mountain View, CA”, na współrzędne geograficzne. Możesz używać tych współrzędnych do umieszczania znaczników na mapie, do wyśrodkowania lub zmiany pozycji mapy w ramce widoku.
  • Odwrotne geokodowanie: konwertuje współrzędne geograficzne lub identyfikator miejsca na adres czytelny dla człowieka. Adresów możesz używać w różnych scenariuszach, takich jak dostawy lub odbioru.

Poniższa prezentacja wykorzystuje usługę Geocoding Service za pomocą interfejsu Maps JavaScript API, aby pokazać, jak działa interfejs Geocoding API. Otwórz mapę w osobnej karcie, aby zobaczyć więcej opcji i szczegółów.

Zasoby

W tabeli poniżej podano zasoby dostępne w interfejsie Geocoding API wraz z danymi zwracanymi przez każdy punkt końcowy.

Zasoby danych Zwrócone dane Format zwrotu
Geokodowanie Zwraca adres, komponenty i typy adresów. Przeczytaj artykuł Wyniki w przewodniku po pytaniach i odpowiedziach geograficznych.
  • JSON
  • XML
Odwrotne geokodowanie Zwraca adres, komponenty i typy adresów. Zapoznaj się z sekcją Odwrotne odpowiedzi geokodowania w przewodniku dotyczącym odwrotnego żądania geokodowania i odpowiedzi.
Geokodowanie miejsc Zwraca adres, komponenty i typy adresów. Zapoznaj się z sekcją Odwrotne odpowiedzi związane z kodowaniem geograficznym w przewodniku Umieszczanie żądań geokodowania i odpowiedzi.

Jak korzystać z interfejsu Geocode API

1 Skonfiguruj Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z instrukcjami konfiguracji.
2 Spróbuj wysłać żądanie geokodowania Gdy będziesz już mieć klucz interfejsu API, możesz zacząć go testować bezpośrednio w cURL lub w przeglądarce. Konieczne jest podanie prawidłowych parametrów wyszukiwania adresu lub komponentu. Szczegóły znajdziesz w sekcji Parametry geokodowania.
3 Wypróbuj odwrotne żądanie geokodowania Podaj szerokość i długość geograficzną wraz z kluczem interfejsu API, aby uzyskać komponenty adresu najbliżej najbliższego, czytelnego dla człowieka adresu. Więcej informacji znajdziesz w sekcji 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 Włącz dane geokodowania do własnej aplikacji. Danych geokodowania możesz używać do pobierania adresów ze znaczników mapy lub do podawania znaczników na mapie na podstawie znanego adresu.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w wybranym przez siebie języku za pomocą jednej z tych bibliotek klientów:

Java Client, Python Client, Go Client i Node.js Client for Mapy Google to obsługiwane przez społeczność biblioteki klienta utworzone na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz również instrukcje instalacji i przykładowy kod.

Co dalej?