Messaggi di errore

Hai bisogno di assistenza da parte di una persona?
Vai alla pagina Assistenza di Google Maps Platform.
Questa pagina dei messaggi di errore è solo per riferimento. Il suo scopo è aiutarti a risolvere autonomamente gli errori dell'API Maps JavaScript. Se provi a chiedere aiuto a una persona inviando un feedback tramite questa pagina, non raggiungerai nessuno che possa aiutarti. Tuttavia, se rilevi un problema con i contenuti di questa pagina, ti invitiamo a comunicarcelo tramite il link per il feedback. Grazie.

Questa pagina descrive i messaggi di errore che possono essere restituiti dall'API Maps JavaScript. L'API Maps JavaScript scrive messaggi di errore e avviso nella console JavaScript. Possono anche verificarsi determinate condizioni di errore, che comportano la visualizzazione di una mappa scura.

Se NON sei il proprietario del sito web, non puoi intraprendere alcuna azione per correggere questi errori. Tuttavia, potresti voler informare il proprietario del sito, se possibile.

Errori di fatturazione e chiave API

Risolvere i problemi

In alcuni casi, potrebbe essere visualizzata una mappa scura o un'immagine di Street View "negativa", con filigrana con il testo "solo a scopo di sviluppo". Questo comportamento indica in genere problemi con una chiave API o con la fatturazione. Per utilizzare i prodotti Google Maps Platform, la fatturazione deve essere abilitata sul tuo account e tutte le richieste devono includere una chiave API valida. Per informazioni su come trovare i messaggi di errore, consulta la sezione Verificare gli errori del browser.

La procedura riportata di seguito ti aiuterà a risolvere il problema.

Stai utilizzando una chiave API?

Non saprei. Come faccio a verificare se sto utilizzando una chiave API?

Una chiave API viene trasmessa come parametro key nell'URL utilizzato per caricare l'API Maps JavaScript. Ecco alcune opzioni per verificare se stai utilizzando una chiave API:

• Utilizza l'estensione di Chrome Google Maps Platform API Checker. In questo modo puoi determinare se il tuo sito web implementa correttamente le API di Google Maps autorizzate di Google.
• Se utilizzi una libreria o un plug-in per caricare l'API Maps JavaScript, controlla le impostazioni della libreria e cerca un'opzione relativa alla chiave API.
• Controlla gli errori del browser. Se vengono visualizzati i seguenti messaggi, significa che non stai utilizzando correttamente la tua chiave API:
• Avviso relativo all'API Google Maps JavaScript: NoApiKeys
• Errore dell'API Google Maps JavaScript: MissingKeyMapError

Per gli sviluppatori web:

• Se hai accesso al codice sorgente della tua applicazione, cerca il tag <script> utilizzato per caricare l'API Maps JavaScript. Quando carichi l'API Maps JavaScript, sostituisci YOUR_API_KEY nel codice seguente con la tua chiave API.

    <script async defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>
  

• Controlla il traffico di rete generato dal tuo sito web nel browser. In Chrome, può essere visualizzato utilizzando la scheda DevTools Rete. Qui vedrai le richieste di rete effettuate dal tuo sito web. Le richieste effettuate utilizzando l'API Maps JavaScript si troveranno nel percorso maps/api/js. Qui puoi verificare se le richieste utilizzano il parametro key. Potrebbe essere utile filtrare il traffico di rete di maps/api/js quando visualizzi la scheda Rete.

No, non sto utilizzando una chiave API.

Per ottenere una chiave API, fai clic sul pulsante di seguito. Se non visualizzi una configurazione guidata, segui le istruzioni complete nella pagina Iniziare a utilizzare Google Maps Platform.
Inizia

Sì, sto utilizzando una chiave API.

Bene. Andiamo avanti e controlliamo se un account di fatturazione è collegato al tuo progetto.

Un account di fatturazione è collegato al tuo progetto?

Non saprei. Come faccio a controllare se l'account di fatturazione è collegato al mio progetto?

