Messaggi di errore

Hai bisogno di aiuto da parte di una persona?
Vai alla pagina Assistenza di Google Maps Platform.
Questa pagina dei messaggi di errore è solo a scopo di riferimento. È qui per aiutarti a risolvere autonomamente gli errori dell'API JavaScript di Maps. Se provi a chiedere aiuto a una persona inviando un feedback tramite questa pagina, non potrai raggiungere nessuno che possa aiutarti. Se, tuttavia, trovi un problema con i contenuti in questa pagina, faccelo sapere utilizzando il link per il feedback. Grazie.

In questa pagina vengono descritti i messaggi di errore che possono essere restituiti dall'API Maps JavaScript. L'API Maps JavaScript scrive i messaggi di errore e di avviso nella console JavaScript. Possono verificarsi anche alcune condizioni di errore, che generano la visualizzazione di una mappa con filigrana oscurata.

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

Errori di fatturazione di chiavi API e fatturazione

Risoluzione dei problemi

In determinate circostanze, potrebbe essere visualizzata una mappa scura o un'immagine di Street View "negativa", filigranata con il testo "solo a scopo di sviluppo". Questo comportamento in genere indica i problemi relativi a una chiave API o alla fatturazione. Per utilizzare i prodotti Google Maps Platform, la fatturazione deve essere attivata nel tuo account e tutte le richieste devono includere una chiave API valida. Per assistenza nella ricerca dei messaggi di errore, consulta la sezione relativa al controllo degli errori nel browser.

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

Usi una chiave API?

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

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

• Utilizza l'estensione di Chrome Google Maps Platform API Checker. Ciò consente di determinare se il sito web sta implementando correttamente le API di Google con licenza di Google Maps.
• Se utilizzi una libreria o un plug-in per caricare l'API Maps JavaScript, controlla le impostazioni della libreria e cerca un'opzione per la chiave API.
• Controlla gli errori nel browser. Se visualizzi i seguenti messaggi, significa che non stai utilizzando correttamente la chiave API:
• Avviso dell'API JavaScript di Google Maps: NoApiKeys
• Errore dell'API JavaScript di Google Maps: MISSINGKeyMapError

Per gli sviluppatori web:

• Se hai accesso al codice sorgente della tua applicazione, cerca il tag <script> che viene utilizzato per caricare l'API Maps JavaScript. Quando carichi l'API Maps JavaScript, sostituisci YOUR_API_KEY nel codice di seguito con la 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, questo può essere visualizzato utilizzando la scheda Rete DevTools. Qui troverai le richieste di rete effettuate dal tuo sito web. Le richieste effettuate utilizzando l'API Maps JavaScript si trovano nel percorso maps/api/js. Qui puoi verificare se le richieste utilizzano il parametro key. Può essere utile filtrare il traffico di rete per maps/api/js quando visualizzi la scheda Rete.

No, non utilizzo una chiave API.

Per ottenere una chiave API, fai clic sul pulsante in basso. Se non vedi una configurazione guidata, segui le istruzioni complete in Inizia a utilizzare Google Maps Platform.
Inizia

Sì, sto utilizzando una chiave API.

Bene. Andiamo avanti e verifichiamo se un account di fatturazione è associato al tuo progetto.

Un account di fatturazione è collegato al progetto?

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

Vai alla pagina Fatturazione in Google Cloud Console e seleziona il progetto in cui è 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. Controlla che la chiave API attualmente in uso sul tuo sito web sia elencata. In caso contrario, passa a un altro progetto e controlla le credenziali.
3. Se non riesci a trovare il progetto per la chiave API, potresti non avere più accesso a questo progetto. Chiedi aiuto agli altri utenti della tua organizzazione. Se non è possibile trovare il progetto originale, devi:
   1. Crea un nuovo progetto. A tale scopo, seleziona Nuovo progetto dall'elenco dei progetti oppure Crea progetto tramite la pagina Resource Manager.
   2. Creazione di una nuova chiave API. Puoi eseguire questa operazione nella pagina Credenziali. Una volta lì, fai clic su Crea credenziali e seleziona Chiave API.

Dopo aver individuato il progetto in Cloud Console, controlla se è collegato un account di fatturazione andando alla sezione Fatturazione nel menu a sinistra.

No, un account di fatturazione non è associato 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 pagina Inizia a utilizzare Google Maps Platform.

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

Bene. Verifichiamo che il metodo di fatturazione fornito 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 in Cloud Console.

