Nesta página, descrevemos as mensagens de erro que podem ser retornadas pela API Maps Embed. Quando ocorre um erro, a API Maps Embed mostra o texto da mensagem de erro 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 escuro.
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 mais 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 falta um parâmetro obrigatório. 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 |
Chave de API e erros de QPS
Os erros de chave de API e QPS são tratados como solicitações inválidas. Estas são as possíveis causas:
- Chave de API ausente ou inválida. Para resolver esse erro, verifique se a solicitação inclui uma chave de API válida. Receba uma chave de API.
- A API Maps Embed não está ativada para o projeto. Saiba mais sobre como ativar e desativar APIs.
- A chave de API apresenta uma violação de restrição. Leia mais sobre as práticas recomendadas das chaves de API.
Erros de referenciador de HTTP e faturamento
Um mapa escuro ou imagem do Street View negativa, com marca-d'água, apenas para fins de desenvolvimento e retornado quando qualquer uma das condições a seguir for 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 isso, acesse o Console do Google Cloud e confira se você forneceu uma forma de pagamento válida.
- Um limite diário definido pelo próprio usuário foi excedido. Saiba como ver ou alterar limites faturáveis faturáveis.
- A solicitação não tem um referenciador de HTTP, e você está usando uma chave de API restrita a um referenciador. Saiba mais sobre como adicionar referenciadores.
Verificar erros no navegador
Para os erros de faturamento e de referenciador de HTTP, a API Maps Embed grava mensagens de erro em window.console. Para solicitações inválidas (incluindo
chaves de API e erros de QPS), apenas o código de status HTTP 4xx é informado
no console. Nesta seção, explicamos como verificar a saída do console no Google Chrome. Se você estiver usando outros navegadores, consulte a documentação
do desenvolvedor para seu navegador. Para referência, 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 superior da janela "Ferramentas para desenvolvedores". Você também pode usar a tecla ESC para alternar entre o Console JavaScript.