Panoramica

Seleziona la piattaforma: Android iOS JavaScript Servizio web
Sviluppatori dello Spazio economico europeo (SEE)

Introduzione

L'API Places è un servizio che accetta richieste HTTP per i dati sulla posizione tramite una serie di metodi. Restituisce dati sulla posizione e immagini formattati di attività, località geografiche o punti di interesse importanti.

Perché utilizzare l'API Places (Novità)

Crea funzionalità basate sulla posizione per rendere disponibili agli utenti dati dettagliati sulla posizione. I dati disponibili tramite l'API Places (Novità) si basano su uno dei modelli di luoghi del mondo reale più precisi, aggiornati e completi. Ecco alcuni casi d'uso di esempio per le applicazioni:

  • Mostra gli affitti di appartamenti in condominio 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 una zona insieme a foto e recensioni inviate dagli utenti.
  • Fornisci alle persone che pianificano viaggi informazioni di contatto, recensioni, e livelli di prezzo per le attività lungo il percorso.

Cosa si può fare con l'API Places (Novità)

Puoi utilizzare l'API Places (Novità) 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, query di testo specifiche o query categoriche.
  • Perfeziona il tipo di dettagli restituiti su un luogo, come orari di apertura, riepilogo, recensioni degli utenti e foto.
  • Aggiungi foto di alta qualità alle località servite dalla tua applicazione.

Molte API 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, tra cui da l'API Places (Novità), ma anche da l'API Geocoding, l'API Routes e l'API Address Validation.

Una volta ottenuto un ID luogo, puoi utilizzare l'API Places (Novità) per richiedere ulteriori dettagli su una determinata attività o un punto di interesse, come indirizzo completo, numero di telefono, valutazione degli utenti e recensioni.

Come funziona l'API Places (Novità)

L'API Places (Novità) accetta le richieste come URL standard con un endpoint di servizio specifico, ad esempio /places o places:searchText, e restituisce una risposta JSON. L'API Places (Novità) supporta l'autorizzazione tramite chiave API e token OAuth. L'esempio seguente effettua una richiesta di dettagli del luogo (Novità) 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 (Novità)

I passaggi riportati di seguito riguardano un tipico scenario di utilizzo del servizio API Places. Man mano che sviluppi la tua soluzione, puoi utilizzare endpoint aggiuntivi, come Nearby Search (Novità) e Place Photos (Novità).
1 Configurazione Configura la fatturazione, attiva l'API Places (Novità) ed effettua la prima richiesta.
2 Prova una ricerca di testo di base Esegui una ricerca testuale utilizzando Ricerca testuale (Novità).
3 Utilizza l'ID luogo per ulteriori dettagli Molte API Google Maps Platform restituiscono un ID luogo come parte di una risposta. Utilizza gli ID luogo per ottenere i dettagli del luogo (Novità).
4 Ottieni una foto di un luogo Place Photos (Novità) ti consente di accedere a milioni di foto archiviate nel database di Places. Utilizza Foto del luogo (Novità) per accedere alle foto di un luogo.