Como processar os erros

Desenvolvedores do Espaço Econômico Europeu (EEE)

Depois de fazer uma solicitação, você pode receber uma resposta com detalhes do 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
Falta um parâmetro de URL na sua solicitação. 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 normais, o nível máximo de zoom depende do bloco de mapa específico e das opções de mapa solicitadas.

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

  • Para blocos de mapa normais, 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.

  • Para blocos do Street View, os intervalos de coordenadas x e y são iguais aos de blocos de mapa comuns, até o nível 5 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 a partir do momento da criação. Isso pode mudar sem aviso prévio. Se esse erro aparecer, você vai precisar receber 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 mapa de rota.

  • Você enviou um valor de 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 permitido 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 corrompidas 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 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 o 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 ladrilhos/de blocos 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.