Annuncio: i nuovi stili delle mappe base saranno presto disponibili su Google Maps Platform. Questo aggiornamento dello stile della mappa include una nuova tavolozza dei colori predefinita, segnaposto moderni e miglioramenti alle esperienze sulla mappa e all'usabilità. Tutti gli stili di mappa verranno aggiornati automaticamente a marzo 2025. Per ulteriori informazioni sulla disponibilità e su come attivare in anteprima la funzionalità, consulta Nuovo stile di mappa per Google Maps Platform.

Questa pagina è stata tradotta dall'API Cloud Translation.

Messaggi di errore

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. Potrebbero verificarsi anche determinate condizioni di errore, che comportano la visualizzazione di una mappa oscurata con la filigrana.

Chiave API ed errori di fatturazione

Risoluzione dei problemi

In determinate circostanze, una mappa oscurata o "negativa" Immagine di Street View con filigrana con il testo "solo a scopo di sviluppo", potrebbero essere visualizzati. 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 nel tuo account e tutte le richieste devono includere una chiave API valida. Per assistenza su come trovare i messaggi di errore, consulta la sezione sulla verifica degli errori nel browser.

La procedura seguente 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 passata come parametro key nell'URL utilizzato per caricare l'API Maps JavaScript. Di seguito sono riportate alcune opzioni per verificare se utilizzi una chiave API:

Utilizza la dell'estensione di Chrome Google Maps Platform API Checker. In questo modo puoi determinare se il tuo sito web implementa correttamente le API di Maps concesse in licenza da Google.
Se utilizzi una libreria o un plug-in per caricare l'API Maps JavaScript, controlla le impostazioni della libreria e cerca l'opzione della chiave API.
Controlla gli errori nel browser. Se visualizzi i seguenti messaggi, significa che non stai utilizzando correttamente la chiave API:

Avviso relativo all'API Google Maps JavaScript: NoApiKeys
Errore dell'API Maps JavaScript di Google: 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. Durante il caricamento dell'API Maps JavaScript, sostituisci YOUR_API_KEY nel codice riportato di seguito 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, puoi visualizzarlo utilizzando la scheda Rete di DevTools. Qui vedrai le richieste di rete effettuate dal tuo sito web. Le richieste effettuate utilizzando l'API Maps JavaScript saranno nel percorso maps/api/js. Qui puoi verificare se le richieste utilizzano il parametro key. Può essere utile filtrare il traffico di rete in base a maps/api/js quando visualizzi la scheda Rete.

No, non utilizzo una chiave API.

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

Sì, sto utilizzando una chiave API.

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

Al tuo progetto è associato un account di fatturazione?

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

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

Vai alla sezione Credenziali, a cui puoi accedere dalla barra laterale sinistra in Google Maps Platform > Credenziali.
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.
Se non riesci a trovare il progetto per la tua chiave API, potresti aver perso l'accesso a questo progetto. Chiedi aiuto agli altri membri della tua organizzazione. Se non è possibile trovare il progetto originale, devi:
1. Crea un nuovo progetto. Per farlo, seleziona Nuovo progetto dall'elenco dei progetti o Crea progetto tramite la pagina Gestione risorse.
2. Creazione di una nuova chiave API. Puoi farlo nella pagina Credenziali. Una volta qui, fai clic su Crea credenziali e poi seleziona Chiave API.

Una volta individuato il progetto nella console Cloud, Per verificare se un account di fatturazione è collegato, vai alla sezione Fatturazione nel menu a sinistra.

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

Vai alla pagina Abilita la fatturazione in Cloud Console e aggiungi un account di fatturazione al progetto. Per ulteriori informazioni, vedi Inizia a utilizzare Google Maps Platform.

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

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

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

Tu può aggiungere, rimuovere o aggiornare un metodo di pagamento nella console Cloud.

È stato superato il limite giornaliero autoimpostato per l'API?

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

Puoi controllare i tuoi limiti giornalieri nella dashboard API e servizi in Cloud Console. Una volta qui:

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

La chiave API è soggetta a una restrizione relativa agli indirizzi IP?

Le chiavi API con una limitazione degli indirizzi IP possono essere utilizzate solo con i servizi web destinati all'utilizzo lato server (ad esempio l'API Geocoding e altre API di servizi web). La maggior parte di questi servizi web offre servizi equivalenti all'interno dell'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 può essere protetta con una limitazione dei referrer HTTP (vedi Ottenere, aggiungere e limitare una chiave API).

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

Le tabelle seguenti elencano i possibili codici di errore restituiti dall'API JavaScript di Maps, con una descrizione della causa e della modalità di risoluzione del problema. Per sapere come trovare i messaggi di errore, consulta la sezione sulla verifica 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 trovare le spiegazioni dei codici di errore.

Codice di errore Messaggio Descrizione

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 Caricamento dell'API Maps JavaScript.
`TOSViolationMapError`	Sembra che questo sito web violi i Termini di servizio dell'API Google Maps. L'API Google Maps è stata disattivata per questo sito web.	La tua applicazione è stata bloccata per mancata conformità alle Termini di servizio di Google Maps Platform, a seguito di diverse notifiche via email. Per presentare ricorso contro il blocco e richiedere la revisione dell'implementazione, compila questo modulo. Riceverai una risposta via email entro qualche giorno lavorativo. Se hai una licenza del piano Premium di Google Maps Platform, utilizza le tue credenziali del piano Premium di Google Maps Platform per risolvere questo errore. Consulta la guida all'autenticazione del piano Premium.
`UnauthorizedURLForClientIdMapError`	Questo URL non è autorizzato a utilizzare l'ID client Google Maps fornito.	Il piano Premium o le API di Google Maps for Work L'ID client incluso nel caricamento dello script non è valido. scaduto o se l'indirizzo corrente carica L'API Maps JavaScript non è stata aggiunta all'elenco di URL autorizzati. Vedi Registrazione degli URL autorizzati.

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 Caricamento dell'API Maps JavaScript.

TOSViolationMapError

Sembra che questo sito web violi i Termini di servizio dell'API Google Maps. L'API Google Maps è stata disattivata per questo sito web.

La tua applicazione è stata bloccata per mancata conformità alle Termini di servizio di Google Maps Platform, a seguito di diverse notifiche via email. Per presentare ricorso contro il blocco e richiedere la revisione dell'implementazione, compila questo modulo. Riceverai una risposta via email entro qualche giorno lavorativo.

Se hai una licenza del piano Premium di Google Maps Platform, utilizza le tue credenziali del piano Premium di Google Maps Platform per risolvere questo errore. Consulta la guida all'autenticazione del piano Premium.

UnauthorizedURLForClientIdMapError

Questo URL non è autorizzato a utilizzare l'ID client Google Maps fornito.

Il piano Premium o le API di Google Maps for Work L'ID client incluso nel caricamento dello script non è valido. scaduto o se l'indirizzo corrente carica L'API Maps JavaScript non è stata aggiunta all'elenco di URL autorizzati.

Vedi Registrazione degli URL autorizzati.

Codici di errore dell'API Maps JavaScript

Se trovi un errore in JavaScript di Chrome Console, Firefox Console web o qualsiasi altro strumento equivalente nei browser. consulta la tabella che segue per trovare spiegazioni sui codici di errore.

