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:
- Chiave API mancante o non valida. Per risolvere questo errore, assicurati che la richiesta includa una chiave API valida. Ottieni una chiave API.
- L'API Maps Embed non è abilitata per il tuo progetto. Scopri di più sull'abilitazione e la disabilitazione delle API.
- La chiave API presenta una violazione delle limitazioni. Scopri di più sulle best practice relative alle chiavi API.
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:
- La fatturazione non è stata attivata sul tuo account. Abilita la fatturazione.
- Il metodo di fatturazione specificato non è valido (ad esempio una carta di credito scaduta). Per risolvere il problema, visita la console Google Cloud e assicurati di aver fornito un metodo di pagamento valido.
- È stato superato un limite giornaliero autoimposto. Scopri come visualizzare o modificare i limiti giornalieri fatturabili.
- Nella richiesta manca un referrer HTTP e stai utilizzando una chiave API limitata per il referrer. Scopri di più sull'aggiunta di referrer.
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.
- Console per Internet Explorer.
- Web Console per Firefox.
- Debug remoto per Android.
- Web Inspector per iOS.
In Chrome, puoi utilizzare la console JavaScript per controllare l'output della console come indicato di seguito.
- Per aprire Strumenti per sviluppatori, seleziona l'icona del menu > Altri strumenti > Strumenti per sviluppatori.
- 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.