La mappa Google non si carica sul sito: cosa controllare

Annotare cosa vede il visitatore

Apri la pagina da telefono e computer e annota l’indirizzo esatto, il browser e il messaggio visualizzato. Verifica se il problema riguarda tutte le sedi, una sola pagina o soltanto la versione mobile. Se la mappa torna a funzionare dopo un aggiornamento della pagina, segnala anche questa differenza: può aiutare a individuare un caricamento fuori sequenza.

Prova una sessione nuova senza modificare le preferenze del visitatore abituale. Un’estensione, una rete aziendale o una scelta di consenso può cambiare il risultato. Documentare queste condizioni aiuta chi svolge la manutenzione del sito a ripetere la verifica, anziché considerare risolto il problema perché la mappa funziona sul proprio computer.

Riconoscere come è stata inserita la mappa

La guida di Google Maps descrive la funzione di incorporamento con cui copiare il codice HTML di una località. Il normale codice ottenuto da questa funzione si distingue dall’uso programmato delle API. Anche Maps Embed API utilizza un iframe, ma l’indirizzo include il percorso /maps/embed/v1/ e una chiave.

Le mappe con filtri, molti punti o interazioni personalizzate possono invece usare Maps JavaScript API. Chiedi a chi gestisce il sito quale soluzione è presente e se dipende da un componente del CMS. La presenza di un iframe da sola non permette quindi di concludere che una chiave sia necessaria, né che sia la causa del guasto.

Verificare il caricamento dopo la scelta di consenso

Se il sito blocca la mappa prima di una scelta dell’utente, il riquadro deve spiegare cosa serve per visualizzarla. Dopo la scelta prevista, controlla che venga caricato il contenuto e che il messaggio di attesa scompaia. Una pagina che funziona soltanto dopo un secondo aggiornamento segnala un collegamento da correggere fra gestione delle preferenze e caricamento.

Verifica anche il comportamento quando l’utente non attiva il contenuto esterno. L’indirizzo della sede deve restare leggibile, con un collegamento per aprire le indicazioni nel servizio esterno. Le scelte sul trattamento e sulla necessità del consenso vanno valutate in base all’integrazione concreta; questa prova tecnica non sostituisce tale valutazione. Approfondisci l’organizzazione del banner e delle preferenze sul sito.

Controllare incorporamento e dimensioni del riquadro

Per una mappa standard, confronta il codice presente con un nuovo incorporamento della stessa località e verifica che l’editor non abbia rimosso attributi o alterato l’indirizzo. Se la sede è cambiata, controlla anche il punto mostrato: una mappa visibile ma sbagliata produce comunque un problema per chi deve arrivare.

Un contenitore senza altezza, una scheda inizialmente nascosta o una regola mobile possono far sembrare assente una mappa caricata. Controlla dimensioni, visibilità e contenuti sovrapposti. Per Maps Embed API, la documentazione ufficiale dell’incorporamento indica dimensioni minime di 200 pixel per lato. La correzione deve mantenere leggibile la pagina anche sugli schermi piccoli.

Leggere gli errori API e correggere la causa precisa

Con Maps JavaScript API, il messaggio in pagina può essere generico: chi svolge la diagnosi deve leggere anche la console del browser. Google elenca i codici di errore e le relative verifiche. Una chiave assente, un servizio non abilitato, un dominio non autorizzato e un problema di fatturazione richiedono interventi differenti.

Per esempio, RefererNotAllowedMapError richiede di controllare se il dominio che usa la mappa è autorizzato. Mantieni le restrizioni della chiave e correggi l’elenco dei riferimenti consentiti; non risolvere eliminando le protezioni. Controlla inoltre progetto proprietario, API effettivamente utilizzate, quote e stato della fatturazione quando richiesti dal servizio adottato. Una vecchia chiave gestita dal precedente fornitore va affrontata come problema di titolarità e configurazione.

Rendere la sede raggiungibile anche senza mappa

Nella pagina Contatti scrivi indirizzo completo, ingresso corretto e informazioni utili per arrivare. Un collegamento con un’etichetta come “Apri le indicazioni per la sede di Roma” è più comprensibile di un’icona isolata. Verifica che punti alla destinazione giusta, soprattutto se esistono più uffici.

Per accessi da cortili, parcheggi o zone industriali, poche istruzioni concrete possono essere più utili dello zoom iniziale. Provale con una persona che non conosce la sede. L’alternativa rimane utile anche dopo la riparazione, per chi preferisce aprire l’app di navigazione o non carica contenuti di terze parti.

Esempio ipotetico: la mappa si ferma dopo il restyling

Un’azienda pubblica il nuovo sito su un sottodominio utilizzato per le prenotazioni. La pagina principale mostra la mappa, mentre quella nuova restituisce un errore. Il tecnico riconosce Maps JavaScript API e trova in console un riferimento non consentito.

La verifica mostra che la chiave è autorizzata soltanto per il sito principale. Si aggiunge il dominio effettivamente necessario mantenendo le restrizioni, poi si ripete la prova nelle pagine coinvolte. Nell’esempio non serviva cambiare località o acquistare un nuovo componente: l’errore dipendeva dalla configurazione del servizio rispetto all’indirizzo di pubblicazione.

Checklist dopo la correzione

La verifica conclusiva deve ripetere le condizioni in cui il problema era comparso. Il controllo della sola anteprima del CMS non è sufficiente.

• La mappa appare nell’indirizzo pubblico corretto.
• Telefono e computer mostrano un riquadro utilizzabile.
• La sede e l’ingresso corrispondono alle indicazioni testuali.
• Le preferenze dell’utente producono il comportamento previsto.
• Il percorso funziona anche dopo una visita nuova.
• Console e configurazione non mostrano errori pertinenti irrisolti.
• Le chiavi mantengono restrizioni coerenti con il servizio.
• Indirizzo e collegamento esterno restano sempre disponibili.

Registra causa, intervento e responsabile degli accessi. Queste informazioni rendono più semplice intervenire al prossimo cambio di dominio, componente o fornitore.

Domande frequenti

Una mappa bianca significa sempre chiave API errata?

No. Può dipendere dal contenitore, dal caricamento dopo il consenso, da un incorporamento alterato o dalla rete. Identifica prima il tipo di mappa e le condizioni dell’errore.

Posso rimuovere tutte le restrizioni della chiave?

Mantieni le protezioni e correggi domini, API o impostazioni necessari. Una chiave senza restrizioni può essere utilizzata impropriamente e non rappresenta una correzione adeguata.

La mappa incorporata serve per comparire su Google Maps?

La mappa nella pagina aiuta a raggiungere una sede. La presenza dell’attività su Google Maps e la gestione della relativa scheda sono attività distinte dalla correzione dell’incorporamento.