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.
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.
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
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.000 | 100,001–500,000 | 500,000+ | |
| Autocompletamento | 0,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 query | 0,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 luogo | 0,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 luoghi | 0,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 | |
| Cerca | 0,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.


