Lingua:

Come usare l’API Google Places e ottenere una chiave API

Se cerchi una guida completa per iniziare con Google Places API, eccola qui. Oggi vedremo cosa fa davvero questo strumento, vedremo esempi, ti mostreremo come ottenere una chiave API e i relativi limiti e prezzi.
Scopri cosa ne pensa ChatGPT Apri l’editor del widget in tempo reale
How to use Google Places API and get an API key

Cos’è Google Places API

L’API Places è un servizio che restituisce informazioni sui luoghi tramite richieste HTTP. I luoghi definiti da questa API sono tipicamente attività, posizioni geografiche o punti di interesse principali.

Ci sono cinque tipi di richieste disponibili nell’API. Sono:

  • Ricerca di luoghi che restituisce un elenco di luoghi in base alla posizione dell’utente o al testo di ricerca.
  • Dettagli del luogo che forniscono informazioni dettagliate su un luogo specifico, incluse le recensioni degli utenti.
  • Foto dei luoghi offre accesso a milioni di foto legate ai luoghi conservate nel database dei luoghi di Google.
  • Recensioni sui luoghi ti permettono di ottenere e integrare le recensioni Google dalla piattaforma.
  • Autocompletamento dei luoghi serve a compilare automaticamente il nome o l’indirizzo di un luogo mentre gli utenti digitano.
  • Autocompletamento query offre un servizio di previsione delle query per ricerche geografiche basate su testo, restituendo query suggerite man mano che l’utente digita.

Per utilizzare l’API Places è necessaria una chiave che deve essere inclusa in ogni richiesta all’API Places. Scopriamo di cosa si tratta esattamente e come ottenere la chiave API per Google Places API. 

Come creare una chiave API Google Places

La chiave API è un identificatore unico che serve ad autenticare le richieste associate al tuo progetto per uso e fatturazione. Utilizzando una chiave API per autenticare le richieste, puoi:

  • Gestisci le API in Google Cloud Console.
  • Accedi ai dati di utilizzo in tempo reale e a 30 giorni di dati storici di utilizzo nella Console Google Cloud Platform.
  • Consulta i report sull’utilizzo con oltre 30 giorni di dati nel Google Cloud Support Portal.

Puoi trovare ulteriori informazioni sui report disponibili ai clienti del Piano Premium qui. Ora puoi procedere a ottenere la chiave. 

Hai sempre la libertà di provare un modo alternativo per aggiungere le recensioni dei clienti al tuo sito. Ad esempio, c’è il Widget Recensioni Google di Elfsight — non dovrai preoccuparti di ottenere chiavi API o imparare a programmare.

Ottieni la tua chiave API Places e aggiungila alla tua richiesta

Per ottenere la tua chiave API, devi eseguire i seguenti passaggi:

  • Apri la Console di Google Cloud Platform.
  • Clicca sull’elenco a discesa del progetto e scegli quello creato per te. Il nome dovrebbe iniziare con Google Maps APIs for Business o Google Maps for Work o Google Maps.
  • Poi fai clic sul pulsante del menu e scegli API e servizi > Credenziali.
  • Nella pagina Credenziali, scegli Crea credenziali > Chiave API. Lì vedrai una finestra di dialogo che mostra la chiave API appena creata.
  • Chiudi questa scheda. La tua nuova chiave API è elencata nella pagina delle credenziali, nella sezione Chiavi API.
Suggerimento: dovresti avere almeno una chiave API associata al tuo progetto.

Poi devi aggiungere la chiave API a ogni richiesta della Places API. Usando l’esempio seguente, sostituisci semplicemente YOUR_API_KEY con la tua chiave API:

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?location=-33.8670522,151.1957362
  &radius=500
  &types=food
  &name=harbour
  &key=YOUR_API_KEY

Tieni presente che Google raccomanda vivamente di limitare la tua chiave API. Le restrizioni aumentano la sicurezza e aiutano a garantire che solo richieste autorizzate vengano effettuate con la tua chiave API.

Come limitare la chiave API di Google Places

Ci sono due restrizioni che devi configurare entrambe. Sono:

  • Restrizione dell’applicazione. Questa funzione permette di limitare l’utilizzo della chiave API a siti web, server web o app mobili. È possibile scegliere solo una restrizione tra quelle di questa categoria.
  • Restrizione API. Questo tipo di restrizione limita l’uso della chiave API a una o più API o SDK.

Per limitare la tua chiave API, devi:

  • Apri Google Cloud Console.
  • Clicca sul menu a discesa del progetto e seleziona quello che contiene la chiave API che vuoi proteggere.
  • Clicca sul pulsante del menu e scegli API e Servizi > Credenziali.
  • Clicca sul nome della chiave API che devi mettere al sicuro nella pagina Credenziali.
  • Imposta le restrizioni sulla pagina della chiave API.
Suggerimento: Ricorda che l’API Places non funziona con una chiave API limitata per Android o iOS.

Una volta impostate le restrizioni, non resta che cliccare sul pulsante Salva. <br><br>

