Nesta página, descrevemos as mensagens de erro que a API Maps Embed retorna. Quando ocorre um erro, a API Maps Embed apresenta o texto da mensagem no lugar do mapa. Algumas 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 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 zoom não está dentro do intervalo esperado de valores numéricos ou um parâmetro obrigatório está ausente na solicitação. |
400 BAD REQUEST |
A chave de API incluída na solicitação é inválida. | 403 FORBIDDEN |
Erros de chave de API e QPS
Os erros de chave de API e QPS 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. Gere uma chave de API.
- A API Maps Embed não está ativada no seu projeto. Saiba mais sobre como ativar e desativar APIs.
- A chave de API tem uma violação de restrição. Leia mais sobre as práticas recomendadas das chaves de API.
Erros de faturamento e do referenciador de HTTP
Um mapa escurecido ou 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. Ative 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ê forneceu uma forma de pagamento válida.
- Um limite diário definido manualmente foi excedido. Saiba como consultar ou mudar os limites diários de cobranças.
- A solicitação não tem um referenciador de HTTP, e você está usando uma chave de API restrita a ele. Saiba mais sobre como adicionar referenciadores.
Como verificar erros no navegador
Para erros de faturamento e do referenciador de HTTP, a API Maps Embed grava mensagens de erro em window.console
. Para solicitações inválidas, incluindo
chave de API e erros de QPS, somente 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 relacionada. Esta é uma lista de ferramentas para verificar o resultado 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, conforme mostrado a seguir.
- Para abrir as Ferramentas para desenvolvedores, selecione o ícone de menu > Mais ferramentas > Ferramentas do desenvolvedor.
- Para abrir o Console JavaScript, clique na guia Console na parte de cima da janela "Ferramentas do desenvolvedor". Também é possível usar a tecla ESC para alternar o Console JavaScript.