Messaggi di errore nell'API Maps Static

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

L'API Maps Static potrebbe restituire errori o avvisi se si verifica un problema. Questa guida spiega ciascun messaggio di errore e fornisce ulteriori istruzioni per risolverli.

Richieste non valide

Nel caso di una richiesta non valida, l'API Maps Static 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 effettivo e il messaggio restituito dall'API per i dettagli relativi a 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 size non rientra nell'intervallo previsto dei valori numerici o non è presente nella richiesta. 400 BAD REQUEST
La chiave API inclusa nella richiesta non è valida. 403 FORBIDDEN

Errori che impediscono la visualizzazione di una mappa

Se la richiesta è valida, ma si verifica un altro errore che impedisce la visualizzazione della mappa, l'API Maps Static restituisce testo o un'immagine di errore anziché la mappa, a seconda dell'errore. Un esempio di questa condizione di errore è quando l'applicazione supera i limiti di utilizzo.

Immagine di errore visualizzata anziché una mappa
Figura: viene visualizzata un'immagine di errore invece di una mappa

Se utilizzi l'API Maps Static senza una chiave API o se la fatturazione non è attivata per il tuo account, nella pagina viene visualizzata un'immagine dell'errore anziché una mappa, con un link che indica il tipo di errore. Ad esempio "g.co/staticmaperror/key".

Soluzioni e errori senza chiavi
Errore relativo ai limiti di utilizzo: è stato superato il limite giornaliero di caricamenti mappa Stai utilizzando l'API Maps Static senza chiave API. Per risolvere il problema, devi:
  1. Ottieni una chiave API
  2. Abilita la fatturazione
  3. Firma l'URL
Errore relativo ai limiti di utilizzo: negli URL della richiesta manca la firma digitale Nella tua richiesta manca una firma digitale (obbligatoria). Per risolvere il problema, firma l'URL.

Avvisi

Per alcune condizioni di errore, l'API restituisce una mappa, ma potrebbero mancare alcune informazioni. In questi casi, ti vengono inviate due condizioni per informarti dell'avviso.

  • Una, la mappa viene visualizzata, ma con una barra di errore gialla sovrapposta alla parte superiore con il testo "Errore mappa: g.co/staticmaperror"".
  • Due, l'API restituisce un avviso sotto forma di intestazione HTTP X-Staticmap-API-Warning.

Ad esempio, il seguente URL contiene un valore imprevisto nel parametro markers:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY

L'API restituisce una mappa, ma visualizza una barra di errore gialla sopra l'immagine con "Map error: g.co/staticmaperror":

La mappa viene visualizzata, ma con errore Maps: g.co/staticmaperror

L'API restituisce anche la seguente intestazione HTTP:

X-Staticmap-API-Warning:Error geocoding: marker 1

Nella tabella seguente vengono descritti gli avvisi che l'API può emettere come intestazioni HTTP:

Avvisi nelle intestazioni X-Staticmap-API-Warning
Error geocoding: [center, ][marker #number, ][visible #num, ][path #num, ]* Si è verificato un errore durante il tentativo di geocodificare la richiesta. Esistono molte varianti di questo messaggio, a seconda dell'elemento in cui la geocodifica non è riuscita (centro, indicatore, visibile o percorso) e del numero di elementi che non sono riusciti. Un esempio di questo avviso è X-Staticmap-API-Warning:Error geocoding: marker 1, come mostrato nell'esempio sopra.
Too many geocoded markers requested (max is 15). La richiesta specifica un numero di indicatori superiore al massimo consentito con un indirizzo leggibile. Il massimo è 15. Tieni presente che questo limite si applica solo agli indicatori specificati come indirizzo leggibile che richiedono la geocodifica. Non si applica agli indicatori specificati con le coordinate di latitudine e longitudine.
Too many geocoded polyline vertices requested (max is 15). La richiesta specifica un numero di polilinee superiore a quello consentito con un indirizzo leggibile. Il massimo è 15. Tieni presente che questo limite si applica solo alle polilinee con vertici specificati come indirizzi leggibili da persone che richiedono la geocodifica. Non si applica alle polilinee specificate con le coordinate di latitudine e longitudine.

Puoi visualizzare gli avvisi relativi all'intestazione HTTP nella console di Chrome DevTools, nella Firefox Web Console o in altri strumenti equivalenti nel browser.