Questa pagina è stata tradotta dall'API Cloud Translation.

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 le tessere 2D e le immagini di Street View.

Elenco errori

Il seguente elenco descrive in dettaglio gli errori che potresti riscontrare quando utilizzi l'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 di x, y o z non rientrano nell'intervallo.

Per le tessere della mappa standard, il livello di zoom massimo dipende dalla tessera della mappa specifica e dalle opzioni della mappa che hai richiesto.
Per le normali tessere della mappa, la coordinata x deve essere compresa nell'intervallo [0, (2^zoom)-1].
Per le normali tessere della mappa, 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 della mappa standard fino al livello di zoom 5. A quel punto, i valori massimi sono imageHeight o imagewidth divisi per tileHeight o tileWidth.

forbidden:

Possibili cause:

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

Le tessere satellitari 2D non sono disponibili nei progetti collegati a un account di fatturazione con un indirizzo nello Spazio economico europeo (SEE). Per ulteriori informazioni, consulta Modifiche all'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 operazione 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 tua richiesta non era valida. 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 roadmap.
Hai inviato un valore di latitudine/longitudine, nonché 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.

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

Ritentare 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 a inviare 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 a inviare 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 raddoppiando semplicemente l'intervallo di tempo tra una richiesta e l'altra.

Riquadri 3D

Gli errori del server di Google potrebbero non essere evidenti perché accedi alle tessere fotorealistiche 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ò causare arresti anomali, schermate vuote o il mancato caricamento di riquadri specifici.

La tecnica che utilizzi per eseguire il debug degli errori del server dipende dal renderer specifico che utilizzi. 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

L'elenco seguente contiene dettagli sugli 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 mapType con cui è stata effettuata la richiesta createSessionToken corrisponda a mapType utilizzato nell'endpoint delle tessere successivo. Ad esempio, un token di sessione streetview non può essere utilizzato per richiedere un riquadro roadmap.

403: Autorizzazione negata