Mensagens de erro

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Nesta página, descrevemos as mensagens de erro que podem ser retornadas pela API Maps JavaScript. A API Maps JavaScript grava mensagens de erro e aviso no Console JavaScript. Algumas condições de erro também podem ocorrer, o que resulta na exibição de um mapa marcado com marca-d'água escuro.

Chave de API e erros de faturamento

Solução de problemas

Em algumas circunstâncias, um mapa escuro ou uma imagem negativa do Street View com marca-d'água pode ser exibido com o texto "apenas para fins de desenvolvimento". Normalmente, esse comportamento indica problemas com uma chave de API ou com o faturamento. Para usar os produtos da Plataforma Google Maps, o faturamento precisa estar ativado na sua conta, e todas as solicitações precisam incluir uma chave de API válida. Se você precisar de ajuda para encontrar mensagens de erro, consulte a seção sobre como verificar erros no navegador.

O fluxo a seguir ajudará você a resolver o problema.

Códigos de erro da API Maps JavaScript para desenvolvedores e proprietários de sites

As tabelas a seguir listam os possíveis códigos de erro retornados pela API Maps JavaScript, com uma descrição da causa e como você pode corrigir o problema. Se precisar de ajuda para encontrar as mensagens de erro, consulte a seção sobre Como verificar erros no navegador.

Erros de carregamento de mapa

Se você encontrar um erro ao carregar a API Maps JavaScript, consulte a tabela abaixo para encontrar explicações dos códigos de erro.

Código de erro Mensagem Descrição
NotLoadingAPIFromGoogleMapsError É necessário fazer o download da API Maps JavaScript diretamente nos servidores do Google.

O elemento de script que carrega a API Maps JavaScript não está sendo incluído corretamente na sua página. Para que a API funcione corretamente, ela precisa ser carregada diretamente de https://maps.googleapis.com.

Consulte Como carregar a API Maps JavaScript.

TOSViolationMapError Esse website parece violar os Termos de Serviço da Google Maps API. A Google Maps API foi desativada nesse website.

Sua inscrição foi bloqueada por não estar em conformidade com os Termos de Serviço da Plataforma Google Maps depois de várias notificações por e-mail. Para contestar o bloqueio e pedir que sua implementação seja analisada, preencha este formulário. Você receberá uma resposta por e-mail dentro de alguns dias úteis.

Se você tem uma licença do Plano Premium da Plataforma Google Maps, use suas credenciais do plano Premium para resolver esse erro. Consulte o guia sobre autenticação do plano Premium.

UnauthorizedURLForClientIdMapError Esse URL não está autorizado a usar o ID de cliente do Google Maps informado.

O ID do cliente do plano Premium ou das APIs Maps for Work incluído no carregamento do script é inválido, expirou ou o endereço atual que carrega a API Maps JavaScript não foi adicionado à lista de URLs autorizados.

Consulte Como registrar URLs autorizados.

Códigos de erro da API Maps JavaScript

Se você encontrar um erro no Chrome JavaScript Console, no Firefox Web Console ou em qualquer outra ferramenta equivalente nos navegadores, consulte a tabela abaixo para encontrar explicações dos códigos de erro.

A API Maps JavaScript retorna erros e avisos. Um erro indica um problema grave que ocorreu ao carregar a API Maps JavaScript. Sua página não pode carregar a API corretamente e ela não funcionará nela. Um aviso é uma mensagem complementar sobre o carregamento da API Maps JavaScript. O aviso descreve os possíveis motivos para um erro ou sugere possíveis problemas no seu código que carregam a API Maps JavaScript. Se você receber apenas avisos sem erros, a API funcionará corretamente nessa página. No entanto, recomendamos que você também corrija esses possíveis problemas.

Código de erro do desenvolvedor Tipo Descrição
ApiNotActivatedMapError Erro

A API Maps JavaScript não está ativada no seu projeto de API. Talvez você precise ativar a API Maps JavaScript em APIs no Console do Google Cloud.

Para ativar a API Maps JavaScript no seu projeto, clique no botão abaixo.
Saiba como

ApiTargetBlockedMapError Erro

