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 si basano su uno dei modelli di luogo più accurati, aggiornati e completi del mondo reale. Ecco alcuni casi d'uso di esempio per le applicazioni:
- Mostra gli affitti di condomini all'interno delle principali aree metropolitane con risultati specificamente destinati alle città.
- Includi i dettagli del luogo in un aggiornamento dello stato del ritiro o della consegna.
- Visualizza un elenco di parchi in un'area insieme alle foto e alle recensioni inviate dagli utenti.
- Fornisci alle persone che programmano viaggi con dati di contatto, recensioni e livelli di prezzo per le strutture lungo il percorso.
Cosa puoi fare con l'API Places
Puoi utilizzare l'API Places per includere le seguenti funzionalità nelle tue applicazioni:
- Fornisci i risultati di ricerca dei luoghi provenienti da diversi tipi di query degli utenti, come input di testo, località nelle vicinanze e query utente ambigue o categoriche.
- Abilita le funzionalità di completamento automatico per diversi tipi di ricerca, che si tratti di query di testo specifiche o categoriche.
- Perfeziona il tipo di dettagli restituiti su un luogo, ad esempio l'orario di apertura, un riepilogo, le 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, i quali 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 creato 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 di API Places
L'API Places supporta due versioni dell'API: l'API Places è l'API esistente e l'API Places (nuova) è la versione di nuova generazione delle API.
Con il rilascio dell'API Places (nuova), la prima attività è decidere quale set di API utilizzare. Questo vale per i nuovi clienti o per i clienti esistenti che utilizzano 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 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.
Nell'esempio seguente viene effettuata 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 a quell'endpoint specifico per perfezionare i dati restituiti.
Nell'esempio seguente viene effettuata 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 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 luogo | Ricerca testuale (novità) | Non è disponibile una nuova versione di Trova luogo. Ricerca testuale (nuova) l'ha sostituita. |
| Ricerca nelle vicinanze | Ricerca nelle vicinanze (novità) | Tutte le richieste che utilizzano l'API esistente che includono una query di testo dovrebbero usare Ricerca testuale (nuova) perché Ricerca nelle vicinanze (nuova) non supporta l'input di testo. |
| Ricerca testuale | Ricerca testuale (novità) | |
| Dettagli del luogo | Dettagli del luogo (novità) | |
| Foto del luogo | Foto del luogo (novità) | |
| 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 coprono uno scenario di caso d'uso tipico per l'utilizzo del servizio API Places. Man mano che sviluppi la tua soluzione, puoi utilizzare endpoint aggiuntivi, come Nearby Search e Place Photo.| 1 | Configurazione | Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito, quindi scopri come utilizzare la chiave API. Per l'API Places (novità), puoi anche utilizzare i token OAuth. |
| 2 | Provare una ricerca testuale di base | Esegui una semplice ricerca testuale utilizzando Ricerca testuale (Nuova) o Ricerca testuale. |
| 3 | Per ulteriori dettagli, utilizza l'ID luogo | Molte API di Google Maps Platform restituiscono un ID luogo in una risposta. Utilizza l'ID luogo per ottenere dettagli su un luogo. Consulta le sezioni Dettagli sul luogo (nuova) e Dettagli sul luogo. |
| 4 | Scattare una foto per un luogo | Il servizio Place Photo ti dà accesso ai milioni di foto archiviate nel database di Places. Utilizza Foto del luogo (nuova) o Dettagli del luogo per accedere alle foto di un luogo. |