Nesta página, descrevemos as mensagens de erro que podem ser retornadas pela API Embed do Maps. Quando ocorre um erro, a API Maps Embed apresenta o texto da mensagem de erro no lugar do mapa. Algumas condições de erro também podem ocorrer, o que resulta na apresentação de um mapa com marca-d'água escurecido.
Solicitações inválidas
No caso de uma solicitação inválida, a API Maps Embed retorna um código de status HTTP 4xx e uma mensagem que descreve 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 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 zoom não está dentro do
intervalo esperado de valores numéricos ou um parâmetro obrigatório está ausente
da solicitação. |
400 BAD REQUEST |
| A chave de API incluída na solicitação é inválida. | 403 FORBIDDEN |
Erros de cota e chave de API
Erros de chave de API e cota são tratados como solicitações inválidas. As possíveis causas incluem:
- Chave de API ausente ou inválida. Para resolver esse erro, verifique se a solicitação inclui uma chave de API válida. Gerar uma chave de API.
- A API Maps Embed não está ativada para seu projeto. Saiba como ativar e desativar APIs.
- A chave de API tem uma violação de restrição. Saiba mais sobre as práticas recomendadas de chaves de API.
Erros de faturamento e de redirecionamento HTTP
Um mapa escurecido ou uma imagem "negativa" do Street View com a marca d'água "somente para fins de desenvolvimento" é retornado quando uma das seguintes condições é verdadeira:
- O faturamento não foi ativado na sua conta. Ativar o faturamento.
- O método de faturamento fornecido é inválido (por exemplo, um cartão de crédito expirado). Para resolver esse problema, acesse o console do Google Cloud e verifique se você informou uma forma de pagamento válida.
- Um limite diário definido pelo próprio usuário foi excedido. Saiba como conferir ou mudar os limites de faturamento diários.
- A solicitação não tem um referenciador HTTP, e você está usando uma chave de API restrita a um referenciador. Saiba como adicionar referenciadores.
Verificar erros no navegador
Para erros de faturamento e de referenciador HTTP, a API Maps Embed grava
mensagens de erro em window.console. Para solicitações inválidas (incluindo
erros de chave de API e cota), apenas o código de status HTTP 4xx é informado
no console. Esta seção explica como verificar a saída do console no
Google Chrome. Se você estiver usando outro navegador, consulte a documentação
para desenvolvedores dele. Esta é uma lista de ferramentas para
verificar a saída do console em alguns outros navegadores.
- Console do Internet Explorer.
- Console da Web do Firefox.
- Depuração remota para Android.
- Web Inspector para iOS.
No Chrome, use o Console JavaScript para verificar a saída do console da seguinte maneira.
- Para abrir as Ferramentas para desenvolvedores, selecione o ícone de menu > Mais ferramentas > Ferramentas para desenvolvedores.
- Para abrir o Console JavaScript, clique na guia Console na parte de cima da janela Ferramentas para desenvolvedores. Também é possível usar a tecla ESC para abrir e fechar o Console JavaScript.