Vai alla pagina Fatturazione nella console Google Cloud e seleziona il progetto in base al quale è stata creata la chiave API. Per confermare che la chiave è associata al progetto:

1. Vai alla sezione Credenziali, a cui puoi accedere dalla barra laterale sinistra in Google Maps Platform > Credenziali.
2. Verifica che la chiave API che utilizzi attualmente sul tuo sito web sia elencata. In caso contrario, passa a un altro progetto e controlla le credenziali lì.
3. Se non riesci a trovare il progetto per la tua chiave API, potresti aver perso l'accesso a questo progetto. Chiedi aiuto ad altri membri della tua organizzazione. Se non è possibile trovare il progetto originale, devi:
   1. Crea un nuovo progetto. A questo scopo, seleziona Nuovo progetto dall'elenco dei progetti oppure seleziona Crea progetto nella pagina Resource Manager.
   2. Creazione di una nuova chiave API. Questa operazione può essere eseguita nella pagina Credenziali. In seguito, fai clic su Crea credenziali e seleziona Chiave API.

Dopo aver individuato il progetto nella console Cloud, controlla se un account di fatturazione è collegato accedendo alla sezione Fatturazione nel menu a sinistra.

No, un account di fatturazione non è collegato al mio progetto.

Vai alla pagina Abilita fatturazione in Cloud Console e aggiungi un account di fatturazione al tuo progetto. Per ulteriori informazioni, consulta la Guida introduttiva all'utilizzo di Google Maps Platform.

Sì, un account di fatturazione è collegato al mio progetto.

Bene. Verifica che il metodo di fatturazione specificato sia valido.

Il metodo di fatturazione fornito non è più valido (ad esempio una carta di credito scaduta)?

Puoi aggiungere, rimuovere o aggiornare un metodo di pagamento nella console Cloud.

Esiste un limite giornaliero autoimposto che è stato superato per l'API?

Se hai impostato un limite giornaliero per una delle tue API, il che è comune per evitare aumenti imprevisti, puoi risolvere il problema aumentando il limite giornaliero.

Puoi controllare i tuoi limiti giornalieri visitando la dashboard di API e servizi in Cloud Console. Da qui:

1. Seleziona un progetto, se richiesto.
2. Seleziona un'API dall'elenco, poi fai clic sulla scheda Quote.

La tua chiave API ha una limitazione relativa agli indirizzi IP?

Le chiavi API con una limitazione relativa agli indirizzi IP possono essere utilizzate solo con i servizi web destinati all'uso dal lato server (come l'API Geocoding e altre API dei servizi web). La maggior parte di questi servizi web ha servizi equivalenti all'interno dell'API Maps JavaScript (ad esempio, consulta il servizio Geocoding). Per utilizzare i servizi lato client dell'API Maps JavaScript, devi creare una chiave API separata che può essere protetta con una limitazione dei referrer HTTP (consulta la sezione Ottenere, aggiungere e limitare una chiave API).

Codici di errore dell'API Maps JavaScript per sviluppatori e proprietari di siti

Le seguenti tabelle elencano i possibili codici di errore restituiti dall'API Maps JavaScript, con una descrizione della causa e di come risolvere il problema. Per informazioni su come trovare i messaggi di errore, consulta la sezione Verificare gli errori del browser.

Errori di caricamento della mappa

Se si verifica un errore durante il caricamento dell'API Maps JavaScript, consulta la tabella riportata di seguito per trovare le spiegazioni dei codici di errore.

