Puoi utilizzare il servizio Places e l'API Geocoding con Maps SDK for Android per cercare regioni e ottenere ulteriori informazioni sui luoghi. Il servizio Places e Geocoding API sono alternative potenti e stabili per ottenere ID luogo. Se utilizzi già gli ID luogo, puoi riutilizzarli con stili basati sui dati per definire i confini.
Aggiungi il servizio Places e Geocoding al tuo Maps SDK for Android app nei seguenti modi:
- SDK Places per Android è una libreria Android contenente metodi per restituire informazioni su luoghi.
- API Places restituisce informazioni sulle posizioni utilizzando le richieste HTTP.
- Classe geocodificatore può geocodificare e invertire in modo dinamico l'input dell'utente.
- L'API Geocoding ti consente geocodificare indirizzi statici noti.
Utilizzare il servizio Places
Utilizza la ricerca testuale (novità) per trovare un ID luogo
Puoi utilizzare Ricerca testuale (novità)
API REST nell'API Places per ottenere un ID luogo che includa la regione
specificando places.id
nella maschera del campo. Utilizzo dei
Ricerca testuale (nuova) per richiedere solo ID luogo
senza costi aggiuntivi. Scopri di più.
Ad esempio, per ottenere l'ID luogo di Trinidad, CA, puoi effettuare quanto segue Chiamata 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'
Utilizza la funzionalità di completamento automatico di Places per trovare le regioni
La funzionalità di completamento automatico di Places
in Places SDK per Android è un modo pratico per
gli utenti cercano regioni. Per configurare il servizio Places Autocomplete per
restituisce solo le regioni, utilizza
AutocompleteSupportFragment.setTypesFilter(List)
per impostare il filtro del tipo su PlaceTypes.REGIONS
.
Visualizza i dettagli del luogo per una regione
I dettagli del luogo in Places SDK per Android per restituire i dati relativi a una regione possono essere piuttosto utile. Ad esempio, puoi:
- Cerca gli ID dei luoghi dei confini in base ai nomi dei luoghi.
- Ottieni l'area visibile per eseguire lo zoom su un confine.
- Ottieni il tipo di caratteristica per il confine (ad esempio
locality
). - Ottieni l'indirizzo formattato, che restituisce "Nome del luogo, Provincia, Paese" nel Area geografica degli Stati Uniti (ad esempio "Ottumwa, IA, USA").
- Ricevi altri dati utili come le foto.
Utilizzare l'API Geocoding
L'API Geocoding ti consente di convertire un indirizzo in coordinate di latitudine e longitudine e un ID luogo, oppure converte coordinate di latitudine e longitudine o un ID luogo in un indirizzo. Le seguenti si combinano bene con gli stili basati sui dati per definire i confini:
- Usa Geocoding per ottenere l'area visibile di una regione.
- Applica il filtro dei componenti alla chiamata di geocodifica per ottenere gli ID luogo per aree amministrative 1-4, località o codice postale.
- Utilizza la geocodifica inversa per trovare gli ID luogo in base a latitudine e longitudine le coordinate, o persino gli ID luogo, per tutti i componenti di un in ogni località.
L'esempio seguente utilizza un indirizzo (con escape URL) per inviare una richiesta all'oggetto API Geocoding:
https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY
Puoi usare la geocodifica inversa. per trovare gli ID dei luoghi. Nell'esempio seguente, Geocodifica la funzione di servizio restituisce gli ID luogo per tutti i componenti dell'indirizzo nella coordinate di latitudine e longitudine specificate:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY
Utilizza la geocodifica inversa con i filtri dei componenti per ottenere il componente indirizzo per uno o più dei seguenti tipi nella località specificata:
administrativeArea
country
locality
postalCode
La funzione di esempio successiva mostra come utilizzare il servizio Geocoding, aggiungendo un componente
limitazioni con la geocodifica inversa per ottenere tutti i componenti dell'indirizzo
località specificata solo per il tipo locality
:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY