Ottieni e condividi la tua chiave API in modo sicuro

Per visualizzare Google Maps sul tuo sito web, devi abilitare la Maps JavaScript API, creare una chiave API e condividerla con il nostro team per l’integrazione. Il processo è semplice e ti permette di controllare su quali siti può essere utilizzata la chiave.

Requisiti e ambito

Con Google Maps potrai offrire ai tuoi clienti una visualizzazione precisa della posizione delle tue proprietà, sostituendo le mappe di Mapbox. Gestirai tu il tuo account Google e la fatturazione associata; il nostro team si occuperà dell’integrazione tecnica sul tuo sito web.

Passaggi da seguire

Abilitare le API necessarie

Accedi a https://console.cloud.google.com/.
Clicca su «Crea progetto», inserisci nome, organizzazione e posizione, poi premi «Crea».
Nel menu laterale, vai su «API e servizi».
Seleziona «Abilita API e servizi».
Cerca e seleziona Maps JavaScript API e clicca su «Abilita».

Attenzione ai dettagli
Se non trovi l’API nel pannello iniziale, usa la barra di ricerca.

Ottenere e limitare la tua chiave API

Torna su «API e servizi» → «Credenziali».
Clicca su «Crea credenziali» → «Chiave API». La tua chiave apparirà in una finestra pop-up.
Completa le informazioni di fatturazione del tuo account Google: menu «Fatturazione» → «Collega un account di fatturazione» e segui i passaggi. Se la fatturazione non viene configurata correttamente, la mappa non verrà visualizzata come previsto.
Limita l’uso della chiave: in «Restrizioni applicazione», scegli Siti web e, in «Restrizioni siti web», aggiungi i domini su cui verrà utilizzata la chiave.

Attenzione ai dettagli
Se lasci la lista dei siti web vuota, la tua chiave API accetterà richieste da qualsiasi sito, aumentando il rischio di uso improprio.

Invia la chiave API per l’attivazione

Quando hai terminato, invia la tua chiave API al team di Avantio. Il nostro team tecnico configurerà Google Maps sul tuo sito web e ti avviserà quando il lavoro sarà completato.

Consiglio utile
Gestisci tutto dalla tua area Google: conserva chiave API, fatturazione e restrizioni documentate. Ti aiuterà in caso di audit e aggiornamenti futuri.

Buone pratiche

Verifica che Maps JavaScript API sia abilitata nel progetto corretto.
Aggiungi tutti i domini e sottodomini necessari (produzione e, se serve, test).
Controlla periodicamente limiti e consumi in «Fatturazione» per evitare interruzioni del servizio.

Errori frequenti

Non completare la fatturazione: impedisce il corretto caricamento delle mappe.
Non limitare la chiave API: permette ad altri siti di utilizzarla, consumando la tua quota.
Creare la chiave e non salvarla in un posto sicuro: rende difficile la gestione e il controllo.

Con Google Maps scegli una cartografia familiare per i tuoi utenti, migliori l’esperienza di navigazione e mantieni il controllo sulla sicurezza della chiave, sulla fatturazione e sulle prestazioni del servizio.

Domande frequenti

Chi gestisce l’account e la fatturazione di Google Maps associata alla chiave API?

Gestisci tu l’account Google e la fatturazione. Avantio si occupa dell’integrazione tecnica sul tuo sito web una volta che invii la chiave API.

Quale API devo abilitare per far funzionare le mappe sul mio sito web?

Devi abilitare Maps JavaScript API nel progetto Google Cloud dove creerai la chiave API.

Perché devo configurare la fatturazione su Google Cloud per usare la chiave API?

Google richiede la fatturazione attiva per fornire le mappe. Se non la completi, la mappa non verrà visualizzata correttamente sul tuo sito web.

Come limito l’uso della mia chiave API ai miei domini?

In «Restrizioni applicazione» seleziona Siti web e aggiungi i domini in «Restrizioni siti web». Se lasci questo campo vuoto, la chiave accetterà richieste da qualsiasi sito.

Quali vantaggi ottengo integrando Google Maps invece di Mapbox?

Puoi scegliere Google Maps per mostrare la posizione delle tue proprietà con un’interfaccia riconoscibile e familiare per gli utenti, migliorando la loro esperienza di navigazione.

Integrare Google Maps nel tuo sito Web Avantio