Como processar os erros

Depois de fazer uma solicitação, talvez você receba uma resposta contendo detalhes do erro.

Blocos 2D e imagens do Street View

A lista a seguir detalha os erros que você pode encontrar ao usar blocos 2D e imagens do Street View.

Erro ao listar

A lista abaixo detalha os erros que você pode encontrar ao usar a API Map Tiles.

required

Sua solicitação não tem um parâmetro de URL. Observe que a mensagem de erro indica qual parâmetro está ausente.

notFound, invalid

Seus 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 do mapa e das opções 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 normais de mapas, até o nível de zoom cinco. Nesse ponto, os valores máximos são imageHeight ou imagewidth divididos por tileHeight ou tileWidth.

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

expired

Seu 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 você receber esse erro, precisará receber um novo token de sessão, conforme descrito em Usar tokens de sessão.

badRequest

Sua solicitação foi incorreta. Um motivo comum para isso são:

• 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 é de roteiro.

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

quotaExceeded, rateLimitExceeded

O aplicativo excedeu a cota permitida ou excedeu 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 para que solicitações corrompidas ou falhas em larga escala não sobrecarreguem os servidores do Goodle, já que muitos clientes tentam repetir as solicitações em uma sucessão rápida. Isso significa usar a espera exponencial ao repetir suas solicitações. A espera exponencial força você a distribuir as 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 de novo após quatro segundos. Assim, você espalha efetivamente cada solicitação sucessiva simplesmente dobrando o tempo entre elas.

Blocos 3D

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

Erros do renderizador de blocos

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

A técnica usada para depurar erros de 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 integradas à 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/bloco de blocos inválidos ou um token de sessão expirado.

403: Permissão negada

Chave de API ausente, conexão SSL ausente ou chave de API que não foi adicionada à lista de permissões para blocos 3D. Entre em contato com o Suporte do Google e informe 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 se esgotou. Entre em contato com o Suporte do Google para aumentar sua cota.