Perché utilizzare l'API Places (novità)
Crea funzionalità basate sulla posizione per mettere a disposizione dei tuoi utenti dati sulla posizione dettagliati. I dati disponibili tramite l'API Places (nuova) si basano su uno dei modelli di luoghi più accurati, aggiornati e completi del mondo reale. Ecco alcuni esempi di casi d'uso 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 alle foto e alle recensioni inviate dagli utenti.
- Fornisci alle persone che pianificano viaggi informazioni di contatto, recensioni e livelli di prezzo per gli stabilimenti lungo il percorso.
Cosa puoi fare con l'API Places (novità)
Puoi utilizzare l'API Places (nuova) per includere le seguenti funzionalità nelle tue applicazioni:
- Fornisci risultati di ricerca dei luoghi da diversi tipi di query degli utenti, come input di testo, località nelle vicinanze e query degli utenti ambigue o categoriche.
- 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 orario 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, in cui 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 (nuova), ma anche dall'API Geocoding, dall'API Routes e dall'API Address Validation.
Una volta ottenuto un ID luogo, puoi utilizzare l'API Places (nuova) 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 (novità)
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 (novità)
I passaggi riportati di seguito illustrano un tipico scenario di caso d'uso per l'utilizzo del servizio API Places. Durante la creazione della soluzione, puoi utilizzare endpoint aggiuntivi, come Ricerca nelle vicinanze (novità) e Foto dei luoghi (novità).| 1 | Configurazione | Inizia con la configurazione del progetto Google Cloud e completa le istruzioni di configurazione che seguono, 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 nell'ambito di una risposta. Utilizza gli ID luogo per ottenere i Dettagli dei luoghi (novità). |
| 4 | Ottenere una foto di un luogo | La nuova funzionalità Foto del luogo ti consente di accedere a milioni di foto archiviate nel database di Places. Utilizza Foto dei luoghi (nuova) per accedere alle foto di un luogo. |