Esta página foi traduzida pela API Cloud Translation.

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 ocorrer ao usar blocos 2D e imagens do Street View.

Erro ao listar

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

required

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

notFound, invalid

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

Para blocos de mapa comuns, o nível máximo de zoom depende do bloco específico e das opções de mapa solicitadas.
Para blocos de mapa regulares, a coordenada x precisa estar no intervalo [0, (2^zoom)-1].
Para blocos de mapa regulares, 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, incluindo esses dois valores.
Para blocos do Street View, os intervalos de coordenadas x e y são os mesmos dos blocos de mapa comuns até o nível de zoom cinco. Nesse ponto, os valores máximos são imageHeight ou imagewidth divididos por tileHeight ou tileWidth.

forbidden:

Possíveis causas:

A solicitação não tem uma chave de API válida.
Mensagem: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

Os blocos de satélite 2D não estão disponíveis em projetos vinculados a uma conta de faturamento com um endereço no Espaço Econômico Europeu (EEE). Para mais informações, consulte Ajustes da API Map Tiles para clientes do EEE.

expired

Seu token session expirou. Um token de sessão é válido por duas semanas a partir da data de criação. Isso pode mudar sem aviso prévio. Se você receber esse erro, será necessário gerar um novo token de sessão, conforme descrito em Usar tokens de sessão.

badRequest

Sua solicitação estava incorreta. Isso pode ocorrer porque:

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 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 falham com quotaExceeded e rateLimitExceeded, tente de novo de forma que solicitações corrompidas ou falhas em grande escala não inundem os servidores do Google, já que muitos clientes tentam novamente em rápida sucessão. Isso significa usar a espera exponencial ao repetir as solicitações. A espera exponencial força você a distribuir suas solicitações ao longo do tempo para dar tempo ao servidor de se recuperar.

Por exemplo, se uma solicitação falhar, tente de novo após um segundo. Mas 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ê efetivamente espalha cada solicitação sucessiva simplesmente dobrando o período entre elas.

Blocos 3D

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

Erros do renderizador de bloco

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

A técnica usada para depurar erros do servidor depende do renderizador específico. 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/conjunto de blocos inválidos ou um token de sessão expirado.
400: valor inválido: Verifique se o mapType com que a solicitação createSessionToken foi feita corresponde ao mapType usado no endpoint de bloco subsequente. Por exemplo, um token de sessão streetview não pode ser usado para solicitar um bloco roadmap.

403: permissão negada