L'API Maps Static può generare un errore o un avviso in caso di problemi. Questa guida spiega ogni messaggio di errore e fornisce ulteriori istruzioni per risolverli.
Richieste non valide
In caso di 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 condizioni di errore di questo tipo. Nota: non si tratta di 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 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 il testo o un'immagine di errore al posto della mappa, a seconda dell'errore. Un esempio di questa condizione di errore è quando l'applicazione supera i limiti di utilizzo.
![Immagine di errore visualizzata al posto di una mappa](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/error-image-generic.png?authuser=7&hl=it)
Errori relativi alle chiavi API e alla fatturazione
Se utilizzi l'API Maps Static senza una chiave API o se la fatturazione non è abilitata nel tuo account, nella pagina viene visualizzata 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 senza chiave | |
---|---|
![]() |
Stai utilizzando l'API Maps Static senza una chiave API. Per risolvere il problema, devi: |
![]() |
Nella 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 potrebbero non essere presenti nella mappa. In questo caso, si verificano due condizioni per informarti dell'avviso.
- Il primo è la mappa, ma con una barra di errore gialla sovrapposta alla mappa con il testo "Errore mappa: g.co/staticmaperror".
- In secondo luogo, 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 sopra l'immagine con il messaggio "Errore mappa: g.co/staticmaperror":
![La mappa viene visualizzata, ma con un errore nella mappa: g.co/staticmaperror](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/map-warning.png?authuser=7&hl=it)
L'API restituisce anche la seguente intestazione HTTP:
X-Staticmap-API-Warning:Error geocoding: marker 1
La seguente tabella descrive gli avvisi che l'API potrebbe generare 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 (centro, indicatore, visibile o percorso) non è riuscita e il numero di elementi
con errori. 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 numero massimo consentito con un indirizzo leggibile. Il numero massimo è 15. Tieni presente che questo limite si applica solo agli indicatori specificati come indirizzi leggibili da persone che richiedono la geocodifica. Non si applica agli indicatori specificati con le coordinate di latitudine/longitudine. |
Too many geocoded polyline vertices requested (max is 15). |
La richiesta specifica un numero di polilinee superiore a quello 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 la geocodifica. Non si applica alle polilinee specificate con le coordinate di latitudine/longitudine. |
Puoi visualizzare gli avvisi dell'intestazione HTTP nella console di Chrome DevTools, nella console web di Firefox o in altri strumenti equivalenti nel tuo browser.