Como processar os erros

Depois de fazer uma solicitação, você pode receber uma resposta com detalhes de erro.

Blocos 2D e imagens do Street View

A lista a seguir detalha os erros que podem ser encontrados ao usar blocos 2D e imagens do Street View.

Lista de erros

A lista a seguir detalha os erros que podem ser encontrados ao usar a API Map Tiles.

required

Sua solicitação está sem um parâmetro de URL. A mensagem de erro indica qual parâmetro está faltando.

notFound, invalid

Os valores x, y ou z estão fora do intervalo.

• Para blocos de mapa comuns, o nível de zoom máximo depende do bloco de mapa específico e das opções de mapa solicitadas.

• Para blocos de mapa comuns, a coordenada x precisa estar no intervalo [0, (2^zoom)-1].

• Para blocos de mapa comuns, a coordenada y precisa estar no intervalo [0, (2^(zoom-1))-1].

• Para blocos do Street View, o zoom precisa estar entre zero e cinco, inclusive.

• Nos blocos do Street View, os intervalos das coordenadas x e y são os mesmos dos blocos de mapas comuns, até o nível cinco de zoom. Nesse ponto, os valores máximo são imageHeight ou imagewidth divididos por tileHeight ou tileWidth.

forbidden: a solicitação não tem uma chave de API válida.

expired

O token session expirou. Um token de sessão é válido por duas semanas após a criação. Observe que isso pode mudar sem aviso prévio. Se você receber esse erro, será necessário conseguir um novo token de sessão, conforme descrito em Usar tokens de sessão.

badRequest

Sua solicitação estava incorreta. Confira alguns motivos comuns:

• Você especificou um tipo de mapa terrain sem incluir uma camada roadmap.

• Você incluiu uma matriz styles para um tipo de mapa que não é um roadmap.

• Você enviou um valor lat/lng e um ID de panorama em uma solicitação de metadados do Street View.

quotaExceeded, rateLimitExceeded

Seu aplicativo excedeu a cota permitida ou o número de consultas por segundo.

Exemplo de erro

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

Como reenviar solicitações

Quando as solicitações falharem com quotaExceeded e rateLimitExceeded, tente novamente de modo que solicitações inválidas ou falhas em grande escala não inundem os servidores do Google, já que muitos clientes tentam repetir as solicitações em rápida sucessão. Isso significa usar a espera exponencial quando você repetir as solicitações. A espera exponencial força você a distribuir suas solicitações a tempo, para dar ao servidor tempo para se recuperar.

Por exemplo, se uma solicitação falhar, tente novamente após um segundo. No entanto, se essa tentativa também falhar, tente fazer a solicitação novamente após dois segundos. Se essa solicitação também falhar, tente novamente após quatro segundos. Assim, você distribui efetivamente cada solicitação sucessiva simplesmente dobrando o tempo entre elas.

Blocos 3D

Os erros do servidor do Google podem não ser óbvios para você porque você acessa telhas fotorrealistas usando um renderizador, que é responsável por processar erros do servidor.

Erros do renderizador de blocos

Por exemplo, o renderizador do CesiumJS geralmente falha silenciosamente quando ocorrem erros do servidor, o que pode resultar em falhas, telas em branco ou blocos específicos não carregados.

A técnica usada para depurar erros do servidor depende do renderizador específico que você usa. Para renderizadores baseados em navegador, como o CesiumJS, é possível inspecionar o tráfego de rede com ferramentas incorporadas à maioria dos navegadores. Por exemplo, você pode usar Chrome DevTools.

Erros comuns

A lista a seguir contém detalhes sobre os erros mais comuns que você pode encontrar.

400: Argumento inválido

Chaves de API, parâmetros de consulta, IDs de bloco de telhas/de blocos inválidos ou um token de sessão expirado.

403: Permissão negada

Chave de API ausente, conexão SSL ausente ou a chave de API não foi adicionada à lista de permissões para Blocos 3D. Entre em contato com o Suporte do Google com o ID do projeto para ser adicionado à lista de permissões da funcionalidade 3D Tiles da API Map Tiles.

429: Muitas solicitações

Sua cota foi esgotada. Entre em contato com o Suporte do Google para aumentar sua cota.