Messaggi di errore

Questa pagina descrive i messaggi di errore che possono essere restituiti dall'API Maps Embed. Quando si verifica un errore, l'API Maps Embed fornisce un testo del messaggio di errore al posto della mappa. Possono anche verificarsi determinate condizioni di errore, che comportano la visualizzazione di una mappa con filigrana scura.

Richieste non valide

In caso di richiesta non valida, l'API Maps Embed restituisce un codice di stato HTTP 4xx e un messaggio che descrive il problema. Di seguito sono riportati alcuni esempi di condizioni di errore di questo tipo. Nota: non si tratta di un elenco completo dei possibili errori. Controlla il codice di errore e il messaggio effettivi restituiti dall'API per i dettagli di problemi specifici.

Esempio di condizione di errore Codice di stato
La richiesta include un parametro non valido o manca un parametro obbligatorio. Ad esempio, il parametro zoom non rientra nell'intervallo previsto di valori numerici oppure un parametro obbligatorio manca nella richiesta. 400 BAD REQUEST
La chiave API inclusa nella richiesta non è valida. 403 FORBIDDEN

Errori di chiave API ed QPS

Gli errori di chiave API e QPS vengono trattati come richieste non valide. Le possibili cause includono:

Errori di fatturazione e del referrer HTTP

Viene restituita una mappa scura o un'immagine di Street View "negativa" con filigrana con l'icona {8}solo a scopo di sviluppo" quando si verifica una delle seguenti condizioni:

Controllo degli errori nel browser

In caso di errori di fatturazione e di riferimento HTTP, l'API Maps Embed scrive i messaggi di errore in window.console. Per le richieste non valide (inclusi gli errori relativi a chiavi API ed QPS), nella console viene riportato solo il codice di stato HTTP 4xx. Questa sezione spiega come controllare l'output della console in Google Chrome. Se utilizzi altri browser, consulta la documentazione per sviluppatori del tuo browser. Ecco un elenco di strumenti per controllare l'output della console in altri browser.

In Chrome, puoi utilizzare la console JavaScript per controllare l'output della 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, fai clic sulla scheda Console nella parte superiore della finestra Strumenti per sviluppatori. Puoi anche utilizzare il tasto ESC per attivare/disattivare la console JavaScript.