Messaggi di errore nell'API Maps Static

L'API Maps Static restituisce un errore o un avviso quando una richiesta non va a buon fine. Questa guida spiega i messaggi di errore e fornisce istruzioni per risolverli.

Richieste non valide

Per una richiesta non valida, l'API Maps Static restituisce un codice di stato HTTP 4xx e un messaggio che descrive il problema, come mostrato nel seguente elenco. Controlla il codice di errore e il messaggio effettivi restituiti dall'API per i dettagli di problemi specifici.

La richiesta include un parametro non valido o un parametro obbligatorio mancante. Ad esempio, il parametro size non rientra nell'intervallo previsto di 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. Ad esempio, si verifica un errore quando l'applicazione supera i limiti di utilizzo.

Immagine di errore visualizzata al posto di una mappa
Un'immagine di errore visualizzata al posto di una mappa

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

Errori e soluzioni per l'accesso senza chiave
Errore relativo ai limiti di utilizzo: è stato superato il limite di caricamenti giornalieri della mappa fornito Stai utilizzando l'API Maps Static senza una chiave API. Per risolvere questo errore, completa i seguenti passaggi:
  1. Recupera una chiave API
  2. Abilita fatturazione
  3. Firma l'URL
Errore relativo ai limiti di utilizzo: negli URL delle richieste manca la firma digitale Nella tua richiesta manca una firma digitale obbligatoria. Per risolvere questo errore, firma l'URL.

Avvisi

Per alcune condizioni di errore, l'API restituisce una mappa, ma alcune informazioni potrebbero mancare. Quando si verifica questa situazione, puoi identificare l'avviso utilizzando le seguenti condizioni:

  • La mappa viene visualizzata con una barra di errore gialla sovrapposta alla mappa con il testo "Errore mappa: g.co/staticmaperror".
  • L'API restituisce un avviso sotto forma di intestazione HTTP denominata 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 mostra una barra di errore gialla sovrapposta all'immagine con il testo "Errore mappa: g.co/staticmaperror":

Viene visualizzata una mappa con il messaggio di errore della mappa: g.co/staticmaperror
Una mappa che mostra una barra di avviso gialla

L'API restituisce anche la seguente intestazione HTTP:

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

La tabella seguente descrive 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 geocodifica della richiesta. Esistono molte varianti di questo messaggio, a seconda dell'elemento in cui la geocodifica non è riuscita, ad esempio center, marker, visible o path, e del numero di elementi per cui non è riuscita. Un esempio di questo avviso è X-Staticmap-API-Warning:Error geocoding: marker 1, come mostrato nell'esempio precedente.
Too many geocoded markers requested (max is 15). La richiesta specifica un numero di indicatori superiore al massimo consentito con un indirizzo leggibile. Il valore massimo è 15. Questo limite si applica solo ai marcatori specificati come indirizzo leggibile che richiede la geocodifica. Non si applica ai marcatori specificati con coordinate di latitudine e longitudine.
Too many geocoded polyline vertices requested (max is 15). La richiesta specifica un numero di polilinee superiore al massimo consentito con un indirizzo leggibile. Il valore massimo è 15. Questo limite si applica solo alle polilinee con vertici specificati come indirizzi leggibili che richiedono la geocodifica. Non si applica alle polilinee specificate con coordinate di latitudine e longitudine.

Puoi visualizzare gli avvisi relativi alle intestazioni HTTP nella console Chrome DevTools, nella console web di Firefox o in altri strumenti equivalenti nel browser.