Pronto!

Para começar a desenvolver, acesse nossa documentação do desenvolvedor.

Ativar a Google Maps JavaScript API

Para começar, orientaremos você pelo Console do Desenvolvedor do Google para realizar algumas atividades:

  1. Criar ou selecionar um projeto
  2. Ativar a Google Maps JavaScript API e serviços relacionados
  3. Criar chaves apropriadas
Continuar

Mensagens de erro


A Google Maps JavaScript API grava mensagens de erro e advertência em window.console. As tabelas a seguir listam os códigos de erro que podem ser retornados pela Google Maps JavaScript API, com uma descrição da causa e instruções para resolver o problema. Se precisar de ajuda para encontrar as mensagens de erro, leia a seção sobre verificar erros do seu navegador.

Códigos de erro da Google Maps JavaScript API

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

Código de erro Mensagem Descrição
InvalidKeyOrUnauthorizedURLMapError A chave de API do Google é inválida ou este site não está autorizado a usá-la.

A chave de API incluída no elemento de script que carrega a API é inválida ou o URL atual que carrega a Google Maps JavaScript API não foi adicionado à lista de referenciadores permitidos. É necessário ativar a Google Maps JavaScript API em APIs no Google API Console.

Consulte Obtenção de uma chave de API.

NotLoadingAPIFromGoogleMapError A Google Maps JavaScript API deve ser baixada diretamente dos servidores do Google.

O elemento de script que carrega a Google Maps JavaScript API não está incluído corretamente na página. Para que a API funcione corretamente, é necessário carregá-la diretamente de https://maps.googleapis.com.

Consulte Carregamento da Maps API.

TOSViolationMapError Este site aparentemente viola os termos de serviços da Google Maps API. The Google Maps API has been disabled for this website.

Após diversas notificações por e-mail, seu aplicativo foi bloqueado por estar em desacordo com os Termos de serviço das Google Maps APIs. Para solicitar o desbloqueio e ter sua implementação avaliada, preencha este formulário. Você receberá uma resposta por e-mail dentro de alguns dias úteis.

Se você tem uma licença do Google Maps APIs Premium Plan, use suas credenciais do Google Maps APIs Premium Plan para resolver esse erro. Consulte o guia de chaves de API e IDs de cliente.

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

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

Consulte Registro de URLs autorizados.

Códigos de erro da Google Maps JavaScript API para desenvolvedores

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.

Há dois tipos de códigos de erro: erros e avisos. Um erro indica um problema grave que ocorreu ao carregar a Google Maps JavaScript API. A página não consegue carregar a API corretamente e a API não funciona nessa página. Um aviso é uma mensagem complementar sobre o carregamento da Google Maps JavaScript API. O aviso descreve os possíveis motivos para um erro ou sugere possíveis problemas com o código que carrega a Google Maps JavaScript API. Se você receber apenas avisos e nenhum erro, a API funcionará corretamente nessa página. No entanto, recomendamos que você corrija também os possíveis problemas.

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

A Google Maps JavaScript API não está ativada no projeto da API. É necessário ativar a Google Maps JavaScript API em APIs no Google API Console.

Consulte Obtenção de uma chave de API.

DeletedApiProjectMapError Erro

O projeto da API pode ter sido excluído no Google API Console. Verifique o projeto para o qual você gerou a chave de API incluída no carregador da JavaScript API. Crie um novo projeto de API e obtenha uma nova chave no Google API Console.

Consulte Obtenção de uma chave de API.

ExpiredKeyMapError Erro

A chave de API incluída no elemento de script que carrega a API está vencida. Gere uma nova chave de API no Google API Console.

Consulte Obtenção de uma chave de API.

InvalidClientIdMapError Erro

O ID de cliente incluído no elemento de script que carrega a API é inválido ou está vencido. Verifique se o ID de cliente está sendo usado corretamente. O ID de cliente deve iniciar com o prefixo "gme-". Se o uso do ID de cliente está correto e o erro continua ocorrendo, o ID de cliente pode estar vencido. Entre em contato com o gerente de contas da Google.

Se você não tem uma licença do Premium Plan ou do Maps APIs for Work, deve usar um parâmetro key com a sua chave de API no lugar do parâmetro client.

Consulte Seu ID de cliente.

InvalidKeyMapError Erro

A chave de API incluída no elemento de script que carrega a API não foi encontrada. Verifique se está usando a chave de API correta. Gere uma nova chave de API no Google API Console.

Consulte Obtenção de uma chave de API.

MissingKeyMapError Erro

O elemento do script que carrega a API não tem o parâmetro de autenticação necessário. Se estiver usando a Maps JavaScript API padrão, é preciso usar um parâmetro key com uma chave de API válida. Se for cliente do Premium Plan, é preciso usar um parâmetro client com o seu ID de cliente ou um parâmetro key com uma chave de API válida.

Consulte o guia de chaves de API e IDs de cliente.

ProjectDeniedMapError Erro

A solicitação não foi concluída. Você encontrará mais detalhes sobre o erro no Google API Console.

Consulte Google API Console.

RefererDeniedMapError Erro

Após diversas notificações por e-mail, seu aplicativo foi bloqueado por estar em desacordo com os Termos de serviço das Google Maps APIs. Para solicitar o desbloqueio e ter sua implementação avaliada, preencha este formulário. Você receberá uma resposta por e-mail dentro de alguns dias úteis.

RefererNotAllowedMapError Erro

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

Consulte chaves de API no Google API Console. Para saber mais, consulte as Práticas recomendadas para usar chaves de API com segurança.

OverQuotaMapError Erro

O número de solicitações excedeu o limite de uso da Google Maps JavaScript API. As solicitações do aplicativo voltarão a funcionar quando a próxima cota diária for iniciada.

