Como processar os erros

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

Blocos 2D e imagens do Street View

A lista a seguir detalha os erros que podem ocorrer ao usar recursos 2D Blocos e imagens do Street View.

Erro ao listar

A lista a seguir detalha os erros que você pode encontrar ao usar o 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

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

• Para blocos de mapas comuns, o nível de zoom máximo depende da bloco de mapa e nas opções de mapa que você solicitou.

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

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

• Para blocos do Street View, o zoom deve estar entre 0 e 5, inclusive.

• Para blocos do Street View, os intervalos das coordenadas x e y são os mesmos que para blocos de mapa comuns, até o nível cinco de zoom. Nesse ponto, o valor máximo os valores são imageHeight ou imagewidth dividido 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 duas semanas a partir da data de criação. Isso pode mudar sem aviso prévio. Se você receber esse erro, será necessário criar uma nova sessão token, conforme descrito nas Use tokens de sessão.

badRequest

Sua solicitação estava incorreta. Estes são alguns motivos comuns para isso:

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

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

quotaExceeded, rateLimitExceeded

O aplicativo excedeu ou excedeu a cota permitida o total 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 falham com quotaExceeded e rateLimitExceeded, é necessário repetir a solicitação de modo que solicitações inválidas ou falhas em grande escala não sobrecarreguem os servidores do Goodle, já que muitos clientes tentam repetir as solicitações rapidamente sucessão. Isso significa usar espera exponencial quando você fizer solicitações novamente. A espera exponencial força você a espalhar solicitações a tempo, para dar tempo de recuperação ao servidor.

Por exemplo, se uma solicitação falhar, tente novamente após um segundo. Mas se isso também falhar e, em seguida, repetir a solicitação novamente após dois segundos. Se isso também falhar. Em seguida, tente novamente 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 para você porque você acessa blocos fotorrealistas por meio de um renderizador, que é responsável por manipular do servidor.

Erros do renderizador de blocos

Por exemplo, o renderizador CesiumJS geralmente falha silenciosamente quando erros do servidor ocorrer, o que pode resultar em qualquer coisa, desde falhas, telas em branco até os blocos não carregam.

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

Erros comuns

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

400: argumento inválido

Chaves de API, parâmetros de consulta, IDs de blocos/blocos inválidos ou uma sessão expirada token.

403: Permissão negada

Chave de API ausente, conexão SSL ausente ou sua chave de API não foi adicionada ao a lista de permissões para blocos 3D. Entre em contato com o Google Support pelo ID do projeto para que ele seja adicionado à lista de permissões para a funcionalidade de blocos 3D da API Map Tiles.

429: muitas solicitações

Sua cota acabou. Contato o Suporte do Google para aumentar a cota.