Utilizza il servizio Places e l'API Geocoding con gli stili basati sui dati per i confini

Seleziona la piattaforma: Android iOS JavaScript

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 l'API Geocoding sono alternative efficaci 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:

  • Places SDK for Android è una libreria Android contenente metodi per restituire informazioni su luoghi.
  • L'API Places restituisce informazioni sui luoghi utilizzando richieste HTTP.
  • La classe Geocoder può eseguire la geocodifica e la geocodifica inversa in modo dinamico in base all'input dell'utente.
  • L'API Geocoding ti consente di geocodificare indirizzi statici noti.

Utilizzare il servizio Places

Utilizzare la ricerca di testo (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 (novità) 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.

Visualizzare i dettagli di un luogo per una regione

Il servizio Dettagli dei luoghi in Places SDK per Android restituisce i dati per una regione e può essere molto 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:

  • Utilizza la geocodifica 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 alle coordinate di latitudine e longitudine o per restituire gli ID luogo di tutti i componenti in una determinata località.

L'esempio seguente utilizza un indirizzo (con codifica URL) per effettuare una richiesta all'API Geocoding:

https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY

Puoi utilizzare la geocodifica inversa per trovare gli ID luogo. L'esempio seguente della funzione servizio di geocodifica restituisce gli ID luogo per tutti i componenti dell'indirizzo alle coordinate di latitudine e longitudine specificate:

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY

Utilizza il geocoding inverso con il filtro dei componenti per ottenere il componente dell'indirizzo per uno o più dei seguenti tipi nella località specificata:

  • administrativeArea
  • country
  • locality
  • postalCode

La funzione di esempio seguente mostra l'utilizzo del servizio di geocodifica, l'aggiunta di limitazioni dei componenti con il geocodifica inversa per ottenere tutti i componenti dell'indirizzo nella 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