Codice di errore	Messaggio	Descrizione
NotLoadingAPIFromGoogleMapsError	L'API Maps JavaScript deve essere scaricata direttamente dai server di Google.	L'elemento script che carica l'API Maps JavaScript non è stato incluso correttamente nella tua pagina. Affinché l'API funzioni correttamente, deve essere caricata direttamente da https://maps.googleapis.com. Consulta la pagina Caricamento dell'API Maps JavaScript.
TOSViolationMapError	Sembra che questo sito web violi i Termini di servizio dell'API di Google Maps. L'API di Google Maps è stata disattivata per questo sito web.	A seguito di numerose notifiche via email, la tua applicazione è stata bloccata perché non rispetta i Termini di servizio di Google Maps Platform. Per presentare ricorso contro il blocco e richiedere la revisione della tua implementazione, compila questo modulo. Riceverai una risposta via email entro alcuni giorni lavorativi. Se hai una licenza per un piano premium di Google Maps Platform, utilizza le credenziali del piano premium di Google Maps Platform per risolvere l'errore. Consulta la guida all'autenticazione del piano Premium.
UnauthorizedURLForClientIdMapError	Questo URL non è autorizzato a utilizzare l'ID client Google Maps fornito.	L'ID client del piano Premium o delle API Maps for Work incluso nel caricamento dello script non è valido, è scaduto oppure l'indirizzo attuale che carica l'API Maps JavaScript non è stato aggiunto all'elenco degli URL autorizzati. Consulta la pagina Registrazione degli URL autorizzati.

Codici di errore dell'API Maps JavaScript

Se riscontri un errore nella console JavaScript di Chrome, nella console web di Firefox o in qualsiasi altro strumento equivalente sul tuo browser, consulta la tabella riportata di seguito per trovare spiegazioni sui codici di errore.

L'API Maps JavaScript restituisce sia errori sia avvisi. Un errore indica un problema grave che si è verificato durante il caricamento dell'API Maps JavaScript. La pagina non può caricare correttamente l'API, che non funzionerà su quella pagina. Un avviso è un messaggio supplementare relativo al caricamento dell'API Maps JavaScript. L'avviso descrive i possibili motivi di un errore o suggerisce potenziali problemi nel codice che carica l'API Maps JavaScript. Se ricevi solo avvisi senza errori, l'API funzionerà correttamente su quella pagina. Tuttavia, ti consigliamo di risolvere anche questi potenziali problemi.

