Panoramica

Seleziona la piattaforma: Android iOS JavaScript Web Service
L'API Places è un servizio che accetta richieste HTTP per i dati sulla posizione tramite una serie di metodi. Restituisce dati sulla posizione formattati e immagini di stabilimenti, località geografiche o punti d'interesse importanti.

Perché utilizzare l'API Places

Crea funzionalità basate sulla posizione per rendere disponibili ai tuoi utenti dati sulla posizione dettagliati. I dati disponibili tramite l'API Places si basano su uno dei modelli di luoghi più accurati, aggiornati e completi del mondo reale. Ecco alcuni casi d'uso di esempio per le applicazioni:

  • Mostrare le case in affitto nelle principali aree metropolitane con risultati mirati specificamente alle città.
  • Includi i dettagli del luogo in un aggiornamento dello stato di ritiro o consegna.
  • Mostra un elenco di parchi in un'area, insieme a foto e recensioni inviate dagli utenti.
  • Fornisci alle persone che pianificano viaggi informazioni di contatto, recensioni e fasce di prezzo per gli stabilimenti lungo il percorso.

Cosa puoi fare con l'API Places

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

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

Molte API di Google Maps Platform supportano gli ID luogo, che identificano 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 un ID luogo, puoi utilizzare l'API Places per richiedere ulteriori dettagli su un determinato esercizio o punto d'interesse, ad esempio l'indirizzo completo, il numero di telefono, la valutazione degli utenti e le recensioni.

Come funziona l'API Places (nuova)

L'API Places (nuova) accetta le richieste come URL standard con un endpoint del servizio specifico, ad esempio /places o places:searchText, e restituisce una risposta JSON. L'API Places (nuova) supporta l'autorizzazione tramite chiave API e token OAuth. Il seguente esempio effettua una richiesta Places Details (New) 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

Come utilizzare l'API Places

I passaggi riportati di seguito illustrano un tipico scenario di caso d'uso per l'utilizzo del servizio dell'API Places. Durante la creazione della soluzione, puoi utilizzare endpoint aggiuntivi, come Ricerca nelle vicinanze (novità) e Foto del luogo (novità).
1 Configurazione Per iniziare, consulta la sezione Configurare il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito, quindi scopri come utilizzare la chiave API.
2 Eseguire una ricerca di testo di base Esegui una ricerca di testo utilizzando Ricerca di testo (nuova).
3 Utilizzare l'ID luogo per maggiori dettagli Molte API di Google Maps Platform restituiscono un ID luogo all'interno di una risposta. Utilizza gli ID luogo per recuperare i Dettagli dei luoghi (novità).
4 Ottenere una foto di un luogo Il servizio Foto del luogo (nuovo) ti consente di accedere ai milioni di foto archiviate nel database di Places. Utilizza Foto del luogo (nuova) per accedere alle foto di un luogo.