Perché utilizzare l'API Places
Crea funzionalità sensibili alla posizione per rendere facilmente disponibili agli utenti i 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 appartamenti in affitto all'interno delle principali aree metropolitane con risultati mirati specificamente alle città.
- Includi i dettagli del luogo nell'aggiornamento dello stato del ritiro o della consegna.
- Mostra un elenco dei parchi di una zona insieme a foto e recensioni inviate dagli utenti.
- Fornisci alle persone che pianificano viaggi i dati di contatto, le recensioni e i 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 applicazioni:
- Fornisci risultati di ricerca di luoghi ricavati da diversi tipi di query degli utenti, ad esempio input di testo, località nelle vicinanze e query utente ambigue o categoriche.
- Attiva le funzionalità di completamento automatico per diversi tipi di ricerca, che si tratti di query di testo specifiche o di query categoriche.
- Perfeziona 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 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 tramite l'API Places, ma anche tramite l'API Geocoding, l'API Routes e l'API Address Validation.
Una volta ottenuto l'ID luogo, puoi utilizzare l'API Places per richiedere ulteriori dettagli su un determinato edificio 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 dell'API: l'API Places è le API esistenti, mentre l'API Places (nuova) sono le versioni di nuova generazione delle API.
Con il rilascio dell'API Places (nuova), la prima attività è decidere quale set di API utilizzare. Questo vale se sei un nuovo cliente o un cliente esistente che utilizza già le API. Utilizza questa guida per apprendere 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 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 testo (novità) | Non esiste una nuova versione di Trova luogo. 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 usare Ricerca testo (nuova) perché la ricerca nelle vicinanze (nuova) non supporta l'input di testo. |
Ricerca testuale | Ricerca testo (novità) | |
Dettagli del luogo | Dettagli luogo (nuovo) | |
Foto del luogo | Foto del luogo (nuova) | |
Place Autocomplete | Nessuna versione dell'API Places (nuova) | |
Completamento automatico query | Nessuna versione dell'API Places (nuova) |
Come utilizzare l'API Places
I passaggi riportati di seguito riguardano uno scenario d'uso tipico per l'utilizzo del servizio API Places. Mentre sviluppi la tua soluzione, puoi utilizzare endpoint aggiuntivi, come Ricerca nelle vicinanze e Foto dei luoghi.1 | Inizia la configurazione | Per iniziare, consulta Configura il tuo progetto Google Cloud, completa le istruzioni di configurazione riportate di seguito, poi scopri come utilizzare la tua chiave API. Per l'API Places (nuova), puoi anche utilizzare i token OAuth. |
2 | Provare una ricerca di testo semplice | Esegui una semplice ricerca testuale utilizzando Ricerca testo (nuova) o Ricerca testo. |
3 | Utilizzare l'ID luogo per ulteriori dettagli | Molte API Google Maps Platform restituiscono un ID luogo in una risposta. Utilizza l'ID luogo per ottenere informazioni dettagliate su un luogo. Vedi Dettagli luogo (nuovo) e Dettagli luogo. |
4 | Scattare una foto di un luogo | Il servizio Place Photo ti dà accesso 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. |