In questa pagina vengono descritti i messaggi di errore che possono essere restituiti dal API Maps Embed. Quando si verifica un errore, L'API Maps Embed presenta il testo del messaggio di errore al posto della mappa. Possono verificarsi anche determinate condizioni di errore, che comportano la visualizzazione di un mappa oscurata con filigrana.
Richieste non valide
Nel caso di una richiesta non valida, l'API Maps Embed restituisce
un codice di stato HTTP 4xx e un messaggio che descrive
problema. Di seguito sono riportati alcuni esempi di queste condizioni di errore. Nota: non sono
un elenco completo dei possibili errori. Controlla il codice di errore effettivo
e il messaggio restituito dall'API per i dettagli di problemi specifici.
| Esempio di condizione di errore | Codice di stato |
|---|---|
La richiesta include un parametro non valido oppure un parametro obbligatorio è
mancante. Ad esempio, il parametro zoom non si trova nel tag
intervallo previsto di valori numerici o manca un parametro obbligatorio nella
la richiesta. |
400 BAD REQUEST |
| La chiave API inclusa nella richiesta non è valida. | 403 FORBIDDEN |
Errori di quota e chiave API
Gli errori di quota e della chiave API vengono trattati come richieste non valide. Possibili cause include:
- Chiave API mancante o non valida. Per risolvere questo errore, assicurati che i tuoi include una chiave API valida. Ottieni una chiave API.
- L'API Maps Embed non è abilitata per il tuo progetto. Informazioni su abilitazione e disabilitazione delle API.
- La chiave API presenta una violazione delle restrizioni. Letto di più sulle best practice relative alle chiavi API.
Errori di fatturazione e del referrer HTTP
Una mappa oscurata o "esclusa" Immagine di Street View, filigranata con src per solo a scopo di sviluppo" viene restituito quando una delle seguenti condizioni è vera:
- La fatturazione non è stata abilitata nel tuo account. Abilitare la fatturazione.
- Il metodo di fatturazione specificato non è valido (ad esempio, un credito scaduto scheda). Per risolvere il problema, visita la console Google Cloud e assicurati di aver fornito un metodo di pagamento valido.
- È stato superato un limite giornaliero autoimpostato. Scopri come visualizzare o modificare i limiti fatturabili giornalieri.
- Nella richiesta manca un referrer HTTP e stai utilizzando un chiave API limitata dal referer. Impara scopri di più sull'aggiunta dei referrer.
Controllare gli errori nel browser
Per errori di fatturazione e del referrer HTTP, l'API Maps Embed scrive
messaggi di errore a window.console. Per le richieste non valide (tra cui
errori di quota e chiave API), viene segnalato solo il codice di stato HTTP 4xx
nella console. Questa sezione spiega come controllare l'output della console in
Google Chrome. Se utilizzi altri browser, rivolgiti allo sviluppatore
per il tuo browser. Come riferimento, ecco un elenco di strumenti per
e controllare l'output della console
in altri browser.
- Console per Internet Explorer.
- Console web per Firefox.
- Debug remoto per Android.
- Ispettore web per iOS.
In Chrome puoi utilizzare 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 di nella finestra Strumenti per sviluppatori. Puoi anche utilizzare il tasto ESC per attivare/disattivare Console JavaScript.