Panoramica

Seleziona la piattaforma: Android iOS JavaScript Servizio web
L'API Places è un servizio che accetta richieste HTTP di dati sulla posizione tramite diversi metodi. Restituisce dati sulla posizione formattati e immagini di luoghi, località geografiche o punti di interesse importanti.

Perché utilizzare l'API Places

Crea funzionalità sensibili alla posizione per rendere facilmente disponibili ai tuoi utenti dati dettagliati sulla posizione. I dati disponibili tramite l'API Places sono basati su uno dei modelli di luogo più accurati, aggiornati e completi del mondo reale. Ecco alcuni esempi di casi d'uso per le applicazioni:

  • Mostra condomini in affitto all'interno delle principali aree metropolitane con risultati mirati specificamente alle città.
  • Includi i dettagli del luogo in un aggiornamento dello stato del ritiro o della consegna.
  • Mostra un elenco dei parchi di una zona insieme alle foto e alle recensioni inviate dagli utenti.
  • Fornisci alle persone che pianificano viaggi fornendo dati di contatto, recensioni e livelli di prezzo delle strutture lungo il percorso.

Che cosa puoi fare con l'API Places

Puoi utilizzare l'API Places per includere le seguenti funzionalità nelle tue applicazioni:

  • Fornisci risultati di ricerca di luoghi da diversi tipi di query degli utenti, ad esempio input di testo, località nelle vicinanze e query utente ambigue o categoriche.
  • Abilita le funzionalità di completamento automatico per diversi tipi di ricerca (query di testo specifiche o query categoriche).
  • Perfeziona il tipo di dettagli restituiti su un luogo, ad esempio orario di apertura, un riepilogo, recensioni degli utenti e una foto.
  • Aggiungi foto di alta qualità alle località servite dalla tua applicazione.

Molte API di Google Maps Platform supportano gli ID luogo, dove l'ID luogo identifica in modo univoco un luogo nel database di Google Places e su Google Maps. Esistono molti modi per ottenere un ID luogo, ad esempio dall'API Places, ma anche dall'API Geocoding, dall'API Routes e dall'API Address Validation.

Una volta ottenuto l'ID luogo, puoi utilizzare l'API Places per richiedere ulteriori dettagli su una determinata struttura o punto d'interesse, come l'indirizzo completo, il numero di telefono, la valutazione degli utenti e le recensioni.

Scegli la tua versione dell'API Places

L'API Places supporta due versioni API: l'API Places è le API esistenti e l'API Places (nuova) è la versione di nuova generazione delle API.

Con il rilascio dell'API Places (Novità), la prima attività è decidere quale insieme di API utilizzare. Questo vale se sei un nuovo cliente o un cliente esistente che utilizza già le API. Utilizza questa guida per scoprire le principali differenze tra le due API.

Come funziona l'API Places

API Places (Novità)

L'API Places (New) accetta le richieste come URL standard con un endpoint di servizio specifico, come /places o places:searchText, e restituisce una risposta JSON. L'API Places (Nuova) supporta l'autorizzazione tramite chiave API e token OAuth. L'esempio seguente esegue una richiesta Place Details per restituire i componenti dell'indirizzo per un ID luogo utilizzando una chiave API:

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

API Places

L'API Places accetta le richieste come URL standard con un endpoint di servizio specifico, come /place o /photo. Gli endpoint accettano anche il tipo di formato specificato nella richiesta, JSON o XML. La richiesta di servizio utilizza parametri pertinenti all'endpoint specifico per perfezionare i dati restituiti. L'esempio seguente esegue una richiesta Place Details per restituire i componenti dell'indirizzo per un ID luogo in formato JSON:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&fields=address_components&key=YOUR_API_KEY

In questa istanza, il servizio utilizza l'ID luogo fornito per trovare il luogo richiesto e restituire i componenti dell'indirizzo in formato JSON.

Risorse

La seguente tabella riassume le risorse disponibili tramite l'API Places.

API Places API Places (Novità) Nota
Trova luogo Ricerca testuale (novità) Non esiste una nuova versione di Find Place. La funzionalità Ricerca testuale (Nuova) lo ha sostituito.
Ricerca nelle vicinanze Ricerca nelle vicinanze (novità) Tutte le richieste che utilizzano l'API esistente che includono una query di testo devono utilizzare Ricerca testuale (nuova) perché la ricerca nelle vicinanze (nuova) non supporta l'inserimento di testo.
Ricerca testuale Ricerca testuale (novità)
Dettagli del luogo Dettagli luogo (novità)
Foto del luogo Foto del luogo (nuova)
Place Autocomplete Completamento automatico (novità) In anteprima
Completamento automatico query Completamento automatico (novità) Funzionalità aggiunte alla versione di anteprima del completamento automatico (novità)

Come utilizzare l'API Places

I passaggi riportati di seguito riguardano un tipico caso d'uso per l'utilizzo del servizio API Places. Durante la creazione della soluzione, puoi utilizzare endpoint aggiuntivi, come Ricerca nelle vicinanze e Place Photo.
1 Configurazione Inizia con Configura il tuo progetto Google Cloud, completa le istruzioni di configurazione che seguono, poi scopri come utilizzare la chiave API. Per l'API Places (novità), puoi utilizzare anche token OAuth.
2 Prova una ricerca di testo semplice Esegui una semplice ricerca testuale utilizzando Ricerca testuale (nuova) o Ricerca testuale.
3 Utilizza l'ID luogo per ulteriori dettagli Molte API di Google Maps Platform restituiscono un ID luogo come parte di una risposta. Utilizza l'ID luogo per ottenere dettagli su un luogo. Consulta Dettagli luogo (nuovo) e Dettagli luogo.
4 Scattare una foto di un luogo Il servizio Place Photo consente di accedere a milioni di foto archiviate nel database di Places. Utilizza Foto del luogo (nuova) o Dettagli del luogo per accedere alle foto di un luogo.