Metody Geocoding API w wersji 4 mają domyślny limit 25 zapytań na sekundę. Informacje o tym, jak poprosić o zwiększenie limitu, znajdziesz w artykule Wyświetlanie limitów i zarządzanie nimi. Jako usługę wybierz Geocoding API.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Omówienie Geocoding API w wersji 4

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 współrzędne szerokości i długości geograficznej albo identyfikator miejsca na adres.

Geocoding API w wersji 4 zapewnia zarówno hiperlokalne informacje o miejscu docelowym i przybyciu, jak i podstawowe informacje o współrzędnych i adresie. Niezależnie od tego, czy tworzysz usługę dostawy na ostatnim odcinku, przejazdów współdzielonych czy szczegółowych wskazówek dojazdu, czy też normalizujesz adresy ulic na współrzędne, wersja 4 oferuje dedykowane punkty końcowe dostosowane do Twojego przypadku użycia.

Nie wiesz, który punkt końcowy pasuje do Twojej aplikacji? Zobacz Wybieranie metody geokodowania.

Co możesz zrobić za pomocą interfejsu Geocoding API

Geocoding API w wersji 4 obejmuje te funkcje i punkty końcowe:

Wyszukiwanie miejsc docelowych: pobieraj hiperlokalne szczegóły przybycia do miejsca docelowego na podstawie adresu, identyfikatora miejsca lub współrzędnych – w tym wejścia do budynków, możliwe do wyznaczenia trasy tokeny punktów nawigacyjnych, kontury budynków i terenów, miejsca docelowe i pobliskie punkty orientacyjne.
Geokodowanie adresu: konwertowanie adresów pocztowych na współrzędne geograficzne i identyfikatory miejsc (geokodowanie wyprzedzające).
Geokodowanie lokalizacji: konwertowanie współrzędnych geograficznych na zrozumiałe dla człowieka adresy ulic lub regiony administracyjne (odwrotne geokodowanie).
Geokodowanie miejsca: pobieranie sformatowanych danych adresowych i współrzędnych dla znanego identyfikatora miejsca w Mapach Google.

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

Interfejs Geocoding API w wersji 4 obsługuje wyszukiwanie miejsc docelowych oraz podstawowe geokodowanie:

Wyszukiwanie miejsca docelowego (SearchDestinations): przekształca adres, identyfikator miejsca lub parę współrzędnych w rozbudowany obiekt Destination. Użyj tej metody, gdy fizyczne dotarcie do celu ma znaczenie – na przykład przy określaniu preferowanych wejść do budynku, kierowaniu kierowców do wyznaczonych punktów odbioru lub wysiadania za pomocą tokenów punktów nawigacyjnych, renderowaniu obrysów budynków na mapie lub nawigowaniu po kompleksach składających się z wielu budynków.
Podstawowe geokodowanie: konwertuje adresy, współrzędne i identyfikatory miejsc:
- Geocoding: konwertuje adresy, takie jak „1600 Amphitheatre Parkway, Mountain View, CA”, na współrzędne geograficzne lub identyfikatory miejsc, aby umieścić znaczniki na mapie lub wyśrodkować ramkę widoku mapy.
- Odwrotne geokodowanie: konwertuje współrzędne geograficzne lub identyfikatory miejsc na zrozumiałe dla człowieka adresy ulic, które są używane w przypadku pinezek na mapie, selektorów lokalizacji lub wyświetlania interfejsu.
- Geokodowanie miejsca: pobiera szczegóły adresu i współrzędne dla znanego identyfikatora miejsca w Mapach Google.

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

Zasoby danych	Zwrócone dane	Format zwrotu
Wyszukiwanie miejsc docelowych (`POST /v4/geocode/destinations`)	Zwraca hiperlokalne informacje o przybyciu: wielokąty budynków i terenów (`displayPolygon`), fizyczne `entrances`, routowalne `navigationPoints` (z tokenami), hierarchiczne `containingPlaces` i `subDestinations`, relacyjne `landmarks` oraz szczegóły głównego miejsca. Więcej informacji znajdziesz w artykule Wyszukiwanie miejsc docelowych.	JSON
Geokodowanie adresu (`GET /v4/geocode/address`)	Zwraca adres, komponenty adresu i typy adresów. Zobacz Odpowiedź dotycząca kodu geograficznego.
Geokodowanie lokalizacji (`GET /v4/geocode/location`)	Zwraca adres, komponenty adresu i typy adresów. Zobacz Odpowiedź odwrotnego geokodowania.
Geokodowanie miejsca (`GET /v4/geocode/places`)	Zwraca adres, komponenty adresu i typy adresów. Zobacz Odpowiedź geokodowania miejsca.

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.