Mensagens de erro na API Maps Static

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

A API Maps Static pode emitir um erro ou um aviso quando algo der errado. Este guia explica cada mensagem de erro e fornece mais instruções para resolvê-los.

Solicitações inválidas

No caso de uma solicitação inválida, a API Maps Static retorna um código de status HTTP 4xx e uma mensagem descrevendo o problema. Apresentamos abaixo alguns exemplos dessas condições de erro. Observação: essa não é uma lista completa dos possíveis erros. Verifique o código do erro real e a mensagem retornada pela API para mais detalhes sobre problemas específicos.

Exemplo de condição de erro Código de status
A solicitação inclui um parâmetro inválido ou falta um parâmetro obrigatório. Por exemplo, o parâmetro size não está no intervalo esperado de valores numéricos ou está ausente na solicitação. 400 BAD REQUEST
A chave de API incluída na solicitação é inválida. 403 FORBIDDEN

Erros que impedem a exibição de um mapa

Se a solicitação for válida, mas outro erro que impedir a exibição do mapa, a API Maps Static retornará texto ou uma imagem de erro em vez do mapa, dependendo do erro. Um exemplo dessa condição de erro ocorre quando o aplicativo excede os limites de uso.

Imagem de erro exibida no lugar de um mapa
Figura: uma imagem de erro exibida em vez de um mapa

Se você usar a API Maps Static sem uma chave de API ou se o faturamento não estiver ativado na sua conta, a página exibirá uma imagem de erro em vez de um mapa, com um link indicando o tipo de erro. Por exemplo, "quot;g.co/staticmaperror/key".

Soluções e erros sem chave
Erro nos limites de uso: o limite diário de carregamentos de mapa fornecido foi excedido Você está usando a API Maps Static sem uma chave de API. Para resolver, faça o seguinte:
  1. Conseguir uma chave de API
  2. Ativar o faturamento
  3. Assinar o URL
Erro nos limites de uso: os URLs de solicitação não têm a assinatura digital Sua solicitação não tem uma assinatura digital (obrigatória). Para resolver, assine seu URL

Avisos

Em algumas condições de erro, a API retorna um mapa, mas algumas informações podem estar ausentes. Quando isso acontece, duas condições ocorrem para informar sobre o aviso.

  • Primeiro, o mapa é exibido, mas com uma barra de erro amarela sobreposta no mapa, com o texto "Map error: g.co/staticmaperror".
  • A segunda retorna um aviso na forma de um cabeçalho HTTP chamado X-Staticmap-API-Warning.

Por exemplo, o URL a seguir contém um valor inesperado no parâmetro markers:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY

A API retorna um mapa, mas exibe uma barra de erros amarela sobreposta à imagem com "Map error: g.co/staticmaperror":

O mapa é exibido, mas com "Map error: g.co/staticmaperror

A API também retorna o seguinte cabeçalho HTTP:

X-Staticmap-API-Warning:Error geocoding: marker 1

A tabela a seguir descreve os avisos que a API pode emitir como cabeçalhos HTTP:

Avisos nos cabeçalhos X-Staticmap-API-Warning
Error geocoding: [center, ][marker #number, ][visible #num, ][path #num, ]* Ocorreu um erro durante a tentativa de geocodificação da solicitação. Há muitas variantes dessa mensagem, dependendo do elemento em que a geocodificação falhou (centro, marcador, visível ou caminho) e do número de elementos que falharam. Um exemplo desse alerta é X-Staticmap-API-Warning:Error geocoding: marker 1, como mostrado no exemplo acima.
Too many geocoded markers requested (max is 15). A solicitação especifica mais do que o número máximo permitido de marcadores com um endereço legível. A quantidade máxima é 15. Esse limite se aplica somente a marcadores especificados como endereços legíveis que exigem geocodificação. e não a marcadores especificados com coordenadas de latitude/longitude.
Too many geocoded polyline vertices requested (max is 15). A solicitação especifica mais do que o número máximo permitido de polilinhas com um endereço legível. A quantidade máxima é 15. Esse limite se aplica somente a polilinhas com vértices especificados como endereços legíveis que exigem geocodificação. e não a polilinhas especificadas com coordenadas de latitude/longitude.

Veja os avisos de cabeçalho HTTP no Console do Chrome DevTools, no Console da Web do Firefox ou em outras ferramentas equivalentes do navegador.