Za pomocą usługi Miejsca i interfejsu Geokodowanie API w pakiecie SDK Mapy na Androida możesz wyszukiwać regiony i uzyskiwać więcej informacji o miejscach. Usługa Miejsca oraz Geocoding API to wydajne i stabilne zamienniki pozyskiwania identyfikatorów miejsc. Jeśli używasz już identyfikatorów miejsc, możesz ich używać ponownie w ramach stylizacji opartej na danych.
Dodaj usługę Miejsca i Geokodowanie do Maps SDK do aplikacji na Androida możesz przesyłać na następujące sposoby:
- Pakiet SDK Miejsca na Androida to biblioteka na Androida zawierająca metody zwracające informacje o miejscach.
- Interfejs Places API zwraca informacje o miejscach za pomocą żądań HTTP.
- Zajęcia dotyczące geokodera Na podstawie danych wejściowych użytkownika może dynamicznie przetwarzać i odwracać geokodowanie.
- Interfejs Geocoding API umożliwia geokodowanie statycznych, znanych adresów.
Korzystanie z usługi Miejsca
Użyj wyszukiwania tekstowego (nowego) do znalezienia identyfikatora miejsca
Możesz użyć funkcji wyszukiwania tekstowego (nowość).
API typu REST w interfejsie Places API w celu uzyskania identyfikatora miejsca zawierającego region
danych, określając places.id w masce pola. Korzystanie z
Korzystanie z wyszukiwarki tekstowej (nowość) w celu uzyskania tylko identyfikatorów miejsc
bez ponoszenia opłat. Więcej informacji
Aby na przykład uzyskać identyfikator miejsca Trinidad w Kanadzie, możesz użyć tego wywołania interfejsu API:
curl -X POST -d '{
"textQuery" : "Trinidad, CA"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'Używanie autouzupełniania miejsc do znajdowania regionów
Autouzupełnianie miejsc
w pakiecie SDK Miejsc dla systemu Android zapewnia wygodny sposób
gdy użytkownicy wyszukują informacje w określonych regionach. Aby skonfigurować usługę autouzupełniania Miejsca tak, aby zwracała tylko regiony, użyj wartości AutocompleteSupportFragment.setTypesFilter(List), aby ustawić filtr typu na PlaceTypes.REGIONS.
Pobieranie szczegółowych informacji o miejscu w regionie
Szczegóły miejsca. w pakiecie SDK Miejsc dla Androida dane dla regionu mogą może być dość przydatna. Możesz na przykład:
- Wyszukuj identyfikatory miejsc przy granicach na podstawie nazw miejsc.
- Pobierz widoczny obszar, aby powiększyć do granicy.
- Uzyskaj typ funkcji dla granicy (na przykład
locality). - Uzyskaj sformatowany adres, który ma format „Place Name, State, Country” (Nazwa miejsca, stan, kraj). cale region Stanów Zjednoczonych (np. „Ottumwa, IA, USA”).
- Uzyskiwanie innych przydatnych danych, np. zdjęć.
Korzystanie z interfejsu Geocoding API
Interfejs Geocoding API umożliwia konwertowanie adresu na współrzędne szerokości i długości geograficznej i identyfikator miejsca lub konwertuje szerokości i długości geograficznej lub identyfikatora miejsca. Te elementy dobrze współgrają ze stylem opartym na danych:
- Użyj geokodowania, by uzyskać widoczny obszar dla danego regionu.
- Zastosuj filtrowanie komponentów do wywołania geokodowania, aby uzyskać identyfikatory miejsc dla obszarów administracyjnych 1–4, miejscowości lub kodu pocztowego.
- Za pomocą odwrotnego geokodowania możesz znaleźć identyfikatory miejsc na podstawie współrzędnych geograficznych lub nawet zwrócić identyfikatory miejsc dla wszystkich komponentów w danej lokalizacji.
W poniższym przykładzie użyto adresu (ze zmianą znaczenia w przypadku adresu URL), aby wysłać żądanie do Geocoding API:
https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEYMożesz zastosować odwrotne geokodowanie. aby znaleźć identyfikatory miejsc. Geokodowanie poniżej funkcja usługi zwraca identyfikatory miejsc dla wszystkich komponentów adresu w elemencie określone współrzędne szerokości i długości geograficznej:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEYUżyj odwrotnego geokodowania z filtrowaniem komponentów, aby uzyskać komponent adresu w przypadku co najmniej jednego z tych typów w wybranej lokalizacji:
administrativeAreacountrylocalitypostalCode
Następna przykładowa funkcja jest wyświetlana przy użyciu usługi Geocoding, dodając komponent
za pomocą odwrotnego geokodowania, by wszystkie składniki adresu były w
w podanej lokalizacji tylko dla typu locality:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY