Messaggio di errore

Hai bisogno di aiuto da parte di una persona?
Vai alla pagina dell'assistenza di Google Maps Platform.
Questa pagina relativa ai messaggi di errore è solo a scopo informativo. È qui per aiutarti a risolvere autonomamente gli errori relativi all'API Maps JavaScript. Se provi a chiedere se hai bisogno di aiuto da parte di un essere umano, non potrai contattare nessuno che possa aiutarti inviando un feedback tramite questa pagina. Tuttavia, se riscontri un problema con i contenuti di questa pagina, comunicacelo tramite il link per il feedback. Grazie.

In questa pagina vengono descritti i messaggi di errore che possono essere restituiti dal API Maps JavaScript. L'API Maps JavaScript scrive messaggi di errore e di avviso nella console JavaScript. Un certo errore condizioni possono verificarsi, determinando la visualizzazione di uno scurimento mappa con filigrana.

Se NON sei il proprietario del sito web, non devi effettuare nessun passaggio per correggere questi errori. Tuttavia, potresti voler informare il sito proprietario, se possibile.

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 in genere indica 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 informazioni su come individuare i messaggi di errore, consulta la sezione controllare gli 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 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. Questo ti consente di determinare se le tue che il tuo sito web stia implementando correttamente le API di Google Maps concesse in licenza di 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 vengono visualizzati i seguenti messaggi, significa che non stai utilizzando correttamente la 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. 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, può essere visualizzato utilizzando il Scheda DevTools DevTools. Qui vedrai le richieste di rete effettuate dal tuo sito web. Richieste effettuate utilizzando L'API Maps JavaScript si trova nel percorso maps/api/js. Qui puoi verificare se le richieste utilizzano il parametro key. Potrebbe essere utile filtra il traffico di rete per maps/api/js nella scheda Rete.

No, non utilizzo una chiave API.

Per ottenere una chiave API, fai clic sul pulsante qui sotto. 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.

È collegato un account di fatturazione al progetto?

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:

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.
3. Se non riesci a individuare 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 individuare il progetto originale, devi:
   1. Creare un nuovo progetto. Per farlo, seleziona Nuovo progetto. dall'elenco di progetti o selezionando Crea progetto tramite Pagina Resource Manager.
   2. Creazione di una nuova chiave API. Questa operazione può essere eseguita nella pagina Credenziali. A questo punto, fai clic su Crea credenziali e 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 fatturazione nella console Cloud e aggiungere 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 qualsiasi delle tue API, comune per prevenire aumenti imprevisti, puoi risolvere questo problema aumentando il limite giornaliero.

Per verificare i tuoi limiti giornalieri, consulta la API e Services Dashboard nella nella console Cloud. Una volta lì:

1. Seleziona un progetto, se richiesto.
2. 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 restrizione relativa agli indirizzi IP possono essere utilizzate solo con servizi web che per l'utilizzo sul lato server (come API Geocoding e altre API dei 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 possono essere protette con una restrizione dei referrer HTTP (vedi Ricevi, aggiungi e limita una chiave API).

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

Nelle tabelle seguenti sono elencati i possibili codici di errore restituiti dal API Maps JavaScript, con una descrizione della causa e come puoi risolvere il problema. Per assistenza su come individuare i messaggi di errore, consulta la sezione sui controllare gli errori nel browser.

Errori di caricamento della mappa

Se si verifica un errore durante il caricamento dell'API Maps JavaScript, consulta la tabella che segue per trovare spiegazioni sui codici di errore.

Codice di errore	Messaggio	Descrizione
NotLoadingAPIFromGoogleMapsError	L'API Maps JavaScript deve essere scaricata direttamente dal server web.	L'elemento script che carica l'API Maps JavaScript è non siano incluse correttamente nella tua pagina. Affinché l'API funzioni correttamente, deve essere caricato direttamente da https://maps.googleapis.com. Vedi 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 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 le bloccare e far esaminare la tua implementazione, completa questo modulo. Riceverai una risposta via email entro pochi giorni lavorativi. Se hai una licenza per un piano Premium di Google Maps Platform, utilizza il Credenziali del piano Premium di Google Maps Platform per risolvere questo errore. Consulta la guida per 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 può caricare correttamente l'API e l'API non funzionerà su 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 correggere queste potenziali problemi.

