Perché utilizzare l'API Places
Crea funzionalità sensibili alla posizione per mettere facilmente a disposizione dei tuoi utenti dati dettagliati sulla posizione. I dati disponibili tramite l'API Places sono basati su uno dei modelli di luogo più precisi, aggiornati e completi del mondo reale. Ecco alcuni casi d'uso di esempio per le applicazioni:
- Mostra condomini in affitto nelle principali aree metropolitane con risultati rivolti specificamente alle città.
- Includi i dettagli del luogo in un aggiornamento dello stato di ritiro o consegna.
- Visualizza un elenco di parchi in una zona insieme a foto e recensioni inviate dagli utenti.
- Fornisci agli utenti che pianificano viaggi informazioni di contatto, recensioni e livelli di prezzo per gli hotel lungo il percorso.
Che cosa puoi fare con l'API Places
Puoi utilizzare l'API Places per includere le seguenti funzionalità nelle tue applicazioni:
- Fornisce risultati di ricerca di luoghi da diversi tipi di query degli utenti, ad esempio input di testo, località nelle vicinanze e query degli utenti ambigue o categoriche.
- Abilita 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 per un luogo, ad esempio orario di apertura, un riepilogo, recensioni degli utenti e una foto.
- Aggiungi foto di alta qualità alle località pubblicate dalla tua applicazione.
Come funziona l'API Places
L'API Places accetta le richieste come URL standard con un endpoint di servizio specifico, ad esempio /place
o /photo
. Gli endpoint accettano anche il tipo di formato specificato nella richiesta, JSON o XML. Infine, la richiesta di servizio utilizza i parametri pertinenti per quell'endpoint specifico per perfezionare i dati restituiti.
Ad esempio, la seguente richiesta Place Details per i componenti dell'indirizzo funziona come segue, supponendo un ritorno 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 riportata di seguito riassume le risorse disponibili tramite l'API Places insieme ai dati che restituisce.
Risorse di dati | Dati restituiti | Formato restituito |
---|---|---|
Ricerca dei luoghi | Restituisce un elenco di luoghi in base alla posizione del dispositivo o alla stringa di ricerca.
Visualizza i dettagli su Inserire risposte di ricerca, Risposte di ricerca nelle vicinanze e Risposte di ricerca testuale. |
|
Dettagli del luogo | Restituisce informazioni più dettagliate su un luogo specifico, incluse le recensioni degli utenti.
Vedi i dettagli in Risposte ai dettagli del luogo. |
|
Foto del luogo | Consente di accedere ai milioni di foto correlate al luogo memorizzate nel database di Place.
Vedi i dettagli su come rispondere alle foto del luogo. |
|
Inserire il completamento automatico | Compila automaticamente il nome e/o l'indirizzo di un luogo durante la digitazione.
Vedi i dettagli per inserire risposte di completamento automatico. |
|
Completamento automatico delle query | Fornisce un servizio di previsione delle query per le ricerche geografiche basate su testo, che restituiscono query suggerite durante la digitazione degli utenti.
Visualizza i dettagli per rispondere alle risposte di completamento automatico delle query. |
|
Come utilizzare l'API Places
I passaggi riportati di seguito coprono uno scenario di caso d'uso tipico per l'utilizzo di tre degli endpoint nel servizio API Places. Durante la creazione della tua soluzione, puoi utilizzare endpoint aggiuntivi, come la ricerca nelle vicinanze, le foto del luogo e il completamento automatico delle query.1 | Configurazione | Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione che seguono, quindi scopri come utilizzare la chiave API. |
2 | Prova una ricerca di testo di base | Dopo aver creato una chiave API, esegui una semplice ricerca di testo come indicato in Esempi di ricerca di testo di base nella guida Ricerca di testo. |
3 | Utilizzare la richiesta Trova luogo | Le richieste Trova luogo restituiscono un ID luogo, insieme ai campi di dati richiesti, come orari di apertura, indirizzo e foto. Visualizzate esempi di luoghi e provatene uno più pertinente al vostro caso d'uso. |
4 | Nozioni di base sulla risposta per la ricerca di luoghi | Esplora i dati restituiti dalla risposta di Find Place. Per maggiori dettagli, consulta Trovare le risposte dei luoghi. |
5 | Usa l'ID luogo per maggiori dettagli | Le risposte Trova luoghi non forniscono tutti i dati disponibili per un determinato luogo. Per ottenere maggiori dettagli su un luogo, puoi utilizzare l'ID luogo restituito da una risposta di Find Place. Vedi Dettagli del luogo. |
Librerie client disponibili
Chiama questa API nel linguaggio che preferisci tramite una delle seguenti librerie client:
- Client Java per i servizi Google Maps
- Client Python per i servizi Google Maps
- Go Client per Google Maps Services
- Client Node.js per i servizi Google Maps
Il client Java, il client Python, il client Go e il client Node.js per i servizi Google Maps sono librerie client supportate dalla community, open source in base alla licenza Apache 2.0. Scaricali da GitHub, dove puoi anche trovare le istruzioni di installazione e il codice campione.
Passaggi successivi
- Iniziare a utilizzare la ricerca dell'API Places: vai alla pagina Place Search (Ricerca luogo).
- Ottenere una chiave API: consulta la pagina Utilizzo delle chiavi API