Gestione degli errori

Sviluppatori dello Spazio economico europeo (SEE)

Dopo aver inviato una richiesta, potresti ricevere una risposta contenente i dettagli dell'errore.

Riquadri 2D e immagini di Street View

Il seguente elenco descrive in dettaglio gli errori che potresti riscontrare quando utilizzi i riquadri 2D e le immagini di Street View.

Elenco degli errori

Il seguente elenco descrive in dettaglio gli errori che potresti riscontrare quando utilizzi l'API Map Tiles.

required

Nella richiesta manca un parametro URL. Tieni presente che il messaggio di errore indica quale parametro manca.

notFound, invalid

I valori x, y o z non sono compresi nell'intervallo.

Per i riquadri delle mappe normali, il livello di zoom massimo dipende dal riquadro della mappa specifico e dalle opzioni della mappa richieste.
Per i riquadri delle mappe normali, la coordinata x deve essere compresa nell'intervallo [0, (2^zoom)-1].
Per i riquadri delle mappe normali, la coordinata y deve essere compresa nell'intervallo [0, (2^(zoom-1))-1].
Per i riquadri di Street View, lo zoom deve essere compreso tra zero e cinque, inclusi.
Per i riquadri di Street View, gli intervalli delle coordinate x e y sono gli stessi dei riquadri delle mappe normali, fino al livello di zoom cinque. A questo punto, i valori massimi sono imageHeight o imagewidth divisi per tileHeight o tileWidth.

forbidden:

Possibili cause:

Nella richiesta manca una chiave API valida.
Messaggio: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

I riquadri satellitari 2D non sono disponibili nei progetti collegati a un account di fatturazione con un indirizzo nello Spazio economico europeo (SEE). Per ulteriori informazioni, vedi Modifiche dell'API Map Tiles per i clienti del SEE .

expired

Il token session è scaduto. Un token di sessione è valido per due settimane dalla data di creazione. Tieni presente che questa impostazione potrebbe cambiare senza preavviso. Se ricevi questo errore, devi ottenere un nuovo token di sessione, come descritto in Utilizzare i token di sessione.

badRequest

La richiesta non era valida. Alcuni dei motivi più comuni sono:

Hai specificato un tipo di mappa terrain senza includere un layer roadmap.
Hai incluso un array styles per un tipo di mappa non stradale.
Hai inviato un valore di latitudine/longitudine e un ID panorama in una richiesta di metadati di Street View.

quotaExceeded, rateLimitExceeded

La tua applicazione ha superato la quota consentita o il numero consentito di query al secondo.

Esempio di errore

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

Riprovare le richieste

Quando le richieste non vanno a buon fine con quotaExceeded e rateLimitExceeded, devi riprovare la richiesta in modo che le richieste interrotte o gli errori su larga scala non inondino i server di Google, poiché molti client tentano di riprovare le richieste in rapida successione. Ciò significa utilizzare il backoff esponenziale quando riprovi le richieste. Il backoff esponenziale ti costringe a distribuire le richieste nel tempo, per dare al server il tempo di recuperare.

Ad esempio, se una richiesta non va a buon fine, riprova dopo un secondo. Se anche questo tentativo non va a buon fine, riprova la richiesta dopo due secondi. Se anche questa richiesta non va a buon fine, riprova dopo quattro secondi. In questo modo, distribuisci ogni richiesta successiva semplicemente raddoppiando la durata del tempo tra una richiesta e l'altra.

Riquadri 3D

Gli errori del server di Google potrebbero non essere evidenti perché accedi ai riquadri fotorealistici tramite un renderer, che è responsabile della gestione degli errori del server.

Errori del renderer dei riquadri

Ad esempio, il renderer CesiumJS in genere non genera errori quando si verificano errori del server, il che può comportare arresti anomali, schermate vuote o il mancato caricamento di riquadri specifici.

La tecnica utilizzata per eseguire il debug degli errori del server dipende dal renderer specifico utilizzato. Per i renderer basati su browser come CesiumJS, puoi ispezionare il traffico di rete con gli strumenti integrati nella maggior parte dei browser. Ad esempio, puoi utilizzare Chrome DevTools.

Errori comuni

Il seguente elenco contiene i dettagli degli errori più comuni che potresti riscontrare.

400: Argomento non valido: Chiavi API, parametri di query, ID riquadro/tileset non validi o token di sessione scaduto.
400: Valore non valido: Assicurati che il valore di mapType con cui è stata effettuata la richiesta createSessionToken corrisponda al valore di mapType utilizzato nell'endpoint del riquadro successivo. Ad esempio, un token di sessione streetview non può essere utilizzato per richiedere un riquadro roadmap.

403: Autorizzazione negata