Codice di errore dello sviluppatore	Tipo	Descrizione
ApiNotActivatedMapError	Errore	L'API Maps JavaScript non è attivata nel progetto API. Potresti dover abilitare l'API Maps JavaScript nella sezione API di la 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 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 tuo progetto API potrebbe essere stato eliminato dalla console Cloud. Controlla il progetto per il quale hai generato la chiave API incluso nel caricatore dell'API JavaScript. Puoi creare un nuovo progetto API ricevere una nuova chiave nella console Cloud. 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 abilitato la fatturazione nel progetto. Devi abilitare la fatturazione su Google Cloud Progetto associato a questo ID client, qui
BillingNotEnabledMapError	Errore	L'errore non è causato dall'attivazione della fatturazione nel progetto. 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 ha scaduto o non riconosciuto dal sistema. Potresti visualizzare questo errore dopo aver creato un nuova chiave API se tenti di usarla prima che venga riconosciuta dal sistema. Attendi minuti e riprova oppure potresti dover generare una nuova chiave API nella console Cloud. Per ottenere una chiave API, fai clic sul pulsante qui sotto. Inizia
InvalidClientIdMapError	Errore	L'ID client incluso nell'elemento script che carica l'API è non valido o scaduto. Assicurati di utilizzare il tuo ID cliente in modo corretto. 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 è trovato. 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 un formato URI valido come definito in RFC 3986.
MissingKeyMapError	Errore	Nell'elemento 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 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 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 riuscire a trovare altre i dettagli dell'errore nella console Cloud. Vedi Console Cloud.
RefererDeniedMapError	Errore	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 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 per il caricamento dell'API Maps JavaScript non è stato aggiunti 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 API Maps JavaScript. Le richieste della tua app funzioneranno di nuovo alla reimpostazione della quota giornaliera successiva. Se NON sei il proprietario del sito web, non esiste alcuna procedura da seguire per correggere questo errore. Tuttavia, se possibile, ti consigliamo di informare il proprietario del sito. Per ulteriori dettagli, consulta la guida di utilizzo dei dati. In questa pagina viene spiegato anche come ottenere limiti di utilizzo.
ApiProjectMapError	Errore	La chiave API fornita o il progetto API a cui è associata. non può essere risolto. 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 di crittografia in 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 tua chiave di crittografia per l'API Maps JavaScript. Consulta la guida per cliente ID per il piano Premium e Clienti di API di Google Maps for Work.
ClientIdLooksLikeKey	Avviso	Potresti aver fornito una chiave API nel parametro client. Se hai un piano Premium o Licenza API di Google Maps for Work, specifica il client ID come parametro client. 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 per Autenticazione del piano Premium.
InvalidChannel	Avviso	Potresti aver specificato un parametro channel non valido. La il canale deve essere una stringa alfanumerica ASCII, che può includere un punto (.), trattino basso (_) e trattino (-). Assicurati di avere che specifica un parametro channel valido. Vedi Generazione di report | Piano Premium di Google Maps Platform.
InvalidClientId	Avviso	Il parametro client non sembra contenere un valore corretto l'ID client. Un ID client deve iniziare con "gme-". Consulta la guida per 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 qui sotto. Inizia
InvalidVersion	Avviso	Potresti aver fornito un numero di versione errato nell'elemento script. Assicurati di usare un numero di versione corretto. Vedi Controllo delle versioni | API Google Maps JavaScript.
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 per Autenticazione del piano Premium.
KeyLooksLikeCryptoKey	Avviso	Potresti aver fornito una chiave di crittografia o un secret di firma come 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 disponi di un Piano Google Maps Platform Premium, puoi utilizzare un parametro client o un parametro key. Se non hai licenze, puoi per ottenere una chiave API nella console Cloud. Consulta la guida per Specifica 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 un nuovo 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 che includi 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 stai caricando l'API Maps JavaScript dalla versione 2 deprecata di destinazione, riceverai l'avviso NoApiKeys, anche se hai specificato il parametro key. Controlla Guida all'upgrade da v2 a v3 ed eseguire 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 da utilizzare una delle versioni disponibili. Vedi Controllo delle versioni | API Google Maps JavaScript.
SensorNotRequired	Avviso	Il parametro sensor non è più necessario per API Maps JavaScript. ma non impedisce L'API Maps JavaScript non funziona correttamente, ma consigliamo di rimuovere il parametro sensor dall'elemento script.
SignatureNotRequired	Avviso	Il parametro signature non è obbligatorio per API Maps JavaScript. ma non impedisce l'API Maps JavaScript non funziona correttamente, ma potrebbe 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, rivedi il 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 le Output di window.console in Google Chrome. Se utilizzi altre applicazioni browser, consulta la documentazione per sviluppatori del tuo browser. Per riferimento, questo è un elenco di strumenti per verificare 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.

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 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 API Maps JavaScript, vengono visualizzati come una o più righe nella Google Cloud. 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 avere utilizzando gli strumenti basati su WebView2 su Edge. Le versioni precedenti di WebView, basate su Internet Explorer, non sono più supportate.

Se il codice continua a non funzionare

Brendan Kenny e Mano Marks ti indicano che per aiutarti a iniziare a utilizzare il codice per le mappe alcuni errori comuni e come correggerli in questo video.

• Controlla che non ci siano errori di battitura. Ricorda che JavaScript fa distinzione tra maiuscole e minuscole lingua.
• Controlla le basi: alcuni dei problemi più comuni si verificano con creazione iniziale della mappa. Ad esempio:
  • Conferma di aver specificato il zoom e center proprietà nella tua mappa le opzioni di CPU e memoria disponibili.
  • Assicurati di aver dichiarato un elemento div in cui la mappa vengono visualizzate 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, di conseguenza, invisibile.
  Consulta i nostri esempi per una riferimento implementazione.
• Utilizzare un debugger JavaScript per identificare i problemi, come quello disponibile nel Chrome Strumenti per sviluppatori. Inizia cercando gli errori nella console JavaScript.
• Pubblica domande su Stack Extra. Le linee guida su come pubblicare ottime domande sono disponibili su alla pagina Assistenza.