Para saber mais, consulte o guia sobre limites de uso. O documento também explica como obter maiores limites de uso.

ClientIdLooksLikeCryptoKey Aviso

Você pode ter informado uma chave criptográfica no parâmetro client. Se você tem uma licença do Premium Plan ou do Maps APIs for Work, especifique seu ID de cliente como o parâmetro client. Não é necessário usar a chave criptográfica para a Google Maps JavaScript API.

Consulte o guia sobre IDs de cliente para clientes do Premium Plan e do Maps APIs for Work.

ClientIdLooksLikeKey Aviso

Você pode ter informado uma chave de API no parâmetro client. Se você tem uma licença do Premium Plan ou do Maps APIs for Work, especifique seu ID de cliente como o parâmetro client. Se você tem um Google Maps APIs Premium Plan, use um parâmetro client ou um parâmetro key. Se você não tem nenhuma licença, deve usar o parâmetro key, e não o parâmetro client.

Consulte o guia sobre IDs de cliente e chaves de API.

InvalidChannel Aviso

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

Consulte Relatórios | Google Maps APIs Premium Plan.

InvalidClientId Aviso

O parâmetro client parece não ter um ID de cliente correto. O ID de cliente deve começar com “gme-”.

Leia o guia sobre IDs de cliente para clientes do Premium Plan ou do Maps APIs for Work.

InvalidKey Aviso

A chave de API incluída no elemento de script que carrega a API não está correta. Verifique se está usando a chave de API correta. Gere uma nova chave de API no Google API Console.

Consulte Obtenção de uma chave de API.

InvalidVersion Aviso

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ões | Google Maps JavaScript API.

KeyLooksLikeClientId Aviso Você pode ter informado um ID de cliente como um parâmetro key. Se você tem uma licença do Premium Plan ou do Maps APIs for Work, especifique seu ID de cliente como o parâmetro client em vez de como o parâmetro key. Se você tem um Google Maps APIs Premium Plan, use um parâmetro client ou um parâmetro key. Se você não tem nenhuma licença, deve usar o parâmetro key, e não o parâmetro client.

Consulte o guia sobre IDs de cliente e chaves de API.

KeyLooksLikeCryptoKey Aviso

Você pode ter informado uma chave criptográfica como um parâmetro key. Se você tiver uma licença do Premium Plan ou do Maps APIs for Work, especifique o ID de cliente como um parâmetro client e remova o parâmetro key do elemento do script. A chave criptográfica não é necessária para a Google Maps JavaScript API. Se você tem um Google Maps APIs Premium Plan, use um parâmetro client ou um parâmetro key. Se você não tem nenhuma licença, obtenha uma chave de API gratuita no Google API Console.

Consulte o guia sobre IDs de cliente e chaves de API.

KeyLooksLikeProjectNumber Aviso

Você pode ter informado um número de projeto como um parâmetro key. Verifique se está usando uma chave de API correta. Gere uma nova chave de API no Google API Console.

Consulte Obtenção de uma chave de API.

NoApiKeys Aviso

O elemento do script que carrega a API não tem uma chave de API. Não deixe de incluir uma chave de API válida como o parâmetro key. Gere uma nova chave de API no Google API Console.

Consulte Obtenção de uma chave de API.

RetiredVersion Aviso

Você pode ter informado uma versão removida no elemento de script. As versões 3.0 - 3.24 foram removidas e você pode estar recebendo 3.25 em seu lugar. Atualize o aplicativo para usar uma das versões disponíveis.

Consulte Controle de versões | Google Maps JavaScript API.

SensorNotRequired Aviso

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

SignatureNotRequired Aviso

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

SignedInDeprecated Aviso

O parâmetro signed_in tornou-se obsoleto e será ignorado nas próximas versões da Google Maps JavaScript API. Isso não impedirá a Google Maps JavaScript API de funcionar depois da remoção do modo conectado, mas o comportamento do seu aplicativo pode mudar se você usa os recursos atuais desse modo.

Verifique o seu aplicativo e leia Mapas conectados | Google Maps JavaScript API para conhecer detalhes sobre as próximas alterações.

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. Aguarde um pouco antes de tentar enviar a solicitação novamente. Se isso não resolver o problema, leia o guia do desenvolvedor para ter certeza de que a solicitação tem o formato correto.

Verificar erros no navegador

A Google Maps JavaScript API grava mensagens de erro em window.console. Esta seção explica como verificar a saída de window.console no Google Chrome. Se estiver usando outro navegador, verifique a documentação ao desenvolvedor sobre o navegador. Se precisar de ajuda, veja abaixo 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 de window.console da seguinte forma:

  1. Para abrir as “Ferramentas do desenvolvedor”, selecione o ícone de menu > Mais ferramentas > Ferramentas do desenvolvedor.
  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 ESC para abri-lo novamente.

Se houver erro ou advertência ao carregar a Google Maps JavaScript API, ela aparecerá como uma ou mais linhas no console. Uma mensagem de erro ou advertência tem o seguinte formato:

Erro da Google Maps API: [CÓDIGO DO ERRO] [Link para a documentação da API]
ou
Advertência da Google Maps API: [CÓDIGO DE ERRO] [Link para a documentação da API]

Você pode verificar a tabela de códigos de erro acima para encontrar o código de erro da mensagem de erro. Além disso, é possível encontrar os detalhes da mensagem de erro acessando o link para a documentação da API da mensagem.

Observação: Você pode detectar erros de autenticação programaticamente.

Enviar comentários sobre…

Google Maps JavaScript API
Google Maps JavaScript API
Precisa de ajuda? Acesse nossa página de suporte.