Essa chave de API não está autorizada a usar este serviço ou API. Verifique as configurações de Restrições da API da sua chave de API no Console do Google Cloud para garantir que todas as APIs e serviços que você precisa usar estejam especificados corretamente na lista de APIs ativadas.

Consulte Chaves de API no Console do Cloud. Para mais informações, consulte Práticas recomendadas de segurança da API.

DeletedApiProjectMapError Erro

Seu projeto de API pode ter sido excluído do Console do Cloud. Verifique o projeto para o qual você gerou a chave de API que foi incluída no carregador da API JavaScript. É possível criar um novo projeto de API e receber uma nova chave no Console do Cloud.

Para criar um novo projeto e receber uma chave de API nele, clique no botão abaixo.
Saiba como

ClientBillingNotEnabledMapError Erro

Você não ativou o faturamento no seu projeto. Ative o faturamento no projeto do Google Cloud associado a esse ID do cliente aqui.

BillingNotEnabledMapError Erro

Você não ativou o faturamento no seu projeto, o que está causando esse erro. Ative o faturamento no projeto do Google Cloud aqui.

Saiba mais

ExpiredKeyMapError Erro

A chave de API incluída no elemento de script que carrega a API expirou ou não foi reconhecida pelo sistema. Você poderá receber esse erro depois de criar uma nova chave de API se tentar usá-la antes que ela seja reconhecida pelo sistema. Aguarde alguns minutos e tente novamente. Talvez seja necessário gerar uma nova chave de API no Console do Cloud.

Para receber uma chave de API, clique no botão abaixo.
Como começar

InvalidClientIdMapError Erro

O ID do cliente incluído no elemento de script que carrega a API é inválido ou expirou. Verifique se você está usando o ID do cliente corretamente. O ID do cliente deve começar com o prefixo "quot;gme-". Esse erro pode ocorrer mesmo se o ID do cliente estiver correto. Entre em contato com o gerente de contas da Google.

Se você não tem uma licença do plano Premium ou das APIs Maps for Work, é necessário usar um parâmetro key com sua chave de API em vez do parâmetro client .

Consulte o guia sobre autenticação do plano Premium.

InvalidKeyMapError Erro

A chave de API incluída no elemento de script que carrega a API não foi encontrada. Verifique se está usando uma chave de API correta. É possível gerar uma nova chave de API no Console do Cloud.

Para receber uma chave de API, clique no botão abaixo.
Como começar

MalformedCredentialsMapError Erro

Seu aplicativo usa um esquema de URI não compatível. Confirme se o aplicativo usa um formato de URI válido conforme definido na RFC 3986.

MissingKeyMapError Erro

O elemento do script que carrega a API não tem o parâmetro de autenticação necessário.

Se você estiver usando a API Maps JavaScript padrão, use um parâmetro key com uma chave de API válida. Para mais detalhes, consulte o artigo Como começar a usar a Plataforma Google Maps.

Se você for cliente do plano Premium, será necessário usar um parâmetro client com seu ID do cliente ou um parâmetro key com uma chave de API válida. Para mais informações, consulte o guia sobre chaves de API e IDs do cliente.

Se NÃO for o proprietário do site, não há etapas que você possa seguir para corrigir esse erro. No entanto, se possível, notifique o proprietário do site.

ProjectDeniedMapError Erro

A solicitação não foi concluída. Acesse o Console do Cloud para ver mais detalhes sobre o erro.

Consulte o Console do Cloud.

RefererDeniedMapError Erro

Sua inscrição foi bloqueada por não estar em conformidade com os Termos de Serviço da Plataforma Google Maps depois de várias notificações por e-mail. Para contestar o bloqueio e pedir que sua implementação seja analisada, preencha este formulário. Você receberá uma resposta por e-mail dentro de alguns dias úteis.

RefererNotAllowedMapError Erro

O URL atual que carrega a API Maps JavaScript não foi adicionado à lista de referenciadores permitidos. Verifique as configurações do referenciador da sua chave de API no Console do Cloud.

Consulte a API Maps JavaScript e Acessar uma chave de API.

OverQuotaMapError Erro

O número de solicitações excedeu os limites de uso da API Maps JavaScript. As solicitações do seu aplicativo funcionarão novamente na próxima redefinição de cota diária.

