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:
Ta wersja interfejsu Geocoding API w wersji 4 zawiera te punkty końcowe:
- (Wersja zapoznawcza) Geokodowanie adresu – współrzędne geograficzne adresów. Nazywa się je też geokodowaniem do przodu.
- (Wersja zapoznawcza) Geokodowanie lokalizacji – adresy dla zestawów współrzędnych geograficznych. Nazywane też odwrotnym geokodowaniem.
- (Wersja zapoznawcza) Geokodowanie miejsca – pobieranie adresu na podstawie identyfikatora miejsca.
- (Wersja zapoznawcza) 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.
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żyć tych współrzędnych, aby umieścić znaczniki na mapie lub wyśrodkować mapę w ramce widoku albo zmienić jej położenie.
- Odwrotne geokodowanie: przekształca współrzędne geograficzne lub identyfikator miejsca na adres czytelny 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 oraz dane zwracane przez poszczególne punkty końcowe.
| Zasoby danych | Zwrócone dane | Format zwrotu |
|---|---|---|
| Geokodowanie | Zwraca adres, jego komponenty i typy. Zapoznaj się z dokumentacją odpowiedzi geokodowania. |
|
| Odwrotne geokodowanie | Zwraca adres, jego komponenty i typy. Zapoznaj się z dokumentacją dotyczącą odpowiedzi z 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 kryteriów wejściowych, takich jak adres, identyfikator miejsca lub współrzędne geograficzne. Zapoznaj się z dokumentacją wyszukiwania miejsc docelowych. |
Funkcje interfejsu Geocoding API w wersji 4
Wersja 4 interfejsu Geocoding API oferuje te nowe funkcje.
Punkt końcowy wyszukiwania miejsc docelowych
Wersja 4 wprowadza punkt końcowy wyszukiwania miejsca docelowego, który 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 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. Wdrożenie to zapewnia bezpieczniejszą i bardziej zaufaną platformę z zaawansowanymi opcjami zabezpieczeń, takimi jak OAuth. Ten standardowy projekt interfejsu API zapewnia spójność interfejsów API, co zwiększa efektywność programowania z użyciem 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 internetowy.
Dodano obsługę maski pola
Użyj masek pól, aby określić, jakie informacje ma zwracać odpowiedź. W przypadku punktów końcowych Geocode an address, Geocode a location i Place geocoding domyślnie zwracane są wszystkie pola w obiekcie odpowiedzi. W przypadku punktu końcowego Search for destinations musisz określić maskę pola w żądaniu do interfejsu API.
Brak opłat za korzystanie z wersji przedpremierowej
Geocoding API w wersji 4 jest w fazie przedpremierowej, a korzystanie z interfejsu API w tym okresie jest bezpłatne. Wywołania interfejsu API będą widoczne na stronie Płatności w konsoli Google Cloud, ale opłaty wyniosą 0 USD.
Prześlij opinię
Jest to funkcja w wersji testowej. Będziemy wdzięczni za przesłanie opinii na adres geocoding-feedback-channel@google.com.