Questa pagina descrive i messaggi di errore che possono essere restituiti dall'API Maps Embed. Quando si verifica un errore, l'API Maps Embed mostra il testo del messaggio di errore al posto della mappa. Potrebbero verificarsi anche determinate condizioni di errore, che comportano la visualizzazione di una mappa con filigrana oscurata.
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 queste condizioni di errore. Nota: questo non è 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 di valori numerici previsto o nella richiesta manca un parametro obbligatorio. |
400 BAD REQUEST |
| La chiave API inclusa nella richiesta non è valida. | 403 FORBIDDEN |
Errori relativi a chiavi API e quote
Gli errori relativi alla chiave API e alla quota vengono trattati come richieste non valide. Ecco alcune possibili cause:
- 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'attivazione e la disattivazione delle API.
- La chiave API presenta una violazione delle restrizioni. Scopri di più sulle best practice per le chiavi API.
Errori di fatturazione e referer HTTP
Viene restituita una mappa scura o un'immagine di Street View "negativa" con la filigrana "solo per scopi di sviluppo" se si verifica una delle seguenti condizioni:
- La fatturazione non è stata attivata sul tuo account. Attiva la fatturazione.
- Il metodo di fatturazione fornito 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 con limitazioni per i referrer. Scopri di più sull'aggiunta di referrer.
Controllare gli errori nel browser
Per gli errori di fatturazione e referrer 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 e quote), nella console viene registrato 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 browser in uso. Come riferimento, di seguito è riportato un elenco di strumenti per controllare l'output della console in alcuni altri browser.
- Console per Internet Explorer.
- Console web per Firefox.
- Debug remoto per Android.
- Web Inspector per iOS.
In Chrome, puoi utilizzare la console JavaScript per controllare l'output della console come segue.
- Per aprire gli 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.