Se NÃO for o proprietário do site, não há como corrigir esse erro. No entanto, se possível, notifique o proprietário do site.

Para mais detalhes, consulte o guia sobre limites de uso. A página também explica como conseguir limites de uso maiores.

ApiProjectMapError Erro

Não foi possível resolver a chave de API fornecida ou o projeto da API a que ela está associada. Esse erro pode ser temporário. Se a mensagem de erro persistir, talvez seja necessário gerar uma nova chave de API ou criar um novo projeto de API.

Para mais detalhes, consulte o artigo Como começar a usar a Plataforma Google Maps.

ClientIdLooksLikeCryptoKey Alerta

Talvez você tenha fornecido uma chave criptográfica no parâmetro client. Se você tem uma licença do plano Premium ou das APIs Maps for Work, especifique seu ID de cliente como o parâmetro client. Não é necessário usar a chave criptográfica da API Maps JavaScript.

Consulte o guia sobre IDs do cliente para clientes do plano Premium e da API Maps for Work.

ClientIdLooksLikeKey Alerta

Talvez você tenha fornecido uma chave de API no parâmetro client. Se você tem uma licença do plano Premium ou das APIs Maps for Work, especifique seu ID de cliente como o parâmetro client. Se você tiver um plano Premium da Plataforma Google Maps, poderá usar um parâmetro client ou key. Se você não tiver nenhuma licença, use um parâmetro key em vez de client .

Consulte o guia sobre autenticação do plano Premium.

InvalidChannel Alerta

Talvez você tenha fornecido um parâmetro channel inválido. O canal precisa ser uma string alfanumérica ASCII, que pode incluir ponto (.), sublinhado (_) e hífen (-). Verifique se você está especificando um parâmetro channel válido.

Consulte Relatórios | Plano Premium da Plataforma Google Maps.

InvalidClientId Alerta

O parâmetro client não contém um ID do cliente correto. Um ID do cliente deve iniciar com "quot;gme-".

Consulte o guia sobre autenticação do plano Premium.

InvalidKey Alerta

A chave de API incluída no elemento de script que carrega a API não parece correta. Verifique se está usando uma chave de API correta. É possível gerar uma nova chave de API no Console do Cloud.

Para receber uma chave de API, clique no botão abaixo.
Como começar

InvalidVersion Alerta

Você pode ter informado um número de versão incorreto no elemento de script. Verifique se está usando um número de versão correto.

Consulte Controle de versão | API Google Maps JavaScript.

KeyLooksLikeClientId Alerta Talvez você tenha fornecido um ID do cliente como um parâmetro key. Se você tem uma licença do plano Premium ou das APIs Maps for Work, especifique seu ID de cliente como um parâmetro client em vez do parâmetro key. Se você tiver um plano Premium da Plataforma Google Maps, poderá usar um parâmetro client ou key. Se você não tiver nenhuma licença, use um parâmetro key em vez de client .

Consulte o guia sobre autenticação do plano Premium.

KeyLooksLikeCryptoKey Alerta

Talvez você tenha fornecido uma chave criptográfica ou um secret de assinatura como um parâmetro key. Se você tem uma licença do plano Premium ou das APIs Maps for Work, especifique seu ID de cliente como um parâmetro client e remova o parâmetro key do seu elemento de script. A chave criptográfica não é necessária para a API Maps JavaScript. Se você tiver um plano Premium da Plataforma Google Maps, poderá usar um parâmetro client ou key. Se você não tiver nenhuma licença, poderá receber uma chave de API no Console do Cloud.

Consulte o guia para especificar um ID do cliente ao carregar a API.

KeyLooksLikeProjectNumber Alerta

Talvez você tenha fornecido um número de projeto como parâmetro key. Verifique se está usando uma chave de API correta. É possível gerar uma nova chave de API no Console do Cloud.

Saiba como acessar uma chave de API.

NoApiKeys Alerta

O elemento do script que carrega a API não tem uma chave de API. Inclua uma chave de API válida como um parâmetro key. É possível gerar uma nova chave de API no Console do Cloud.

Para receber uma chave de API, clique no botão abaixo para começar.
Como começar