Esiste un limite giornaliero impostato autonomamente per l'API?

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

Puoi controllare i limiti giornalieri accedendo alla dashboard API e servizi in Cloud Console. Una volta arrivato:

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

La chiave API ha una restrizione per gli indirizzi IP?

Le chiavi API con una limitazione Indirizzi IP possono essere utilizzate solo con i servizi web destinati all'uso dal lato server (come l'API Geocoding e altre API Web Service). La maggior parte di questi servizi web dispone di servizi equivalenti nell'API Maps JavaScript (ad esempio, consulta il servizio di geocodifica). Per utilizzare i servizi lato client dell'API Maps JavaScript, devi creare una chiave API separata che possa essere protetta con una restrizione relativa ai referrer HTTP (vedi Ottieni, aggiungi e limita una chiave API).

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

Nelle tabelle seguenti sono elencati i possibili codici di errore restituiti dall'API Maps JavaScript, con una descrizione della causa e del modo in cui puoi risolvere il problema. Per assistenza nella ricerca dei messaggi di errore, consulta la sezione relativa al controllo degli errori nel browser.

Errori di caricamento della mappa

Se riscontri un errore durante il caricamento dell'API Maps JavaScript, consulta la tabella riportata di seguito per 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 viene incluso correttamente nella 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.	La tua richiesta è stata bloccata perché non rispetta i Termini di servizio di Google Maps Platform a seguito di diverse notifiche via email. Per presentare ricorso contro la blocco e far esaminare la tua implementazione, compila questo modulo. Riceverai una risposta via email entro pochi giorni lavorativi. Se hai una licenza di Google Maps Platform Premium Plan, utilizza le relative credenziali di Google Maps Platform Premium Plan per risolvere questo errore. Consulta la guida all'autenticazione dei piani premium.
UnauthorizedURLForClientIdMapError	Questo URL non è autorizzato a utilizzare l'ID client Google Maps fornito.	L'ID client del piano Premium o delle API di Google Maps for Work incluso nel caricamento dello script non è valido, è scaduto o l'indirizzo corrente che carica l'API Maps JavaScript non è stato aggiunto all'elenco di URL autorizzati. Consulta la pagina Registrazione degli URL autorizzati.

Codici di errore dell'API JavaScript di Maps

Se trovi un errore nella Console JavaScript di Chrome, in Firefox Web Console o in altri strumenti equivalenti nei tuoi browser, consulta la tabella riportata di seguito per trovare le spiegazioni per i codici di errore.

