Omówienie interfejsu Geocoding API

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

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 albo identyfikator miejsca na adres.

Co możesz zrobić za pomocą Geocoding API

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

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

Możesz kontrolować, gdzie pojawiają się wyniki, i ograniczyć je do określonego regionu, kraju lub kodu pocztowego.

Jak działa Geocoding API

Geocoding API umożliwia zarówno geokodowanie, jak i odwrotne geokodowanie:

  • Geocoding: konwertuje adresy, takie jak „1600 Amphitheatre Parkway, Mountain View, CA”, na współrzędne geograficzne lub identyfikatory miejsc. Możesz użyć tych współrzędnych, aby umieścić znaczniki na mapie lub wyśrodkować albo zmienić położenie mapy w ramce widoku.
  • Odwrotne geokodowanie: konwertuje współrzędne szerokości i długości geograficznej lub identyfikator miejsca na adres zrozumiały dla człowieka. Adresów możesz używać w różnych sytuacjach, np. podczas dostaw lub odbiorów.

Poniższa wersja demonstracyjna wykorzystuje usługę geokodowania 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

Tabela poniżej zawiera podsumowanie zasobów dostępnych w Geocoding API oraz dane zwracane przez poszczególne metody.

Zasoby danych Zwrócone dane Format zwrotu
Geokodowanie Zwraca adres, komponenty adresu i typy adresów. Zobacz Wyniki w przewodniku Żądanie i odpowiedź geokodowania.
  • JSON
  • XML
Odwrotne geokodowanie Zwraca adres, komponenty adresu i typy adresów. Zobacz Odpowiedzi odwrotnego geokodowania w przewodniku po żądaniach i odpowiedziach odwrotnego geokodowania.
Geokodowanie miejsc Zwraca adres, komponenty adresu i typy adresów. Zobacz Odpowiedzi na żądania odwrotnego geokodowania w przewodniku po żądaniach i odpowiedziach dotyczących geokodowania miejsc.

Jak korzystać z interfejsu Geocoding API

1 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i postępuj zgodnie z instrukcjami konfiguracji.
2 Wypróbuj żądanie geokodowania Gdy masz już klucz interfejsu API, możesz zacząć testować Geocoding API bezpośrednio z poziomu curl lub przeglądarki. Musisz podać prawidłowe parametry wyszukiwania adresów lub komponentów. Szczegółowe informacje znajdziesz w sekcji Parametry geokodowania.
3 Przykładowe żądanie odwrotnego geokodowania Podaj współrzędne szerokości i długości geograficznej wraz z kluczem interfejsu API, aby uzyskać komponenty adresu dla najbliższego adresu zrozumiałego dla człowieka dla tej lokalizacji. Szczegółowe informacje znajdziesz w sekcji Żądania odwrotnego geokodowania.
4 Podstawowe informacje o odpowiedziach Wszystkie metody 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 artykule Odpowiedzi geokodowania.
5 Uwzględnij dane geokodowania we własnej aplikacji. Możesz używać danych geokodowania, aby uzyskiwać adresy ze znaczników na mapie lub umieszczać znaczniki na mapie na podstawie znanego adresu.

Dostępne biblioteki klienta

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

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

Co dalej?