Esempi di utilizzo dell’API Google Places

Esistono diversi modi per utilizzare Google Places API. Vediamone alcuni.

Ricerca di luoghi

Come accennato in precedenza, l’API Places ti permette di cercare informazioni sui luoghi utilizzando un gran numero di categorie. L’esempio seguente di Google Places API mostra una richiesta Find Place per “Museum of Contemporary Art Australia”:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY

Dettagli del posto

Una volta ottenuto un place_id da una ricerca di Google Places, puoi ottenere ulteriori informazioni su un determinato locale o punto di interesse avviando una richiesta Place Details. Qui vediamo una richiesta di dettagli di un luogo tramite place_id:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY

Posiziona Foto

Questo servizio ti consente di aggiungere contenuti fotografici alle tue applicazioni. Ti permette di accedere a milioni di foto memorizzate nel database Places. Ecco una richiesta di esempio:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY"> 

Autocompletamento dei luoghi

È un servizio web che restituisce previsioni di luoghi come risposta a una richiesta HTTP. Può essere utilizzato per offrire la funzionalità di autocompletamento per ricerche geografiche testuali. Ecco un esempio di una richiesta per attività:

https://maps.googleapis.com/maps/api/place/autocomplete/xml?input=Amoeba&types=establishment&location=37.76999,-122.44696&radius=500&key=YOUR_API_KEY

Completamento query

Questo tipo di servizio fornisce previsioni di ricerca per query geografiche basate su testo, restituendo suggerimenti man mano che l’utente digita. Un esempio di richiesta è il seguente:

https://maps.googleapis.com/maps/api/place/queryautocomplete/json?key=YOUR_API_KEY&input=pizza+near%20par
Consiglio: Per far funzionare tutti gli esempi sopra riportati, sostituisci la chiave API con quella che hai.

Prezzi e limiti di Google Places API

Qui Google adotta un modello di prezzo pay-as-you-go. Ciò significa che le API della Google Maps Platform sono fatturate per SKU. L’uso è monitorato per ogni SKU di prodotto, e un’API può avere più di uno SKU di prodotto.

Ci sono 1.000 richieste gratuite alle Places API ogni 24 ore, ma è possibile aumentarle fino a 150.000 richieste gratuite in 24 ore attivando la fatturazione nella Google Cloud Console.

Intervallo di volume mensile (Prezzo per CHIAMATA)0–100.000100,001–500,000500,000+
Autocompletamento0,00283 USD per ciascun (2,83 USD per 1.000)0,00227 USD ciascuno (2,27 USD per 1000)Contatta le vendite per tariffe in base al volume
Autocompletamento query0,00283 USD per ogni elemento
(2,83 USD per 1.000)
0,00227 USD ciascuno (2,27 USD per 1000)Contatta le vendite per tariffe in base al volume
Dettagli del luogo0,017 USD ciascuno (17,00 USD per 1000)0,0136 USD ciascuno (13,60 USD per 1.000)Contatta le vendite per tariffe in base al volume
Foto dei luoghi0,007 USD ciascuno (7,00 USD per 1000)0,0056 USD ciascuno (5,60 USD per 1000)Contatta le vendite per tariffe in base al volume
Cerca0,032 USD ciascuno (32,00 USD per 1000)0,0256 USD ciascuno (25,60 USD per 1000)Contatta le vendite per tariffe in base al volume

Puoi consultare la documentazione dell’API Google Places per ulteriori dettagli su prezzi e limiti. documentazioneper ulteriori dettagli sui prezzi e sui limiti. 

FAQ (Domande frequenti)

Il servizio Google Places API è gratuito?

Places API utilizza un modello di prezzo pay-as-you-go. Per ulteriori dettagli sui prezzi, consulta la tabella sopra o consulta la documentazione.

Come posso utilizzare l’API di Google Places?

Per utilizzare questa funzione, serve una chiave API. Puoi ottenerla tramite Cloud Console: clicca sull’elenco a discesa del progetto e seleziona quello creato per te.

Come posso aggiungere o modificare i luoghi?

Se sei il proprietario dell’attività, puoi gestirla direttamente su Google Maps tramite Google My Business. Se non possiedi il luogo che vuoi modificare, puoi comunque proporre modifiche.

Come posso iniziare a utilizzare le API per il mio sito?

Innanzitutto, chiarisci quale API ti serve esattamente. Dai un’occhiata alle guide Panoramica, Sviluppatore e Inizia per l’API o SDK che ti interessa.

Conclusione

Ora hai chiaro come ottenere una chiave API di Google Places. Come avrai notato, è molto semplice e in realtà non richiede più di 5 minuti. L’unica cosa da avere chiara prima di iniziare è il tipo di API con cui intendi lavorare.

Articolo di
Gestore contenuti
Come Content Manager di Elfsight, mi concentro nel creare contenuti pratici e ispiranti. Amo semplificare concetti complessi e renderli facili e piacevoli da leggere.