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.

Lista de erros

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á ausente.

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 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 os mesmos dos blocos de mapa normais 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:

Falta uma chave de API válida na solicitação.
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 do Espaço Econômico Europeu (EEE). Para mais informações, consulte Ajustes da API Map Tiles para clientes do EEE customers.

expired

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

badRequest

Sua solicitação estava malformada. 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 mapa rodoviário.
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, é necessário tentar novamente de forma que as solicitações quebradas ou falhas em grande escala não sobrecarreguem os servidores do Google, já que muitos clientes tentam reenviar as solicitações em rápida sucessão. Isso significa usar a espera exponencial ao tentar novamente as solicitações. A espera exponencial força você a distribuir as solicitações ao longo do tempo para dar tempo ao servidor de se recuperar.

Por exemplo, se uma solicitação falhar, tente novamente após um segundo. Mas, se essa tentativa também falhar, tente 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 período de tempo 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 blocos

Por exemplo, o renderizador CesiumJS geralmente falha silenciosamente quando ocorrem erros do 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 usado. Para renderizadores baseados em navegador, como o CesiumJS, é possível inspecionar o tráfego de rede com ferramentas integradas na 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 podem ocorrer.

400: argumento inválido: Chaves de API, parâmetros de consulta, IDs de bloco/conjunto de blocos ou um token de sessão expirado inválidos.
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