L'API Maps JavaScript restituisce errori e 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 e l'API non funzionerà in questa 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 caricano l'API Maps JavaScript. Se ricevi solo avvisi senza errori, l'API funzionerà correttamente in 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 è attiva per il progetto API. Potrebbe essere necessario abilitare l'API Maps JavaScript in API nella 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 API della tua chiave API in Google Cloud Console 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 in Cloud Console. Per ulteriori informazioni, consulta le best practice per la sicurezza delle API.
DeletedApiProjectMapError	Errore	Il progetto API potrebbe essere stato eliminato da Cloud Console. Controlla il progetto per cui hai generato la chiave API inclusa nel caricatore dell'API JavaScript. Puoi creare un nuovo progetto API e ottenere una nuova chiave in Cloud Console. Per creare un nuovo progetto e ottenere una chiave API per il progetto, fai clic sul pulsante qui sotto. Scopri come
ClientBillingNotEnabledMapError	Errore	Non hai attivato la fatturazione per il progetto. Devi abilitare la fatturazione per il progetto Google Cloud associato a questo ID client, qui.
BillingNotEnabledMapError	Errore	Non hai attivato la fatturazione per il progetto che causa questo errore. Devi abilitare la fatturazione per il 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 tenti di utilizzare la chiave prima che venga riconosciuta dal sistema. Attendi qualche minuto e riprova oppure potresti dover generare una nuova chiave API in Cloud Console. Per ottenere una chiave API, fai clic sul pulsante in basso. Inizia
InvalidClientIdMapError	Errore	L'ID client incluso nell'elemento 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 ricevi questo errore anche quando utilizzi il tuo ID client correttamente, l'ID client potrebbe essere scaduto. Contatta il tuo account manager Google. Se non hai una licenza Premium o un piano API di Maps per il lavoro, devi utilizzare un parametro key con la tua chiave API anziché il parametro client . Consulta la guida all'autenticazione dei piani 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 in Cloud Console. Per ottenere una chiave API, fai clic sul pulsante in basso. Inizia
MalformedCredentialsMapError	Errore	La tua applicazione utilizza uno schema URI non supportato. Verifica che l'applicazione utilizzi un formato URI valido come definito in RFC 3986.
MissingKeyMapError	Errore	Manca il parametro di autenticazione richiesto per l'elemento script che carica l'API. Se utilizzi l'API Maps JavaScript standard, devi utilizzare un parametro key con una chiave API valida. Per ulteriori informazioni, consulta la pagina Inizia a utilizzare Google Maps Platform. Se sei un cliente del piano Premium, devi utilizzare un parametro client con l'ID client o un parametro key con una chiave API valida. Per maggiori informazioni, consulta la guida alle chiavi API e ID client. Se NON sei il proprietario del sito web, non puoi intraprendere alcuna azione per correggere questo errore. Tuttavia, potresti provare a inviare una notifica al proprietario del sito, se possibile.
ProjectDeniedMapError	Errore	La tua richiesta non è stata completata. Potresti trovare ulteriori dettagli sull'errore in Cloud Console. Vedi Cloud Console.
RefererDeniedMapError	Errore	La tua richiesta è stata bloccata perché non rispetta i Termini di servizio di Google Maps Platform a seguito di diverse notifiche via email. Per presentare ricorso contro la blocco e far esaminare la tua implementazione, compila questo modulo. Riceverai una risposta via email entro pochi giorni lavorativi.
RefererNotAllowedMapError	Errore	L'URL attuale che carica l'API Maps JavaScript non è stato aggiunto all'elenco dei referrer consentiti. Controlla le impostazioni dei referrer della chiave API in Cloud Console. Consulta l'API Maps JavaScript e Ottieni 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 alla successiva reimpostazione giornaliera della quota. Se NON sei il proprietario del sito web, non puoi fare nulla per correggere questo errore. Tuttavia, potresti provare a inviare una notifica al proprietario del sito, se possibile. Per ulteriori dettagli, consulta la guida ai limiti di utilizzo. La pagina spiega anche come ottenere limiti di utilizzo più elevati.
ApiProjectMapError	Errore	Impossibile risolvere la chiave API fornita o il progetto API a cui è associata. Questo errore potrebbe essere temporaneo. Se questo messaggio di errore persiste, potrebbe essere necessario ottenere una nuova chiave API o creare un nuovo progetto API. Per ulteriori informazioni, consulta la pagina Inizia a utilizzare Google Maps Platform.
ClientIdLooksLikeCryptoKey	Avviso	Potresti aver fornito una chiave di crittografia nel parametro client. Se disponi di un piano Premium o di una licenza API di Google Maps for Work, specifica il tuo ID client come parametro client. Non è necessario utilizzare una chiave di crittografia per l'API Maps JavaScript. Consulta la guida agli ID client per i clienti dei piani Premium e delle API di Google Maps for Work.
ClientIdLooksLikeKey	Avviso	Potresti aver fornito una chiave API nel parametro client. Se disponi di un piano Premium o di una licenza API di Google Maps for Work, specifica il tuo ID client come parametro client. Se hai un piano Google Maps Platform Premium, puoi utilizzare un parametro client o key. Se non hai licenze, devi utilizzare un parametro key anziché un parametro client . Consulta la guida all'autenticazione dei piani premium.
InvalidChannel	Avviso	Potresti aver fornito un parametro channel non valido. Il canale deve essere una stringa ASCII alfanumerica, che può includere punti (.), trattini bassi (_) e trattini (-). Assicurati di specificare un parametro channel valido. Consulta Report | Piano Google Maps Platform Premium.
InvalidClientId	Avviso	Il parametro client non sembra contenere un ID client corretto. L'ID client deve iniziare con "gme-". Consulta la guida all'autenticazione dei piani 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 in Cloud Console. Per ottenere una chiave API, fai clic sul pulsante in basso. Inizia
InvalidVersion	Avviso	Potresti aver fornito un numero di versione errato nell'elemento script. Assicurati di utilizzare un numero di versione corretto. Vedi Controllo delle versioni | API JavaScript di Google Maps.
KeyLooksLikeClientId	Avviso	Potresti aver fornito un ID client come parametro key. Se disponi di un piano Premium o di una licenza API di Google Maps for Work, specifica il tuo ID client come parametro client anziché parametro key. Se hai un piano Google Maps Platform Premium, puoi utilizzare un parametro client o key. Se non hai licenze, devi utilizzare un parametro key anziché un parametro client . Consulta la guida all'autenticazione dei piani premium.
KeyLooksLikeCryptoKey	Avviso	Potresti aver fornito una chiave di crittografia o un secret di firma come parametro key. Se disponi di un piano Premium o di una licenza API di Google Maps for Work, specifica il tuo ID client come parametro client e rimuovi il parametro key dall'elemento script. La chiave di crittografia non è obbligatoria per l'API Maps JavaScript. Se hai un piano Google Maps Platform Premium, puoi utilizzare un parametro client o key. Se non hai licenze, puoi ottenere una chiave API in Cloud Console. Consulta la guida alla specifica di un ID client durante il caricamento dell'API.
KeyLooksLikeProjectNumber	Avviso	Potresti aver fornito un numero di progetto come parametro key. Assicurati di utilizzare una chiave API corretta. Puoi generare una nuova chiave API in Cloud Console. 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 in Cloud Console. Per ottenere una chiave API, fai clic sul pulsante in basso per iniziare. Inizia Se stai caricando l'API Maps JavaScript dal percorso v2 deprecato, riceverai l'avviso NoApiKeys, anche se hai specificato il parametro key. Consulta la guida all'upgrade dalla versione v2 alla 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 la tua applicazione per utilizzare una delle versioni disponibili. Vedi Controllo delle versioni | API JavaScript di Google Maps.
SensorNotRequired	Avviso	Il parametro sensor non è più obbligatorio per l'API Maps JavaScript. Non impedisce il corretto funzionamento dell'API Maps JavaScript, 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 può introdurre rischi per la sicurezza. Rimuovilo dall'elemento script.
SignedInNotSupported	Avviso	Il parametro signed_in è deprecato e non è supportato nella versione dell'API Maps JavaScript che stai utilizzando. Ciò non impedisce il funzionamento dell'API Maps JavaScript, ma il comportamento della tua applicazione potrebbe cambiare se utilizzi funzionalità che hanno eseguito l'accesso.
UrlAuthenticationCommonError	Errore	Si è verificato un errore che non rientra nelle altre categorie di questa pagina. La causa potrebbe essere un problema temporaneo. Riprova a eseguire l'operazione dopo 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 relativa al tuo browser. Per riferimento, questo è un elenco degli strumenti per controllare l'output di 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 nel seguente modo.

