Panoramica

Seleziona la piattaforma: Android iOS JavaScript Servizio web
L'API Places è un servizio che accetta richieste HTTP per i dati sulla posizione con diversi metodi. Restituisci dati sulla posizione formattati e immagini su strutture, posizioni geografiche o punti di interesse in evidenza.

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.

  • JSON
  • XML
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.

  • JSON
  • XML
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.

  • JSON
  • XML
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.

  • JSON
  • XML
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.

  • JSON
  • XML

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:

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