Come usare Google Places API e ottenere una chiave API

Cos’è Google Places API

Places API è un servizio che restituisce informazioni sui luoghi tramite richieste HTTP. Qui i luoghi sono generalmente definiti come attività commerciali, località geografiche o punti di interesse rilevanti. 

All’interno dell’API sono disponibili cinque tipi di richieste. Sono:

• Place Search che restituisce una lista di luoghi basata sulla posizione dell’utente o su una stringa di ricerca.
• Dettagli luogo che fornisce informazioni dettagliate su un luogo specifico, incluse le recensioni degli utenti.
• Foto luogo che consente l’accesso a milioni di foto relative ai luoghi archiviate nel database di Google Places.
• Recensioni luogo permette di recuperare e incorporare le recensioni Google dalla piattaforma.
• Completamento automatico luogo serve a completare automaticamente il nome o l’indirizzo di un luogo mentre l’utente digita.
• Completamento automatico query offre un servizio di predizione delle query per ricerche geografiche basate su testo, suggerendo query mentre l’utente scrive.

Per lavorare con Places API è necessaria una chiave da includere in ogni richiesta. Scopriamo cos’è esattamente e come ottenere la chiave API per Google Places API. 

Come creare una chiave API di Google Places

La chiave API è un identificatore univoco che serve ad autenticare le richieste associate al tuo progetto per scopi di utilizzo e fatturazione. Usando una chiave API per autenticare le richieste, puoi:

• Gestire le tue API nella Google Cloud Console.
• Accedere ai dati di utilizzo in tempo reale e ai dati storici degli ultimi 30 giorni nella Google Cloud Platform Console. 
• Consultare report di utilizzo con informazioni oltre i 30 giorni nel Google Cloud Support Portal.

Puoi trovare maggiori informazioni sui report disponibili per i clienti del Piano Premium qui. Ora puoi procedere a ottenere la chiave. 

Se vuoi, puoi sempre provare un modo alternativo per aggiungere recensioni clienti al tuo sito. Ad esempio, c’è il widget Google Reviews di Elfsight – non devi preoccuparti di ottenere chiavi API o imparare a programmare.

Ottieni la tua chiave Places API e aggiungila alla tua richiesta

Per ottenere la tua chiave API, devi seguire questi passaggi:

• Apri la Google Cloud Platform Console.
• Clicca sul menu a tendina del progetto e seleziona il progetto creato per te. Il nome dovrebbe iniziare con Google Maps APIs for Business o Google Maps for Work o Google Maps.
• Quindi clicca sul pulsante menu e scegli API e servizi > Credenziali.
• Nella pagina Credenziali, seleziona Crea credenziali > Chiave API. Vedrai una finestra di dialogo che mostra la chiave API appena creata.
• Chiudi la scheda. La tua nuova chiave API è elencata nella pagina credenziali sotto la sezione Chiavi API.

Poi devi aggiungere la chiave API a ogni richiesta Places API. Nell’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

Ricorda che Google consiglia vivamente di limitare l’uso della 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 l’uso della tua chiave API di Google Places

Ci sono due tipi di restrizioni che devi configurare entrambe. Sono:

• Restrizione applicazione. Questa funzione ti permette di limitare l’uso della chiave API a siti web, server web o app mobili. Puoi scegliere solo una restrizione 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:

• Aprire la Google Cloud Console.
• Cliccare sul menu a tendina del progetto e selezionare il progetto contenente la chiave API da proteggere.
• Cliccare sul pulsante menu e scegliere API e servizi > Credenziali.
• Cliccare sul nome della chiave API da proteggere nella pagina Credenziali. 
• Impostare le restrizioni nella pagina Limita e rinomina chiave API. 

Dopo aver impostato le restrizioni, non resta che cliccare sul pulsante Salva. 

Esempi di utilizzo di Google Places API

Ci sono diversi modi per usare Google Places API. Vediamone alcuni.

Ricerca Luoghi

Come detto prima, Places API ti permette di cercare informazioni sui luoghi usando un gran numero di categorie. Il seguente esempio 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 Luogo

Una volta ottenuto un place_id da una ricerca Google Places, puoi richiedere informazioni più dettagliate su un’attività o punto di interesse specifico tramite una richiesta Place Details. Ecco un esempio di richiesta dettagli per 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

Foto Luogo

Questo servizio ti permette di aggiungere contenuti fotografici alle tue applicazioni. Offre accesso a milioni di foto archiviate nel database Places. Ecco un esempio di richiesta:

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

Completamento Automatico Luogo

È un servizio web che restituisce previsioni di luoghi in risposta a una richiesta HTTP. Può essere usato per fornire la funzione di completamento automatico nelle ricerche geografiche basate su testo. Ecco un esempio di richiesta per attività commerciali:

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 Automatico Query

Questo tipo di servizio fornisce una predizione delle query per ricerche geografiche basate su testo, restituendo suggerimenti mentre 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

Google utilizza un modello di prezzo pay-as-you-go. Questo significa che le API della Google Maps Platform sono fatturate per SKU. L’utilizzo viene tracciato per ogni SKU di prodotto, e un’API può avere più SKU di prodotto. 

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

Puoi consultare la documentazione di Google Places API per maggiori dettagli su prezzi e limiti. 

Domande Frequenti

Conclusione

Ora hai una panoramica su come ottenere la chiave API di Google Maps Places. Come avrai notato, è molto semplice e richiede meno di 5 minuti. L’unica cosa da sapere prima di iniziare è il tipo di API con cui intendi lavorare.