Omówienie interfejsu Geocoding API

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Interfejs Geocoding API to usługa, która akceptuje miejsce jako adres, współrzędne geograficzne 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.

Możliwości interfejsu Geocoding API

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

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

Możesz określić, gdzie mają się pojawiać wyniki, i ograniczyć je do konkretnego regionu, hrabstwa lub kodu pocztowego.

Jak działa interfejs Geocoding API

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

  • Geokodowanie: przekształca adresy, np. „1600 Amphitheatre Parkway, Mountain View, CA”, na współrzędne geograficzne lub identyfikatory miejsca. Możesz użyć tych współrzędnych, aby umieścić znaczniki na mapie lub wyśrodkować bądź zmienić położenie 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 sytuacjach, np. podczas dostawy lub odbioru.

Poniższa wersja demonstracyjna korzysta z usługi geokodowania w ramach 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 znajdziesz podsumowanie zasobów dostępnych w interfejsie Geocoding API wraz z danymi zwracanymi przez każdy punkt końcowy.

Zasoby danych Zwrócone dane Format zwrotu
Geokodowanie Zwraca adres, jego komponenty i typy. Więcej informacji znajdziesz w sekcji Wyniki w przewodniku Żądanie i odpowiedź dotyczące geokodowania.
  • JSON
  • XML
Odwrotne geokodowanie Zwraca adres, jego komponenty i typy. Więcej informacji znajdziesz w sekcji Odpowiedzi z odwrotnego geokodowania w przewodniku po żądaniach i odpowiedziach dotyczących odwrotnego geokodowania.
Geokodowanie miejsc Zwraca adres, jego komponenty i typy. Więcej informacji znajdziesz w sekcji Odpowiedzi odwrotnego geokodowania w przewodniku po żądaniach i odpowiedziach geokodowania miejsc.

Jak korzystać z interfejsu Geocoding API

1 Skonfiguruj konto. Zacznij od skonfigurowania projektu Google Cloud i postępuj zgodnie z instrukcjami konfiguracji.
2 Wypróbuj żądanie geokodowania Gdy uzyskasz klucz interfejsu API, możesz zacząć testować Geocoding API bezpośrednio z poziomu narzędzia curl lub przeglądarki. Musisz podać prawidłowe parametry wyszukiwania w przypadku wyszukiwania adresu lub komponentu. Więcej informacji znajdziesz w sekcji Parametry geokodowania.
3 Wyślij prośbę o odwrotne geokodowanie Podaj współrzędne geograficzne (szerokość i długość) wraz z kluczem interfejsu API, aby uzyskać komponenty adresu najbliższego adresu czytelnego dla człowieka w danej lokalizacji. Więcej informacji znajdziesz w sekcji Żądania geokodowania zwrotnego.
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 artykule Odpowiedzi geokodowania.
5 Włącz dane geokodowania do swojej aplikacji! Dane geokodowania możesz wykorzystać do uzyskiwania adresów ze znaczników na mapie lub do umieszczania znaczników na mapie na podstawie znanego adresu.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w wybranym języku za pomocą jednej z tych bibliotek klienta:

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

Co dalej?