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 gli stili basati sui dati per i confini.

Aggiungi il servizio Places e la geocodifica alle tue app Maps SDK for Android nei seguenti modi:

  • L'SDK Places per Android è una libreria Android che contiene metodi per restituire informazioni sui luoghi.
  • L'API Places restituisce informazioni sui luoghi utilizzando richieste HTTP.
  • La classe geocodificatore può geocodificare e invertire in modo dinamico l'input dell'utente.
  • L'API Geocoding ti consente di geocodificare indirizzi statici noti.

Utilizzare il servizio Places

Utilizza la ricerca testuale (novità) per trovare un ID luogo

Puoi utilizzare l'API REST Text Search (nuova) nell'API Places per ottenere un ID luogo che includa i dati sulla regione specificando places.id nella maschera dei campi. L'utilizzo della ricerca di testo (nuova) per richiedere gli ID luogo non comporta alcun costo. Scopri di più.

Ad esempio, per ottenere l'ID luogo di Trinidad, in California, puoi effettuare la seguente chiamata all'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'

Utilizzare il completamento automatico di Places per trovare le regioni

Il servizio Place Autocomplete in Places SDK per Android offre un modo pratico per consentire ai tuoi utenti di cercare regioni. Per configurare il servizio di compilazione automatica di Luoghi in modo che restituisca solo regioni, utilizza AutocompleteSupportFragment.setTypesFilter(List) per impostare il filtro di 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 luogo del confine in base ai nomi dei luoghi.
  • Ottieni l'area visibile per lo zoom fino a un confine.
  • Recupera il tipo di elemento per il confine (ad esempio locality).
  • Recupera l'indirizzo formattato, che restituisce "Nome del luogo, Stato, Paese" nell'area geografica degli Stati Uniti (ad esempio, "Ottumwa, IA, USA").
  • Ricevi altri dati utili, come le foto.

Utilizzare l'API Geocoding

L'API Geocoding consente di convertire un indirizzo in coordinate di latitudine e longitudine e di un ID luogo oppure di convertire le coordinate di latitudine e longitudine o un ID luogo in un indirizzo. I seguenti utilizzi si combinano bene con gli stili basati sui dati per 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 le aree amministrative 1-4, la località o il codice postale.
  • Utilizza la geocodifica inversa per trovare gli ID luogo in base alle coordinate di latitudine e longitudine o persino per restituire gli ID luogo per 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. Il seguente esempio di funzione del 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 la geocodifica inversa con filtri dei componenti per recuperare il componente indirizzo per uno o più dei seguenti tipi nella posizione 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