Gestione degli errori

Dopo aver effettuato una richiesta, potresti ricevere una risposta contenente un errore i dettagli.

Riquadri 2D e immagini di Street View

Nell'elenco che segue vengono descritti gli errori che potresti riscontrare durante l'utilizzo del formato 2D Riquadri e immagini di Street View.

Errore durante la creazione dell'elenco

Il seguente elenco illustra gli errori che potresti riscontrare durante l'utilizzo del API Map Tiles.

required

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

notFound, invalid

Il tuo x, y o I valori di z sono fuori intervallo.

• Per riquadri di mappe normali, il livello di zoom massimo dipende dalla riquadro mappa e sulle opzioni della mappa che hai richiesto.

• Per riquadri di mappe normali, la coordinata x deve essere compresa nell'intervallo [0, (2^zoom)-1].

• Per riquadri di 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 di coordinate x e y sono uguali per i riquadri della mappa normali, fino allo zoom al livello cinque. A quel punto, il numero massimo i valori sono imageHeight o imagewidth diviso per tileHeight o tileWidth.

forbidden: Nella richiesta manca una chiave API valida.

expired

Il tuo token session è scaduto. Un token di sessione è valido per due settimane dalla sua creazione. Tieni presente che questo potrebbe cambiare senza preavviso. Se viene visualizzato questo errore, devi generare una nuova sessione come descritto in Utilizza i token di sessione.

badRequest

La tua richiesta non è valida. I motivi più comuni sono:

• Hai specificato un tipo di mappa terrain senza includere un livello roadmap.

• Hai incluso un array styles per un tipo di mappa non stradale.

• Hai inviato un valore latitudine/longitudine e un ID panoramica nei metadati di Street View richiesta.

quotaExceeded, rateLimitExceeded

L'applicazione ha superato la quota consentita o l'ha superata di query al secondo.

Errore di esempio

{
  "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"
  }
}

Nuovo tentativo di richieste

Quando le richieste non vanno a buon fine con quotaExceeded e rateLimitExceeded, riprova a eseguire la richiesta in modo che le richieste non funzionanti o gli errori su larga scala i server di Goodle non vengono inondati perché molti client tentano di ritentare le richieste successione. Ciò significa utilizzare backoff esponenziale quando riprovi a eseguire le richieste. Il backoff esponenziale ti costringe a diffondere in tempo, per dare tempo al server di recuperare.

Ad esempio, se una richiesta non va a buon fine, riprova dopo un secondo. Ma se non va a buon fine e riprova a eseguire la richiesta dopo due secondi. Se questo non va a buon fine, quindi riprova dopo quattro secondi. Quindi distribuite in modo efficace a ogni richiesta successiva raddoppiando semplicemente il tempo che le separano.

Riquadri 3D

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

Errori del renderer dei riquadri

Ad esempio, il renderer CesiumJS solitamente ha esito negativo in caso di errori del server. e questo può portare ad arresti anomali, schermate vuote, Impossibile caricare riquadri.

La tecnica da utilizzare per eseguire il debug degli errori del server dipenderà dalla configurazione il renderer utilizzato. Per renderer basati su browser come CesiumJS, puoi controllare il traffico di rete con 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 durante l'incontro.

400: argomento non valido

Chiavi API, parametri di query, ID riquadri/set di riquadri non validi o una sessione scaduta di accesso.

403: Autorizzazione negata

Chiave API mancante, connessione SSL mancante oppure la chiave API non è stata aggiunta a nella lista consentita per i riquadri 3D. Contatta Google Assistenza con il tuo ID progetto per essere aggiunto. alla lista consentita per la funzionalità 3D Tiles dell'API Map Tiles.

429: Troppe richieste

La tua quota è esaurita. Contatto Assistenza Google per aumentare la tua quota.