L'API Maps JavaScript restituisce errori e avvisi. Un errore indica un grave problema che si è verificato durante il caricamento del API Maps JavaScript. La pagina non riesce a caricare correttamente l'API, che non funzionerà in quella pagina. Un avviso è un messaggio supplementare relativo al caricamento API Maps JavaScript. L'avviso descrive i possibili motivi alla ricerca di un errore o suggerisce potenziali problemi nel codice che caricano 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 sviluppatore	Tipo	Descrizione
`ApiNotActivatedMapError`	Errore	L'API Maps JavaScript non è attivata nel progetto API. Potresti dover 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 questo servizio o questa API. Controlla le impostazioni relative alle restrizioni API della chiave API nel Console Google Cloud per garantire che tutte le API e i servizi di cui hai bisogno da utilizzare siano specificate correttamente nell'elenco delle API abilitate. Vedi nella console Cloud. Per ulteriori informazioni, vedi Best practice per la sicurezza delle API.
`DeletedApiProjectMapError`	Errore	Il progetto API potrebbe essere stato eliminato da Cloud Console. Controlla il progetto per il quale hai generato la chiave API incluso nel caricatore dell'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 attivato la fatturazione nel tuo progetto. Devi abilitare la fatturazione su Google Cloud Progetto associato a questo ID client, qui
`BillingNotEnabledMapError`	Errore	Non hai attivato la fatturazione nel tuo progetto, causando questo errore. Devi attivare 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 oppure potresti dover generare una nuova chiave API in Cloud Console. Per ottenere una chiave API, fai clic sul pulsante di seguito. Inizia
`InvalidAppCheckTokenMapError`	Errore	Il token App Check fornito non è valido o è scaduto. Questo errore può verificarsi solo se è in uso la verifica di App Check. Consulta la guida alla verifica di App Check.
`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 "gme-" . Se vedi questo errore anche se utilizzi correttamente l'ID client, l'ID client potrebbe sono scaduti. Contatta il tuo account manager Google. Se non hai un piano Premium o una licenza API di Google Maps for Work, devi utilizzare `key` con la tua chiave API anziché il parametro `client`. Consulta la guida per Autenticazione del piano Premium.
`InvalidKeyMapError`	Errore	La chiave API inclusa nell'elemento script che carica l'API non è stata trovata. 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 qui sotto. 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 script che carica l'API manca il parametro di autenticazione obbligatorio. Se utilizzi l'API Maps JavaScript standard, devi utilizzare un parametro `key` con una chiave API valida. Per ulteriori informazioni, vedi Inizia a utilizzare Google Maps Platform. Se hai un piano Premium, devi: utilizza un parametro `client` con il tuo ID cliente oppure un `key` con una chiave API valida. Per ulteriori informazioni, consulta la guida alle chiavi API e agli ID client. Se NON sei il proprietario del sito web, non ci sono passaggi che puoi seguire per risolvere il problema. . Tuttavia, se possibile, ti consigliamo di informare il proprietario del sito.
`ProjectDeniedMapError`	Errore	La tua richiesta non è stata completata. Potresti trovare maggiori dettagli sull'errore nella console Cloud. Consulta Cloud Console.
`RefererDeniedMapError`	Errore	La tua applicazione è stata bloccata per mancata conformità ai Termini di servizio di Google Maps Platform, a seguito di diverse notifiche via email. Per presentare ricorso contro le bloccare e far esaminare la tua implementazione, completa questo modulo. Riceverai una risposta via email entro pochi giorni lavorativi.
`RefererNotAllowedMapError`	Errore	L'URL corrente che carica l'API Maps JavaScript non è stato aggiunto all'elenco dei referrer consentiti. Verifica il referrer delle impostazioni della chiave API nella console Cloud. 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 al successivo ripristino della quota giornaliera. Se NON sei il proprietario del sito web, non puoi fare nulla per risolvere questo errore. Tuttavia, se possibile, ti consigliamo di informare il proprietario del sito. Per ulteriori dettagli, consulta la guida di utilizzo dei dati. 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 ottenere una nuova chiave API o creare un nuovo progetto API. Per ulteriori informazioni, vedi Inizia a utilizzare Google Maps Platform.
`ClientIdLooksLikeCryptoKey`	Avviso	Potresti aver fornito una chiave crittografica nel parametro `client`. Se hai un piano Premium o Licenza API di Google Maps for Work, specifica il tuo ID cliente come parametro `client`. Non è necessario utilizzare la chiave di crittografia per l'API Maps JavaScript. Consulta la guida agli ID client per i clienti del piano Premium e delle API Maps for Work.
`ClientIdLooksLikeKey`	Avviso	Potresti aver fornito una chiave API nel parametro `client`. Se hai un piano Premium o una licenza per le API 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 disponi di licenze, devi utilizzare un parametro `key` anziché `client`. Consulta la guida per Autenticazione del piano Premium.
`InvalidChannel`	Avviso	Potresti aver specificato un parametro `channel` non valido. Il canale deve essere una stringa alfanumerica ASCII, che può includere un punto (.), un trattino basso (_) e un trattino (-). Assicurati di specificare un parametro `channel` valido. Consulta Report \| Piano Premium Google Maps Platform.
`InvalidClientId`	Avviso	Il parametro `client` non sembra contenere un ID cliente corretto. Un ID cliente 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 tutto sembra corretto. 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 usare un numero di versione corretto. Consulta Versionamento \| API Maps JavaScript di Google.
`KeyLooksLikeClientId`	Avviso	Potresti aver fornito un ID cliente come parametro `key`. Se hai un piano Premium o Licenza API di Google Maps for Work, specifica il tuo ID client come `client` anziché il parametro `key`. Se disponi di un Piano Google Maps Platform Premium, 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 crittografica o un segreto di firma come parametro `key`. Se hai un piano Premium o Licenza API di Google Maps for Work, specifica il tuo ID cliente come parametro `client` e rimuovi il parametro `key` dall'elemento script. La chiave di crittografia è non richiesto 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 in Cloud Console. Consulta la guida su come specificare un ID client al 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 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 qui sotto per iniziare. Inizia Se carichi l'API Maps JavaScript dal percorso v2 ritirato, verrà visualizzato l'avviso `NoApiKeys`, anche se hai specificato il parametro `key`. Consulta la guida all'upgrade dalla versione 2 alla versione 3 ed esegui la migrazione dell'applicazione all'API Maps JavaScript v3.
`RetiredVersion`	Avviso	Potresti aver fornito una versione ritirata nell'elemento script. Aggiorna l'applicazione in modo da utilizzare una delle versioni disponibili. Consulta Versionamento \| API Maps JavaScript di Google.
`SensorNotRequired`	Avviso	Il parametro `sensor` non è più necessario per API Maps JavaScript. Ciò non impedirà 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. Ciò non impedirà 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 che stai utilizzando. Ciò non impedirà l'API Maps JavaScript non funziona, ma il comportamento dell'applicazione potrebbe cambiare. se utilizzi funzionalità di accesso.
`UrlAuthenticationCommonError`	Errore	Si è verificato un errore che non rientra nelle altre categorie di questo . La causa potrebbe essere un problema temporaneo. Riprova la richiesta dopo un breve ritardo. Se il problema persiste, consulta la guida per gli sviluppatori per assicurarti che la richiesta abbia il formato corretto.

Controllare gli 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 questione. Come riferimento, di seguito è riportato un elenco di strumenti per controllare l'output di window.console in alcuni altri browser.

Console web per Firefox.
Debug remoto per Android.
Ispettore web per iOS.

In Chrome puoi utilizzare Console JavaScript per controllare l'output window.console come segue.

Per aprire gli Strumenti per sviluppatori, seleziona l'icona del menu > Altri strumenti > Strumenti per sviluppatori.
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 aprirlo.

Se si sono verificati errori o avvisi durante il caricamento dell'API JavaScript Maps, vengono visualizzati come 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]
o
Google Maps API warning: [ERROR CODE] [Link to API document]

Consulta la tabella dei codici di errore riportata sopra per trovare il codice nel messaggio di errore. Puoi anche trovare i dettagli 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 in uso sia attualmente supportati 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

Per aiutarti a mettere in funzione il codice di Maps, Brendan Kenny e Mano Marks indicano alcuni errori comuni e come correggerli in questo video.

Controlla che non ci siano errori di battitura. Ricorda che JavaScript è un linguaggio sensibile alle maiuscole.
Controlla le basi: alcuni dei problemi più comuni si verificano con 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 vengono visualizzate sullo schermo.
- Assicurati 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, di conseguenza, invisibile.
Fai riferimento ai nostri esempi per un'implementazione di riferimento.
Utilizza un debugger JavaScript per identificare i problemi, ad esempio quello disponibile negli Strumenti per sviluppatori di Chrome. Per prima cosa, controlla se nella console JavaScript sono presenti errori.
Pubblica le domande su Stack Overflow. Le linee guida su come pubblicare ottime domande sono disponibili nella pagina Assistenza.