Codice di errore dello sviluppatore	Tipo	Descrizione
ApiNotActivatedMapError	Errore	L'API Maps JavaScript non è attivata nel tuo progetto API. Potresti dover abilitare l'API Maps JavaScript nelle API della console Google Cloud. Per attivare l'API Maps JavaScript per il tuo progetto, fai clic sul pulsante di seguito. Scopri come
ApiTargetBlockedMapError	Errore	Questa chiave API non è autorizzata a utilizzare il servizio o l'API. Controlla le impostazioni delle limitazioni delle API della chiave API nella console Google Cloud per assicurarti che tutte le API e i servizi che devi utilizzare siano specificati correttamente nell'elenco delle API abilitate. Consulta la pagina Chiavi API nella console Cloud. Per maggiori informazioni, consulta le best practice per la sicurezza delle API.
DeletedApiProjectMapError	Errore	Il tuo progetto API potrebbe essere stato eliminato dalla console Cloud. Controlla il progetto per il quale hai generato la chiave API inclusa nel caricatore API JavaScript. Puoi creare un nuovo progetto API e ottenere una nuova chiave nella console Cloud. Per creare un nuovo progetto e ottenere una chiave API per il progetto, fai clic sul pulsante di seguito. Scopri come
ClientBillingNotEnabledMapError	Errore	Non hai abilitato la fatturazione per il tuo progetto. Devi abilitare la fatturazione sul progetto Google Cloud associato a questo ID client, qui.
BillingNotEnabledMapError	Errore	Non hai abilitato la fatturazione nel progetto e questo causa questo errore. Devi abilitare la fatturazione nel progetto Google Cloud qui. Scopri di più
ExpiredKeyMapError	Errore	La chiave API inclusa nell'elemento script che carica l'API è scaduta o non è riconosciuta dal sistema. Potresti ricevere questo errore dopo aver creato una nuova chiave API se provi a utilizzarla prima che venga riconosciuta dal sistema. Attendi qualche minuto e riprova; in caso contrario, potresti dover generare una nuova chiave API nella console Cloud. Per ottenere una chiave API, fai clic sul pulsante di seguito. Inizia
InvalidClientIdMapError	Errore	L'ID client incluso nell'elemento di script che carica l'API non è valido o è scaduto. Assicurati di utilizzare correttamente il tuo ID client. L'ID client deve iniziare con il prefisso "gme-". Se visualizzi questo errore anche quando utilizzi correttamente l'ID client, l'ID client potrebbe essere scaduto. Contatta il tuo account manager Google. Se non disponi di un piano Premium o di una licenza per le API di Google Maps for Work, devi utilizzare un parametro key con la chiave API anziché il parametro client . Consulta la guida all'autenticazione del piano Premium.
InvalidKeyMapError	Errore	Impossibile trovare la chiave API inclusa nell'elemento script che carica l'API. Assicurati di utilizzare una chiave API corretta. Puoi generare una nuova chiave API nella console Cloud. Per ottenere una chiave API, fai clic sul pulsante di seguito. Inizia
MalformedCredentialsMapError	Errore	L'applicazione utilizza uno schema URI non supportato. Verifica che l'applicazione utilizzi un formato URI valido come definito nel documento RFC 3986.
MissingKeyMapError	Errore	Nell'elemento di script che carica l'API manca il parametro di autenticazione richiesto. Se utilizzi l'API Maps JavaScript standard, devi utilizzare un parametro key con una chiave API valida. Per maggiori informazioni, consulta la guida introduttiva a Google Maps Platform. Se sei un cliente con un piano Premium, devi utilizzare un parametro client con il tuo ID client o un parametro key con una chiave API valida. Per maggiori informazioni, consulta la guida Chiavi API e ID client. Se NON sei il proprietario del sito web, non puoi intraprendere alcuna azione per correggere questo errore. Tuttavia, ti consigliamo di avvisare il proprietario del sito, se possibile.
ProjectDeniedMapError	Errore	La tua richiesta non è stata completata. Potresti trovare ulteriori dettagli sull'errore nella console Cloud. Vedi Cloud Console.
RefererDeniedMapError	Errore	A seguito di numerose notifiche via email, la tua applicazione è stata bloccata perché non rispetta i Termini di servizio di Google Maps Platform. Per presentare ricorso contro il blocco e richiedere la revisione della tua implementazione, compila questo modulo. Riceverai una risposta via email entro alcuni giorni lavorativi.
RefererNotAllowedMapError	Errore	L'URL corrente che carica l'API Maps JavaScript non è stato aggiunto all'elenco dei referrer consentiti. Verifica le impostazioni del referrer della chiave API nella console Cloud. Consulta l'API Maps JavaScript e Ottenere una chiave API.
OverQuotaMapError	Errore	Il numero di richieste ha superato i limiti di utilizzo per l'API Maps JavaScript. Le richieste della tua app funzioneranno di nuovo con la successiva reimpostazione della quota giornaliera. Se NON sei il proprietario del sito web, non puoi intraprendere alcuna azione per correggere questo errore. Tuttavia, ti consigliamo di avvisare il proprietario del sito, se possibile. Per maggiori dettagli, consulta la guida ai limiti di utilizzo. La pagina spiega anche come ottenere limiti di utilizzo più elevati.
ApiProjectMapError	Errore	Non è stato possibile risolvere la chiave API fornita o il progetto API a cui è associata. Questo errore potrebbe essere temporaneo. Se questo messaggio di errore persiste, potresti dover richiedere una nuova chiave API o creare un nuovo progetto API. Per maggiori informazioni, consulta la guida introduttiva a Google Maps Platform.
ClientIdLooksLikeCryptoKey	Avviso	Potresti aver fornito una chiave di crittografia nel parametro client. Se hai un piano Premium o una licenza API di Google Maps for Work, specifica il tuo ID client come parametro client. Non è necessario utilizzare la chiave di crittografia per l'API Maps JavaScript. Consulta la guida agli ID client per i clienti con piano Premium e API di Google Maps for Work.
ClientIdLooksLikeKey	Avviso	Potresti aver fornito una chiave API nel parametro client. Se hai un piano Premium o una licenza API di Google Maps for Work, specifica il tuo ID client come parametro client. Se hai un piano premium di Google Maps Platform, puoi utilizzare un parametro client o un parametro key. Se non hai licenze, devi utilizzare un parametro key anziché un parametro client . Consulta la guida all'autenticazione del piano Premium.
InvalidChannel	Avviso	Potresti aver fornito un parametro channel non valido. Il canale deve essere una stringa ASCII alfanumerica che può includere punto (.), trattino basso (_) e trattino (-). Assicurati di specificare un parametro channel valido. Consulta la sezione Reporting | Piano premium di Google Maps Platform.
InvalidClientId	Avviso	Il parametro client non sembra contenere un ID client corretto. Un ID client deve iniziare con "gme-". Consulta la guida all'autenticazione del piano Premium.
InvalidKey	Avviso	La chiave API inclusa nell'elemento script che carica l'API non sembra corretta. Assicurati di utilizzare una chiave API corretta. Puoi generare una nuova chiave API nella console Cloud. Per ottenere una chiave API, fai clic sul pulsante di seguito. Inizia
InvalidVersion	Avviso	Potresti aver fornito un numero di versione errato nell'elemento script. Assicurati di utilizzare un numero di versione corretto. Consulta la sezione Controllo delle versioni | API Google Maps JavaScript.
KeyLooksLikeClientId	Avviso	Potresti aver fornito un ID client come parametro key. Se hai un piano Premium o una licenza API di Google Maps for Work, specifica il tuo ID client come parametro client anziché come parametro key. Se hai un piano premium di Google Maps Platform, puoi utilizzare un parametro client o un parametro key. Se non hai licenze, devi utilizzare un parametro key anziché un parametro client . Consulta la guida all'autenticazione del piano Premium.
KeyLooksLikeCryptoKey	Avviso	Potresti aver fornito una chiave di crittografia o un secret di firma come parametro key. Se hai un piano Premium o una licenza API di Google Maps for Work, specifica il tuo ID client come parametro client e rimuovi il parametro key dall'elemento di script. La chiave di crittografia non è necessaria per l'API Maps JavaScript. Se hai un piano premium di Google Maps Platform, puoi utilizzare un parametro client o un parametro key. Se non hai licenze, puoi ottenere una chiave API nella console Cloud. Consulta la guida per specificare un ID client durante il caricamento dell'API.
KeyLooksLikeProjectNumber	Avviso	Potresti aver fornito un numero di progetto sotto forma di parametro key. Assicurati di utilizzare una chiave API corretta. Puoi generare una nuova chiave API nella console Cloud. Scopri come ottenere una chiave API.
NoApiKeys	Avviso	L'elemento script che carica l'API non ha una chiave API. Assicurati di includere una chiave API valida come parametro key. Puoi generare una nuova chiave API nella console Cloud. Per ottenere una chiave API, fai clic sul pulsante di seguito per iniziare. Inizia Se carichi l'API Maps JavaScript dal percorso v2 deprecato, riceverai l'avviso NoApiKeys, anche se hai specificato il parametro key. Consulta la guida all'upgrade da v2 a v3 ed esegui la migrazione della tua applicazione all'API Maps JavaScript v3.
RetiredVersion	Avviso	Potresti aver fornito una versione ritirata nell'elemento script. Aggiorna l'applicazione in modo che utilizzi una delle versioni disponibili. Consulta la sezione Controllo delle versioni | API Google Maps JavaScript.
SensorNotRequired	Avviso	Il parametro sensor non è più obbligatorio per l'API Maps JavaScript. Questa operazione non impedirà all'API Maps JavaScript di funzionare correttamente, ma ti consigliamo di rimuovere il parametro sensor dall'elemento script.
SignatureNotRequired	Avviso	Il parametro signature non è obbligatorio per l'API Maps JavaScript. Non impedisce il corretto funzionamento dell'API Maps JavaScript, ma potrebbe introdurre rischi per la sicurezza. Rimuovilo dall'elemento script.
SignedInNotSupported	Avviso	Il parametro signed_in è stato deprecato e non è supportato nella versione dell'API Maps JavaScript in uso. Ciò non impedisce all'API Maps JavaScript di funzionare, ma il comportamento della tua applicazione potrebbe cambiare, se utilizzi le funzionalità che hai eseguito l'accesso.
UrlAuthenticationCommonError	Errore	Si è verificato un errore che non rientra nelle altre categorie su questa pagina. Potrebbe essere dovuto a un problema temporaneo. Riprova a inviare la richiesta tra un breve ritardo. Se il problema persiste, consulta la guida per gli sviluppatori per assicurarti che il formato della richiesta sia corretto.

