A API Maps Static pode emitir um erro ou aviso quando algo dá errado. Este guia explica cada mensagem de erro e fornece mais e instruções para resolver erros.
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 de possíveis erros. Verifique o código de erro real
e a mensagem retornada pela API para saber mais 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 se encaixa no
intervalo esperado de valores numéricos ou não se encontra 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 impeça a exibição do mapa ocorrer, a API Maps Static vai retornar texto ou uma imagem de erro em vez do mapa, dependendo do erro. Um exemplo desse tipo de erro é quando o aplicativo excede limites de uso.
Erros relacionados a chaves de API e faturamento
Se você usar a API Maps Static sem uma chave de API ou se a cobrança não estiver ativada na sua conta, a página vai mostrar 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, você precisa: |
 |
Sua solicitação não tem uma assinatura digital (obrigatório). Para resolver isso, Assine seu URL |
Avisos
Para 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 o aviso.
- Uma é exibido no mapa, mas com uma barra de erro amarela sobreposta parte de cima do mapa com o texto "Map error: g.co/staticmaperror".
- A segunda é que a API retorna uma advertência na forma de um cabeçalho HTTP chamado
X-Staticmap-API-Warning.
Por exemplo, o URL a seguir contém um valor inesperado na
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 erro amarela sobreposta sobre a imagem 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 HTTP cabeçalhos:
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. Existem
muitas variantes da mensagem, dependendo do elemento no qual a geocodificação
com falha (centro, marcador, visível ou caminho) e o número de elementos
que falharam. Um exemplo desse aviso é
X-Staticmap-API-Warning:Error geocoding: marker 1, conforme
como mostrado no exemplo acima. |
Too many geocoded markers requested (max is 15). |
A solicitação especifica um número de marcadores maior do que o permitido. com um endereço legível. A quantidade máxima é 15. Esse limite aplica-se somente a marcadores especificados como um endereço legível que requer geocodificação. Ele não se aplica a marcadores especificados com coordenadas de latitude/longitude. |
Too many geocoded polyline vertices requested (max is 15). |
A solicitação especifica uma quantidade de polilinhas acima do limite em 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 precisem ser geocodificados. Ele não se aplica a polilinhas especificadas com coordenadas de latitude/longitude. |
Confira as advertências de cabeçalhos HTTP no console das Ferramentas para desenvolvedores do Chrome, no console da Web do Firefox ou em outras ferramentas equivalentes no navegador.