Se você estiver carregando a API Maps JavaScript a partir do caminho descontinuado da v2, receberá o aviso NoApiKeys, mesmo se tiver especificado o parâmetro key. Consulte o guia de upgrade da v2 para a v3 e migre seu aplicativo para a API Maps JavaScript v3.

RetiredVersion Alerta

Você pode ter informado uma versão removida no elemento de script. Atualize o aplicativo para usar uma das versões disponíveis.

Consulte Controle de versão | API Google Maps JavaScript.

SensorNotRequired Alerta

O parâmetro sensor não é mais necessário para a API Maps JavaScript. Ela não impede que a API Maps JavaScript funcione corretamente, mas recomendamos que você remova o parâmetro sensor do elemento de script.

SignatureNotRequired Alerta

O parâmetro signature não é obrigatório para a API Maps JavaScript. Ela não impede que a API Maps JavaScript funcione corretamente, mas pode introduzir riscos de segurança. Remova-o do elemento de script.

SignedInNotSupported Alerta

O parâmetro signed_in foi descontinuado e não é compatível com a versão da API Maps JavaScript que você está usando. Isso não impede que a API Maps JavaScript funcione, mas o comportamento do seu aplicativo pode mudar se você usa recursos conectados.

UrlAuthenticationCommonError Erro

Ocorreu um erro que não se encaixa nas outras categorias desta página. Ele pode ter sido causado por um problema temporário. Repita a solicitação após um pequeno atraso. Se isso não resolver o problema, consulte o guia do desenvolvedor para garantir que a solicitação tenha o formato adequado.

Verificar erros no navegador

A API Maps JavaScript grava mensagens de erro em window.console. Esta seção explica como verificar a saída window.console no Google Chrome. Se você estiver usando qualquer outro navegador, consulte a documentação do desenvolvedor para seu navegador. Para sua referência, esta é uma lista de ferramentas para verificar a saída de window.console em alguns outros navegadores.

No Chrome, você pode usar o Console JavaScript para verificar a saída window.console da seguinte maneira.

  1. Para abrir as Ferramentas para desenvolvedores, selecione o ícone de menu > Mais ferramentas > Ferramentas para desenvolvedores.
  2. Para abrir o Console JavaScript, pressione ESC no teclado. A tecla ESC abre e fecha o Console JavaScript. Se você fechar o console, pressione a tecla ESC novamente para abri-la.

Se algum erro ou aviso ocorrer durante o carregamento da API Maps JavaScript, eles aparecerão como uma ou mais linhas no console. Uma mensagem de erro ou advertência tem o seguinte formato:

Google Maps API error: [ERROR CODE] [Link to API document]
ou
Google Maps API warning: [ERROR CODE] [Link to API document]

Verifique a tabela de códigos de erro acima para encontrar o código na mensagem de erro. Também é possível encontrar detalhes sobre a mensagem de erro no documento da API vinculado à mensagem.

Observação:é possível detectar erros de autenticação de maneira programática.

Lidar com navegadores incompatíveis

Verifique se a versão do navegador que você está usando é compatível com a API Maps JavaScript.

Se o código ainda não estiver funcionando

Para entender o código dos seus mapas, Brendan Kenny e Mano Marks mostram alguns erros comuns e como corrigi-los no vídeo.

  • Procure erros de digitação. Lembre-se de que JavaScript é uma linguagem que diferencia maiúsculas de minúsculas.
  • Verifique o básico: alguns dos problemas mais comuns ocorrem com a criação inicial do mapa. Por exemplo:
    • Confirme se você especificou as propriedades zoom e center nas opções do mapa.
    • Verifique se você declarou um elemento div no qual o mapa aparecerá na tela.
    • Verifique se o elemento div para o mapa tem uma altura. Por padrão, os elementos div são criados com uma altura de 0 e, portanto, são invisíveis.
    Veja nossos exemplos para uma implementação de referência.
  • Use um depurador JavaScript para ajudar a identificar problemas, como o disponível nas Ferramentas para desenvolvedores do Chrome. Comece verificando a existência de erros no console JavaScript.
  • Publique perguntas no Stack Overflow (em inglês). As diretrizes sobre como postar ótimas perguntas estão disponíveis na página de Suporte.