Esta página descreve as mensagens de erro que podem ser retornadas pelo a API Maps Embed. Quando ocorre um erro, o A API Maps Embed apresenta o texto da mensagem de erro no lugar do mapa. Certas condições de erro também podem ocorrer, o que resulta na exibiçã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 descrevendo
problema. Apresentamos abaixo alguns exemplos dessas condições de erro. Observação: isso não é
uma lista completa dos possíveis erros. Verifique o código de erro real
e a mensagem retornada pela API para detalhes de 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á
desaparecidos. Por exemplo, o parâmetro zoom não está no
intervalo esperado de valores numéricos ou falta um parâmetro obrigatório de
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
Os erros de chave de API e cota são tratados como solicitações inválidas. Possíveis causas incluem o seguinte:
- Chave de API ausente ou inválida. Para resolver esse erro, verifique se inclui uma chave de API válida. Gerar uma chave de API
- A API Maps Embed não está ativada no seu projeto. Saiba mais sobre ativar e desativar APIs.
- A chave de API tem uma violação de restrição. Leitura mais sobre as práticas recomendadas das chaves de API.
Erros de faturamento e do referenciador de HTTP
Um mapa escurecido, ou "negativo", Imagem do Street View, marca d'água com Pronto" para apenas para fins de desenvolvimento" será retornado quando uma das seguintes condições for verdadeira:
- O faturamento não foi ativado em sua conta. Ativar faturamento.
- O método de faturamento fornecido é inválido (por exemplo, um crédito expirado card). 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 visualizar ou mudar os limites diários faturáveis.
- A solicitação não tem um referenciador de HTTP, e você está usando um chave de API restrita ao referenciador. Aprender mais sobre como adicionar referenciadores.
Verificar erros no navegador
No caso de erros de faturamento e do referenciador de HTTP, a API Maps Embed grava
mensagens de erro para window.console. Para solicitações inválidas (incluindo
erros de cota e chave de API), somente o código de status HTTP 4xx é informado
no console. Esta seção explica como verificar a saída do console em
Google Chrome Se você estiver usando outro navegador, consulte o site do desenvolvedor
documentação do seu navegador. Para sua referência, esta é uma lista de ferramentas para
verificar a saída do console em outros navegadores.
- Console do Internet Explorer.
- Console da Web do Firefox.
- Depuração remota para Android.
- Web Inspector para iOS.
No Chrome, use o botã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 superior do a janela "Ferramentas do desenvolvedor". Você também pode usar a tecla ESC para alternar o Console JavaScript.