Gestione degli errori

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

Riquadri 2D e immagini di Street View

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

Elenco degli errori

Il seguente elenco descrive in dettaglio gli errori che potresti riscontrare durante l'utilizzo dell'API Map Tiles.

required
Nella tua 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 rientrano nell'intervallo.

  • Per i riquadri della mappa normali, il livello massimo di zoom dipende dal riquadro della mappa specifico e dalle opzioni della mappa che hai richiesto.

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

  • Per i riquadri della mappa 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 0 e 5 inclusi.

  • Per i riquadri di Street View, gli intervalli di coordinate x e y sono gli stessi dei riquadri della mappa normali, fino al livello cinque dello zoom. A quel punto, i valori massimi sono imageHeight o imagewidth diviso per tileHeight o tileWidth.

forbidden: nella richiesta manca una chiave API valida.

expired
Il token session è scaduto. Un token di sessione è valido per due settimane dal momento della creazione. Tieni presente che potrebbe cambiare senza preavviso. Se viene visualizzato questo errore, devi ottenere un nuovo token di sessione, come descritto in Utilizzare i token di sessione.
badRequest

La tua richiesta non era corretta. Alcuni dei 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 lat/lng, nonché un ID panoramica in una richiesta di metadati di Street View.

quotaExceeded, rateLimitExceeded

L'applicazione ha superato la quota consentita o ha superato il numero consentito 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 richiesta

Quando le richieste non vanno a buon fine con quotaExceeded e rateLimitExceeded, ti consigliamo di riprovare in modo che le richieste non funzionanti o gli errori su larga scala non influiscano sui server Goodle, poiché molti client tentano di riprovare rapidamente. Ciò significa utilizzare il backoff esponenziale quando riprovi le richieste. Il backoff esponenziale ti costringe a distribuire le richieste in tempo per concedere al server il tempo di recupero.

Ad esempio, se una richiesta non va a buon fine, riprova dopo un secondo. Tuttavia, se anche questo tentativo non va a buon fine, riprova a inviare la richiesta dopo due secondi. Se anche la richiesta non va a buon fine, riprova dopo quattro secondi. In questo modo, distribuisci in modo efficace ogni richiesta successiva raddoppiando il tempo tra le due.

Riquadri 3D

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

Errori del renderer dei riquadri

Ad esempio, il renderer CesiumJS di solito non funziona correttamente quando si verificano errori del server, il che può causare arresti anomali, schermate vuote o specifici riquadri.

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 esaminare 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 sugli errori più comuni che potresti riscontrare.

400: argomento non valido
Chiavi API, parametri di query, ID riquadri/set di riquadri non validi o un token di sessione scaduto.
403: Autorizzazione negata
La chiave API mancante, la connessione SSL mancante o la chiave API non sono state aggiunte alla lista consentita per i riquadri 3D. Contatta l'Assistenza Google specificando il tuo ID progetto per farti aggiungere alla lista consentita per la funzionalità 3D Tiles dell'API Map Tiles.
429: Troppe richieste
La tua quota è esaurita. Contatta l'Assistenza Google per aumentare la quota.