Verifica degli errori nel browser

L'API Maps JavaScript scrive i messaggi di errore in window.console. Questa sezione spiega come controllare l'output di window.console in Google Chrome. Se utilizzi altri browser, consulta la documentazione per sviluppatori del browser in uso. Come riferimento, ecco un elenco di strumenti per verificare l'output window.console in alcuni altri browser.

• Web Console per Firefox.
• Debug remoto per Android.
• Web Inspector per iOS.

In Chrome, puoi utilizzare la console JavaScript per controllare l'output di window.console come indicato di seguito.

1. Per aprire Strumenti per sviluppatori, seleziona l'icona del menu > Altri strumenti > Strumenti per sviluppatori.
2. Per aprire la console JavaScript, premi il tasto ESC sulla tastiera. Il tasto ESC attiva/disattiva la console JavaScript. Se chiudi la console, premi di nuovo il tasto Esc per aprirla.

Se si sono verificati errori o avvisi durante il caricamento dell'API Maps JavaScript, verranno visualizzati su una o più righe nella console. Un messaggio di errore o di avviso ha il seguente formato:

Google Maps API error: [ERROR CODE] [Link to API document]
oppure
Google Maps API warning: [ERROR CODE] [Link to API document]

Puoi consultare la tabella dei codici di errore in alto per trovare il codice nel messaggio di errore. Puoi trovare i dettagli sul messaggio di errore anche nel documento dell'API a cui rimanda il messaggio.

