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 współrzędne szerokości i długości geograficznej albo identyfikator miejsca na adres.
Co możesz zrobić za pomocą interfejsu Geocoding API
Za pomocą interfejsu Geocoding API możesz uzyskać dane geokodowania dotyczące co najmniej 1 adresu lub miejsca, w tym:
Ta wersja interfejsu Geocoding API w wersji 4 obejmuje te punkty końcowe:
- Geokodowanie adresu – współrzędne geograficzne adresów. Nazywa się to też geokodowaniem bezpośrednim.
- Geokodowanie lokalizacji – adresy dla zestawów współrzędnych szerokości i długości geograficznej. Nazywa się to również odwrotnym geokodowaniem.
- Geokodowanie miejsca – pobieranie adresu na podstawie identyfikatora miejsca.
- Wyszukiwanie miejsc docelowych – wyszukaj miejsce docelowe na podstawie adresu, identyfikatora miejsca lub lokalizacji.
Możesz kontrolować, gdzie pojawiają się wyniki, i ograniczyć je do określonego regionu, kraju lub kodu pocztowego.
Wypróbuj wersję demonstracyjną
Jak działa Geocoding API
Geocoding API wykonuje zarówno geokodowanie, jak i odwrotne geokodowanie:
- Geokodowanie: konwertuje adresy, takie jak „1600 Amphitheatre Parkway, Mountain View, CA”, na współrzędne szerokości i długości geograficznej lub identyfikatory miejsc. Możesz użyć tych współrzędnych, aby umieścić znaczniki na mapie lub wyśrodkować mapę albo zmienić jej położenie 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. przy dostawach lub odbiorach.
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. Zapoznaj się z dokumentacją dotyczącą odpowiedzi geokodowania. |
|
| Odwrotne geokodowanie | Zwraca adres, komponenty adresu i typy adresów. Zapoznaj się z dokumentacją dotyczącą odpowiedzi na odwrotne geokodowanie. | |
| Geokodowanie miejsc | Zwraca adres, komponenty adresu i typy adresów. Zapoznaj się z dokumentacją dotyczącą odpowiedzi na geokodowanie miejsca. | |
| Wyszukiwanie miejsca docelowego | Zwraca szczegółowe informacje o różnych miejscach docelowych na podstawie różnych kryteriów wejściowych, takich jak adres, identyfikator miejsca lub współrzędne szerokości i długości geograficznej. Zapoznaj się z dokumentacją dotyczącą wyszukiwania miejsc docelowych. |
Kanały etapu uruchamiania
Wersja 4 interfejsu Geocoding API ma osobne kanały dla funkcji GA, wersji testowej i funkcji eksperymentalnych. Jeśli chcesz korzystać z funkcji w wersji testowej lub eksperymentalnej, pamiętaj, aby w żądaniu podać prawidłowy kanał. Aby na przykład uzyskać dostęp do funkcji punktu końcowego Destinations w wersji eksperymentalnej, użyj tego żądania HTTP: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| Etap uruchamiania | Nazwa kanału |
|---|---|
| BS | /v4/ |
| Podgląd | /v4beta/ |
| Wersja eksperymentalna | /v4alpha/ |
- Listę i opis wszystkich dostępnych zasobów REST znajdziesz w dokumentacji REST.
- Więcej informacji o poszczególnych etapach znajdziesz w sekcji Etapy uruchamiania.
Funkcje w Geocoding API w wersji 4
Wersja 4 interfejsu Geocoding API oferuje te nowe funkcje.
Metoda wyszukiwania miejsca docelowego
W wersji 4 wprowadziliśmy metodę wyszukiwania miejsca docelowego, która umożliwia pobieranie szczegółowych informacji o różnych miejscach docelowych na podstawie różnych kryteriów wejściowych, takich jak adres, identyfikator miejsca lub współrzędne geograficzne. Odpowiedź zawiera podsumowania wygenerowane przez AI i tokeny punktów nawigacyjnych, które zawierają informacje kontekstowe, które można przekazać do pakietu Navigation SDK w celu precyzyjnego wyznaczania trasy.
Wdrożone na standardowej platformie Google Cloud
Interfejs Geocoding API w wersji 4 jest zaimplementowany w infrastrukturze usług w Google Cloud. Ta implementacja zapewnia bezpieczniejszą i bardziej zaufaną platformę z ulepszonymi opcjami bezpieczeństwa, takimi jak OAuth. Ten standardowy projekt interfejsu API zapewnia spójność między interfejsami API, co zwiększa efektywność programowania przy użyciu interfejsu Geocoding API w wersji 4.
Dodano obsługę protokołu OAuth
Geocoding API w wersji 4 obsługuje uwierzytelnianie za pomocą OAuth 2.0. Google obsługuje typowe scenariusze OAuth 2.0, np. te dotyczące serwera WWW.
Dodano obsługę maski pola
Użyj masek pól, aby określić, jakie informacje powinna zwracać odpowiedź. W przypadku metod Geocode an address, Geocode a location i Place geocoding domyślnie zwracane są wszystkie pola w obiekcie odpowiedzi. W przypadku metody Search for destinations musisz określić maskę pola w żądaniu do interfejsu API.
Bezpieczeństwo interfejsów API
Interfejs Geocoding API w wersji 4 został zaprojektowany jako interfejs API między serwerami. Bezpośrednie wywołania po stronie klienta z przeglądarki narażają klucze interfejsu API na znaczne ryzyko kradzieży i nadużycia, ponieważ ograniczenia dotyczące odsyłającego HTTP nie zapewniają wystarczającej ochrony punktów końcowych usługi internetowej.
Zdecydowanie zalecamy wywoływanie interfejsu Geocoding API w wersji 4 z własnego serwera backendu. Więcej informacji o bezpiecznych wzorcach implementacji i alternatywach dla potrzeb po stronie klienta znajdziesz w artykule o kwestiach związanych z bezpieczeństwem.