Panoramica

Seleziona la piattaforma: Android iOS JavaScript Servizio web
L'API Places è un servizio che accetta richieste HTTP per la posizione tramite vari metodi. Restituisce i dati sulla posizione formattati e immagini di stabilimenti, località geografiche o luoghi punti d'interesse.

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 completamente basati sul 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 funzioni nella tua applicazioni:

  • Fornisci risultati di ricerca sui luoghi da diversi tipi di query degli utenti, come input di testo, località nelle vicinanze e query utente ambigue o categoriche.
  • Attiva le funzionalità di completamento automatico per diversi tipi di ricerca (query di testo specifiche) o categoriche.
  • Perfeziona il tipo di dettagli restituiti per un luogo, come orari di apertura, 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 ID luogo, dove l'ID luogo è univoco identifica 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 che disponi di un ID luogo, puoi utilizzare l'API Places per richiedere ulteriori dettagli su un particolare attività o punto d'interesse, come l'indirizzo completo, il numero di telefono valutazione degli utenti e recensioni.

Scegli la tua versione di API Places

L'API Places supporta due versioni API: L'API Places API esistenti e API Places (Novità) sono le versioni di nuova generazione delle API.

Con il rilascio dell'API Places (Novità), la prima attività consiste nel decidere quale una serie di API da utilizzare. Ciò vale se sei un nuovo cliente o un cliente esistente che già utilizza le API. Utilizza le funzionalità di questa guida per apprendere le chiavi le 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 indirizzo endpoint di servizio, ad esempio /places o places:searchText e restituisce una risposta in formato JSON. L'API Places (Novità) supporta l'autorizzazione di 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 indirizzo dell'endpoint di servizio, come /place o /photo. Anche gli endpoint accettare il tipo di formato specificato nella richiesta (JSON o XML). Il 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. restituiscono i componenti dell'indirizzo in formato JSON.

Risorse

La tabella seguente riassume le risorse disponibili tramite 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 devono usare Ricerca testuale (novità) 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. Mentre crei la tua soluzione, puoi usare endpoint aggiuntivi, come Nearby Search e Place Photo.
1 Configurazione Inizia con l'articolo Configura il tuo progetto Google Cloud, completa le istruzioni di configurazione che seguono, quindi scopri come utilizzare la chiave API. Per l'API Places (novità), puoi utilizzare anche Token OAuth.
2 Provare una ricerca testuale di base Esegui una semplice ricerca testuale utilizzando Ricerca testuale (Nuova) oppure Ricerca testuale.
3 Per ulteriori dettagli, utilizza l'ID luogo Molte API di Google Maps Platform restituiscono un ID luogo in una risposta. Utilizza la 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 in Places per configurare un database. Utilizza la foto del luogo (nuova) o Place Details (Dettagli luogo) per accedere alle foto di un luogo.