Nota: puoi rimanere in ascolto degli errori di autenticazione in modo programmatico.

Gestione dei browser non supportati

Assicurati che la versione del browser che stai utilizzando sia attualmente supportata dall'API Maps JavaScript.

Se stai sviluppando un'applicazione Windows nativa che viene eseguita in un componente WebView, assicurati di utilizzare WebView2 basato su Edge. Le versioni precedenti di WebView, basate su Internet Explorer, non sono più supportate.

Se il codice continua a non funzionare

In questo video, Brendan Kenny e Mano Marks indicano alcuni errori comuni e come correggerli.

• Controlla che non ci siano errori di battitura. Ricorda che JavaScript è un linguaggio che fa distinzione tra maiuscole e minuscole.
• Controlla le informazioni di base: alcuni dei problemi più comuni si verificano con la creazione iniziale della mappa. Ad esempio:
  • Conferma di aver specificato le proprietà zoom e center nelle opzioni della mappa.
  • Verifica di aver dichiarato un elemento div in cui verrà visualizzata la mappa sullo schermo.
  • Verifica che l'elemento div per la mappa abbia un'altezza. Per impostazione predefinita, gli elementi div vengono creati con un'altezza pari a 0 e, pertanto, sono invisibili.
  Fai riferimento ai nostri esempi per l'implementazione di riferimento.
• Utilizza un debugger JavaScript per identificare i problemi, come quello disponibile negli Strumenti per sviluppatori di Chrome. Inizia cercando di individuare eventuali errori nella console JavaScript.
• Pubblica domande su Stack Overflow. Le linee guida su come pubblicare domande efficaci sono disponibili nella pagina Assistenza.