Partecipa al nostro prossimo Google Maps Platform Developer Community Day a San Francisco a dicembre. Fai domanda ora per partecipare.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Gestione degli errori

Sviluppatori dello Spazio economico europeo (SEE)

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

Immagini di Street View e 2D Tiles

Il seguente elenco descrive in dettaglio gli errori che potresti riscontrare durante l'utilizzo di tile 2D e immagini di Street View.

Elenco errori

Il seguente elenco descrive 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 standard, il livello di zoom massimo dipende dal riquadro della mappa specifico e dalle opzioni della mappa richieste.
Per i riquadri di mappa normali, la coordinata x deve essere compresa nell'intervallo [0, (2^zoom)-1].
Per i riquadri di mappa standard, la coordinata y deve essere compresa nell'intervallo [0, (2^(zoom-1))-1].
Per i riquadri Street View, lo zoom deve essere compreso tra zero e cinque inclusi.
Per i riquadri Street View, gli intervalli delle coordinate x e y sono gli stessi dei riquadri della mappa normali, 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.

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

expired

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

badRequest

La tua richiesta non è in un formato corretto. 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 di latitudine/longitudine e un ID panorama in una richiesta di metadati di Street View.

quotaExceeded, rateLimitExceeded

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

Nuovo tentativo di invio delle richieste

Quando le richieste non vanno a buon fine con quotaExceeded e rateLimitExceeded, devi riprovare la richiesta in modo che le richieste non riuscite o gli errori su larga scala non sovraccarichino i server 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 riprendersi.

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

3D Tiles

Gli errori del server di Google potrebbero non essere evidenti perché accedi alle tile 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 segnala gli 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 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 sugli errori più comuni che potresti riscontrare.

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

403: Permission denied