Messaggi di errore nell'API Maps Static

L'API Maps Static potrebbe generare un errore o un avviso in caso di problemi sbagliato. Questa guida spiega ogni messaggio di errore e fornisce ulteriori istruzioni per la risoluzione degli errori.

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 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 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 oppure un parametro obbligatorio è mancante. Ad esempio, il parametro size non rientra nell'intervallo di valori numerici previsto 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 alla mappa visualizzato, l'API Maps Static restituisce del testo o un errore anziché la mappa, a seconda dell'errore. Un esempio di una condizione di errore di questo tipo si verifica quando l'applicazione supera i suoi limiti di utilizzo.

Immagine di errore visualizzata al posto di una mappa
Figura: un'immagine di errore visualizzata al posto di una mappa

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

Errori e soluzioni senza chiave
Errore relativo ai limiti di utilizzo: superato il limite di caricamenti giornalieri delle mappe specificato Stai utilizzando l'API Maps Static senza una chiave API. Per risolvere il problema, devi:
  1. Ottieni una chiave API
  2. Attiva la fatturazione
  3. Firmare l'URL
Errore relativo ai limiti di utilizzo: negli URL di 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 alcune informazioni possono non siano presenti sulla mappa. In questo caso, si verificano due condizioni per informarti dell'avviso.

  • Uno, la mappa viene visualizzata, ma con una barra di errore gialla sovrapposta alla parte superiore della mappa con il testo "Errore mappa: g.co/staticmaperror".
  • Due: 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 campo 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 "Errore mappa: g.co/staticmaperror":

La mappa viene visualizzata, ma con l'errore Mappa: g.co/staticmaperror

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 potrebbe emettere come HTTP intestazioni:

Avvisi negli 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 il 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 показано показано nell'esempio riportato 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 numero massimo è 15. Tieni presente che questo limite si applica solo ai marker specificati come indirizzo leggibile da una persona che richiede la geocodifica. Non si applica ai marker specificati con coordinate di latitudine/longitudine.
Too many geocoded polyline vertices requested (max is 15). La richiesta specifica un numero di polilinee superiori al massimo consentito con un indirizzo leggibile. Il numero massimo è 15. Tieni presente che questo limite si applica solo alle polilinee con vertici specificati come indirizzi leggibili da persone che richiedono il geocodificazione. Non si applica alle polilinee specificate con coordinate di latitudine/longitudine.

Puoi vedere gli avvisi dell'intestazione HTTP nella Console di Chrome DevTools, Firefox Console web o altri strumenti equivalenti nel tuo browser.