Perché utilizzare l'API Places
Crea funzionalità basate sulla posizione per rendere disponibili dati sulla posizione dettagliati per i tuoi utenti. 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:
- Mostra 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, 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.
Scegli la versione dell'API Places
L'API Places supporta due versioni: API Places sono le API esistenti e API Places (nuova) sono le versioni di nuova generazione delle API.
Con il rilascio dell'API Places (nuova), la prima cosa da fare è decidere quale insieme di API utilizzare. Questo vale se sei un nuovo cliente o un cliente esistente che utilizza già le API. Consulta questa guida per scoprire le principali differenze tra le due API.
Come funziona l'API Places
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 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 del servizio specifico, ad esempio /place o /photo. Gli endpoint accettano anche il tipo di formato specificato nella richiesta, JSON o XML. La richiesta di servizio utilizza parametri pertinenti per quell'endpoint specifico per perfezionare i dati restituiti.
Il seguente esempio effettua una richiesta Places 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 questo caso, il servizio utilizza l'ID luogo fornito per trovare il luogo richiesto e restituire i componenti dell'indirizzo in formato JSON.
Risorse
La tabella seguente riassume le risorse disponibili tramite l'API Places.
| API Places | API Places (Novità) | Nota |
|---|---|---|
| Trova un luogo | Ricerca di testo (novità) | Non è disponibile una nuova versione di Trova posto. La ricerca di testo (nuova) lo ha sostituito. |
| Ricerca nelle vicinanze | Ricerca nelle vicinanze (nuova) | Tutte le richieste che utilizzano l'API esistente e includono una query di testo devono utilizzare Ricerca di testi (nuova) perché la Ricerca nelle vicinanze (nuova) non supporta l'input di testo. |
| Ricerca di testo | Ricerca di testo (novità) | |
| Dettagli sul luogo | Place Details (versione nuova) | |
| Inserisci foto | Inserisci foto (nuova) | |
| Place Autocomplete | Completamento automatico (novità) | |
| Completamento automatico delle query | Completamento automatico (novità) | Funzionalità aggiunte al completamento automatico (novità) |
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. Man mano che sviluppi la tua soluzione, puoi utilizzare endpoint aggiuntivi, come Ricerca nelle vicinanze e Foto dei luoghi.| 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. Per l'API Places (nuova), puoi anche utilizzare token OAuth. |
| 2 | Provare una ricerca di testo di base | Esegui una ricerca di testo utilizzando Ricerca di testo (nuova) o Ricerca di testo. |
| 3 | Utilizzare l'ID luogo per maggiori dettagli | Molte API di Google Maps Platform restituiscono un ID luogo all'interno di una risposta. Utilizza l'ID luogo per ottenere i dettagli di un luogo. Consulta Dettagli dei luoghi (novità) e Dettagli dei luoghi. |
| 4 | Ottenere una foto di un luogo | Il servizio Foto del luogo ti consente di accedere ai milioni di foto archiviate nel database di Places. Utilizza Foto del luogo (nuova) o Dettagli luogo per accedere alle foto di un luogo. |