Quando algo dá errado, a API Maps Static pode emitir um erro ou aviso. 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 saber 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 um parâmetro obrigatório está ausente. Por exemplo, o parâmetro size não está dentro do intervalo esperado de valores numéricos ou não está 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 ocorrer outro erro que impeça a exibição do mapa, a API Maps Static retornará texto ou uma imagem de erro no lugar do mapa, dependendo do erro. Um exemplo dessa condição de erro é quando o aplicativo excede os limites de uso.
![Imagem de erro exibida no lugar de um mapa](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/error-image-generic.png?authuser=7&hl=pt)
Erros relacionados a chaves de API e faturamento
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, "g.co/staticmaperror/key".
Erros e soluções sem chave | |
---|---|
![]() |
Você está usando a API Maps Static sem uma chave de API. Para resolver, faça o seguinte: |
![]() |
Sua solicitação não tem uma assinatura digital (obrigatório). Para resolver, assine seu URL |
Avisos
Em algumas condições de erro, a API retorna um mapa, mas é possível que algumas informações estejam faltando. Quando isso acontece, duas condições ocorrem para informar o alerta.
- Primeiro, o mapa é exibido, mas com uma barra de erro amarela sobreposta na parte superior do mapa com o texto "Map error: g.co/staticmaperror".
- Depois, a API 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 mostra uma barra de erro amarela sobreposta à imagem com "Map error: g.co/staticmaperror":
![O mapa é exibido, mas com "Map error: g.co/staticmaperror](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/map-warning.png?authuser=7&hl=pt)
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 com falha. Um exemplo desse alerta é
X-Staticmap-API-Warning:Error geocoding: marker 1 , conforme
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 apenas 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 apenas 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 do cabeçalho HTTP no Console do Chrome DevTools, no Console da Web do Firefox ou em outras ferramentas equivalentes no navegador.