1. Per aprire gli Strumenti per sviluppatori, seleziona l'icona del menu > Altri strumenti > Strumenti per sviluppatori.
2. Per aprire la console JavaScript, premi il tasto Esc della tastiera. Il tasto Esc attiverà la console JavaScript. Se chiudi la console, premi di nuovo il tasto Esc per aprirla.

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

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

Puoi controllare la tabella dei codici di errore sopra per trovare il codice di errore nel messaggio di errore. Puoi anche trovare i dettagli relativi al messaggio di errore nel documento API collegato dal messaggio.

Nota: puoi ascoltare gli 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 nativa di Windows che viene eseguita in una WebView, assicurati di utilizzare WebView2 in base a Edge. Le versioni precedenti di WebView, basate su Internet Explorer, non sono più supportate.

Se il codice continua a non funzionare

Per aiutarvi a iniziare con il codice delle mappe, Brendan Kenny e Mano Marks sottolineano alcuni errori comuni e come risolverli in questo video.

• Cerca gli errori di battitura. Ricorda che JavaScript è un linguaggio sensibile alle maiuscole.
• Controlla le nozioni di base: alcuni dei problemi più comuni si verificano con la creazione iniziale della mappa. Ad esempio:
  • Verifica di aver specificato le proprietà zoom e center nelle opzioni della mappa.
  • Assicurati di aver dichiarato un elemento div in cui la mappa verrà visualizzata sullo schermo.
  • Assicurati che l'elemento div della mappa abbia un'altezza. Per impostazione predefinita, gli elementi div vengono creati con un'altezza pari a 0 e, pertanto, sono invisibili.
  Consulta i nostri esempi per un'implementazione di riferimento.
• Utilizza un debugger JavaScript per identificare i problemi, come quello disponibile in Chrome Developer Tools. Inizia cercando gli errori nella console JavaScript.
• Pubblica domande su Stack Overflow. Le linee guida su come pubblicare domande eccezionali sono disponibili nella pagina Assistenza.