IT
Prova gratis

Chiave API Google Maps

Attiva la mappa e il completamento automatico degli indirizzi Google nel tuo modulo: creare un account Google Cloud, attivare le API, creare e limitare la chiave.

Aggiornato agosto 2026

Il tuo modulo di prenotazione funziona senza alcuna chiave: gli indirizzi sono proposti da un servizio di ricerca integrato e la mappa si appoggia a uno sfondo OpenStreetMap. Inserendo la tua chiave API Google Maps, sostituisci questi servizi con quelli di Google: suggerimenti di indirizzo Google, mappa Google Maps e calcolo dell’itinerario Google. È un’opzione, ma è quella che offre ai tuoi clienti l’esperienza di inserimento indirizzo più familiare.

Che cosa cambia la chiave nel tuo modulo

  • Ricerca degli indirizzi — i campi Indirizzo di partenza e Indirizzo di arrivo propongono i suggerimenti Google Places, gli stessi di Google Maps.
  • Mappa — se l’opzione Mostra la mappa è attiva, il modulo mostra una mappa Google Maps al posto dello sfondo OpenStreetMap.
  • Itinerario, distanza e durata — il tragitto è calcolato da Google Directions: il percorso compare sulla mappa, con la distanza e il tempo di percorrenza.
  • Prenotazioni create a mano — nella tua area di amministrazione, anche l’inserimento dell’indirizzo di una prenotazione creata manualmente beneficia del completamento automatico Google.
  • Restrizione per Paese — se hai limitato la ricerca degli indirizzi a un Paese nelle Impostazioni, quella restrizione si applica anche ai suggerimenti Google.

Passaggio 1 — Creare un account Google Cloud

  1. Vai su cloud.google.com.
  2. Fai clic su Inizia gratuitamente (o Inizia ora) e accedi con un account Google — preferibilmente quello della tua attività.
  3. Inserisci i dati di registrazione: dati della tua azienda e carta di credito. La carta serve a verificare che non sei un robot; Google non addebita nulla durante il periodo di prova.
  4. Una volta convalidata la registrazione, arrivi nella console Google Cloud.

Verifica infine che sia selezionato un progetto in alto nella console (Google ne crea uno automaticamente, spesso chiamato « My First Project »). Tutti i passaggi seguenti si applicano al progetto visualizzato.

Passaggio 2 — Attivare le quattro API

Il modulo utilizza quattro API Google. Tutte e quattro devono essere attivate, altrimenti la ricerca degli indirizzi o la mappa resta muta. Apri ciascun link, verifica che il progetto mostrato in alto sia quello giusto, poi fai clic su Attiva:

Se al posto di Attiva compare un pulsante Gestisci, significa che l’API è già attiva: passa alla successiva.

Passaggio 3 — Creare la chiave API

  1. Nella console, apri API e servizi › Credenziali.
  2. Fai clic su Crea credenziali, poi su Chiave API.
  3. Google mostra la tua chiave, una lunga sequenza di caratteri che inizia generalmente con AIza. Copiala: dovrai incollarla in ClickChauffeur.

Passaggio 4 — Limitare la chiave

Una chiave senza restrizioni può essere riutilizzata da chiunque e fatturata sul tuo account. Prenditi due minuti per limitarla. Nella pagina Credenziali, fai clic sul nome della tua chiave, poi:

  • Restrizioni relative alle applicazioni — scegli Siti web e aggiungi l’indirizzo https://app.clickchauffeur.com/*.
  • Restrizioni relative alle API — scegli Limita chiave e seleziona unicamente le quattro API del passaggio 2.

Salva. Le modifiche possono richiedere qualche minuto per propagarsi lato Google.

Passaggio 5 — Inserire la chiave in ClickChauffeur

  1. Nella tua area ClickChauffeur, apri la sezione Integrazione web.
  2. Nella personalizzazione del modulo, espandi il pannello Google Maps.
  3. Incolla la tua chiave nel campo Google Maps API.
  4. Fai clic su Salva.

L’anteprima del modulo si ricarica: digita un indirizzo in Indirizzo di partenza, devono comparire i suggerimenti Google. Se hai attivato Mostra la mappa, la mappa assume l’aspetto di Google Maps.

Rimuovere la chiave

Svuota semplicemente il campo Google Maps API in Integrazione web, poi Salva. Il modulo torna immediatamente alla ricerca di indirizzi integrata e allo sfondo cartografico OpenStreetMap: non si perde nulla e nessuna prenotazione viene toccata.

In caso di problemi

  • Nessun suggerimento di indirizzo — la Places API o la Places API (New) non è attivata sul progetto della chiave, oppure la chiave è stata ricopiata male.
  • La mappa resta vuota o grigia — la Maps JavaScript API non è attivata, oppure l’account di fatturazione non è attivo sul progetto.
  • Indirizzi corretti ma né distanza né durata — la Directions API non è attivata.
  • Funzionava, poi più nulla — verifica che l’account non sia rimasto in un periodo di prova scaduto (vedi il passaggio 1) e che non sia stata raggiunta alcuna quota in API e servizi › Quote.
  • I suggerimenti ignorano alcuni Paesi — è la restrizione per Paese delle tue Impostazioni, non la chiave.