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 jednego adresu lub miejsca, w tym:
Ta wersja interfejsu Geocoding API w wersji 4 zawiera te punkty końcowe:
- Geokodowanie adresu – współrzędne geograficzne adresów. Nazywa się je też geokodowaniem do przodu.
- Geokodowanie lokalizacji – adresy dla zestawów współrzędnych geograficznych. Nazywane też odwrotnym geokodowaniem.
- Geokodowanie miejsca – pobieranie adresu na podstawie identyfikatora miejsca.
- Wyszukiwanie miejsc docelowych – wyszukaj miejsce docelowe według adresu, identyfikatora miejsca lub lokalizacji.
Możesz określić, gdzie mają się pojawiać wyniki, i ograniczyć je do konkretnego regionu, hrabstwa lub kodu pocztowego.
Wypróbuj wersję demonstracyjną
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 (długość i szerokość geograficzną) lub identyfikatory miejsc. Możesz używać tych współrzędnych do umieszczania znaczników na mapie lub do wyśrodkowywania bądź zmiany położenia mapy w ramce widoku.
- Odwrotne geokodowanie: przekształca współrzędne geograficzne (szerokość i długość geograficzną) lub identyfikator miejsca na adres zrozumiały dla człowieka. Adresów możesz używać w różnych sytuacjach, np. do dostaw lub odbiorów.
W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w interfejsie Geocoding API wraz z danymi zwracanymi przez każdą metodę.
| Zasoby danych | Zwrócone dane | Format zwrotu |
|---|---|---|
| Geokodowanie | Zwraca adres, jego komponenty i typy. Więcej informacji znajdziesz w dokumentacji odpowiedzi geokodowania. |
|
| Odwrotne geokodowanie | Zwraca adres, jego komponenty i typy. Zapoznaj się z dokumentacją odpowiedzi odwrotnego geokodowania. | |
| Geokodowanie miejsc | Zwraca adres, jego komponenty i typy. Zapoznaj się z dokumentacją odpowiedzi geokodowania miejsca. | |
| Wyszukiwanie miejsca docelowego | Zwraca szczegółowe informacje o różnych miejscach docelowych na podstawie różnych danych wejściowych, takich jak adres, identyfikator miejsca lub współrzędne geograficzne. Zapoznaj się z dokumentacją dotyczącą wyszukiwania miejsc docelowych. |
Uruchamianie kanałów głosowych z widownią
Wersja 4 interfejsu Geocoding API ma osobne kanały dla funkcji ogólnodostępnych, wersji testowej i eksperymentalnych. Jeśli chcesz korzystać z funkcji w wersji podglądowej lub eksperymentalnej, w swojej prośbie podaj odpowiedni 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/ |
| Eksperymentalna | /v4alpha/ |
- Listę i opis wszystkich dostępnych zasobów REST znajdziesz w dokumentacji REST.
- Więcej informacji o poszczególnych etapach znajdziesz w artykule Etapy uruchamiania.
Funkcje interfejsu Geocoding API w wersji 4
Wersja 4 interfejsu Geocoding API oferuje te nowe funkcje.
Metoda wyszukiwania miejsca docelowego
Wersja 4 wprowadza metodę wyszukiwania miejsca docelowego, która umożliwia pobieranie szczegółowych informacji o różnych miejscach docelowych na podstawie różnych danych wejściowych, takich jak adres, identyfikator miejsca lub współrzędne geograficzne. Odpowiedź zawiera podsumowania oparte na AI i tokeny punktów nawigacyjnych, które zawierają informacje kontekstowe, które można przekazać do pakietu SDK Navigation w celu precyzyjnego wyznaczania trasy.
Wdrożone na standardowej platformie Google Cloud
Geocoding API w wersji 4 jest zaimplementowany w infrastrukturze usługi w Google Cloud. Dzięki temu zyskujesz bezpieczniejszą i bardziej zaufaną platformę z zaawansowanymi opcjami zabezpieczeń, takimi jak OAuth. Ten standardowy projekt interfejsu API zapewnia spójność między interfejsami API, co zwiększa wydajność programowania przy użyciu interfejsu Geocoding API w wersji 4.
Dodano obsługę OAuth
Interfejs Geocoding API w wersji 4 obsługuje uwierzytelnianie za pomocą OAuth 2.0. Google obsługuje typowe scenariusze korzystania z protokołu OAuth 2.0, takie jak serwer WWW.
Dodano obsługę maski pola
Użyj maski pola, aby określić, jakie informacje ma 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
Geocoding API w wersji 4 to interfejs API działający 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 sieciowej.
Zdecydowanie zalecamy wywoływanie interfejsu Geocoding API w wersji 4 z własnego serwera backendu. Więcej informacji o wzorcach bezpiecznego wdrażania i alternatywnych rozwiązaniach na potrzeby po stronie klienta znajdziesz w sekcji Kwestie związane z bezpieczeństwem.