Introduzione
L'API Places è un servizio che accetta richieste HTTP per i dati sulla posizione tramite una serie di metodi. Restituisce dati sulla posizione formattati e immagini di strutture, località geografiche o punti d'interesse prominenti.Perché utilizzare l'API Places (New)
Crea funzionalità basate sulla posizione per rendere disponibili ai tuoi utenti dati sulla posizione dettagliati. I dati disponibili tramite l'API Places (New) si basano su uno dei modelli di luoghi più precisi, aggiornati e completi del mondo reale. Ecco alcuni casi d'uso per le applicazioni:
- Mostra gli affitti di condomini nelle principali aree metropolitane con risultati che hanno come target specifico le città.
- Includi i dettagli del luogo in un aggiornamento dello stato di ritiro o consegna.
- Mostra un elenco di parchi in una zona insieme a foto e recensioni inviate dagli utenti.
- Fornire a chi pianifica viaggi informazioni di contatto, recensioni e livelli di prezzo per le strutture lungo il percorso.
Cosa puoi fare con l'API Places (nuova)
Puoi utilizzare l'API Places (New) per includere le seguenti funzionalità nelle tue applicazioni:
- Fornisci risultati di ricerca di 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, ovvero query di testo specifiche o 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à coperte dalla tua applicazione.
Molte API 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 (New), ma anche dall'API Geocoding, dall'API Routes e dall'API Address Validation.
Una volta ottenuto un ID luogo, puoi utilizzare l'API Places (New) per richiedere ulteriori dettagli su un'attività o un punto di interesse specifico, come indirizzo completo, numero di telefono, valutazione degli utenti e recensioni.
Come funziona l'API Places (New)
L'API Places (New) accetta le richieste come URL standard con un
endpoint di servizio specifico, ad esempio /places o
places:searchText e restituisce una risposta JSON.
API Places (New) supporta l'autorizzazione tramite chiave API e token OAuth.
L'esempio seguente effettua una richiesta Place 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 (New)
I passaggi riportati di seguito riguardano un tipico scenario di caso d'uso per l'utilizzo del servizio API Places. Man mano che sviluppi la tua soluzione, puoi utilizzare endpoint aggiuntivi, come Nearby Search (New) e Place Photos (New).| 1 | Configurazione | Configura la fatturazione, abilita l'API Places (New) ed effettua la tua prima richiesta. |
| 2 | Provare una ricerca testuale di base | Esegui una ricerca di testo utilizzando Ricerca di testo (nuova). |
| 3 | Utilizzare l'ID luogo per maggiori dettagli | Molte API Google Maps Platform restituiscono un ID luogo come parte di una risposta. Utilizza gli ID luogo per ottenere Dettagli luogo (nuovo). |
| 4 | Ottenere una foto per un luogo | Foto del luogo (nuovo) ti consente di accedere a milioni di foto archiviate nel database di Places. Utilizza Foto del luogo (nuovo) per accedere alle foto di un luogo. |