Guias e Tutoriais2026-03-15·9 min de leitura

Guia: Configuração da Chave da API do Google Maps (2025)

Por Ibrahim DemolCEO IBLeadAtualizado em 12 de junho de 2026

Obter uma chave da API do Google Maps é o primeiro passo para qualquer desenvolvedor ou profissional de marketing que deseja incorporar mapas, extrair dados de localização ou construir recursos baseados em localização. Este guia sobre a configuração da chave da API do Google Maps cobre cada etapa — desde a criação da sua conta do Google Cloud até a segurança da sua chave e como evitar cobranças inesperadas.

Sem enrolação. Apenas os passos exatos que você precisa.

Por que você precisa de uma chave da API do Google Maps

A chave da API é o seu token de autenticação. Sem ela, o Google não fornecerá tiles de mapa, resultados de geocodificação ou dados de direções para o seu aplicativo.

Veja o que a chave realmente faz:

Concede acesso aos serviços da Plataforma Google Maps (API JavaScript Maps, API de Geocodificação, API de Lugares, etc.)
Monitora seu uso para que o Google possa aplicar o nível de cobrança correto
Vincula à sua conta de cobrança — as cobranças só se aplicam após você exceder o crédito mensal gratuito ($200/mês a partir de 2025)
Permite restringir o acesso para que apenas seu domínio ou aplicativo possa usar a chave

Todo projeto que envolve o Google Maps precisa de uma. Não há como contornar isso.

Passo 1: Crie uma Conta do Google Cloud Platform

Acesse console.cloud.google.com. Faça login com sua conta do Google — ou crie uma se você não tiver.

Se esta for sua primeira vez, o Google irá guiá-lo por um breve onboarding. Você precisará aceitar os Termos de Serviço e configurar uma conta de cobrança (mais sobre isso no Passo 4).

Novas contas recebem um crédito gratuito de $300 válido por 90 dias. Isso é separado do crédito mensal de $200 para Maps.

Passo 2: Crie um Novo Projeto

Cada chave da API vive dentro de um projeto. Os projetos mantêm suas chaves, cobrança e dados de uso organizados.

Clique no menu suspenso de projetos no topo do Console GCP (geralmente mostra "Meu Primeiro Projeto" ou algo semelhante)
Clique em Novo Projeto
Dê um nome claro — algo como "Integração de Mapas" ou o nome da sua empresa
Clique em Criar

O console mudará automaticamente para o seu novo projeto. Todas as próximas etapas acontecem dentro deste projeto.

Passo 3: Ative as APIs do Google Maps que Você Precisa

Nem todas as APIs do Maps estão ativadas por padrão. Você precisa ativar cada uma que planeja usar.

No menu lateral esquerdo, vá para APIs e Serviços → Biblioteca
Pesquise por "Maps"
Clique na API que você precisa — para a maioria dos projetos web, comece com a API JavaScript Maps
Clique em Ativar

Repita para quaisquer outras APIs que seu projeto precisar. As comuns incluem:

API	Caso de uso
API JavaScript Maps	Mapas interativos em websites
API de Geocodificação	Converter endereços em coordenadas
API de Lugares	Pesquisar empresas e POIs
API de Direções	Planejamento de rotas
API de Matriz de Distância	Tempo de viagem entre vários pontos

Se você não tiver certeza de quais precisa, ative a API JavaScript Maps primeiro. Você pode adicionar mais depois sem criar uma nova chave.

Passo 4: Configure a Cobrança

Esta etapa confunde muitos desenvolvedores. O Google exige uma conta de cobrança mesmo que você permaneça dentro do nível gratuito.

No Console GCP, vá para Cobrança no menu lateral esquerdo
Clique em Vincular uma conta de cobrança
Crie uma nova conta de cobrança se você não tiver uma
Insira os detalhes do seu cartão de crédito

Você não será cobrado a menos que seu uso exceda o crédito gratuito de $200/mês. Para a maioria dos pequenos projetos, isso cobre aproximadamente:

28.000 carregamentos de mapa por mês
40.000 solicitações de geocodificação por mês

Configure um alerta de orçamento (Cobrança → Orçamentos e Alertas) para receber um e-mail se você estiver se aproximando de um limite. Isso evita contas surpresa.

Passo 5: Crie Sua Chave da API

Agora a criação real da chave:

Vá para APIs e Serviços → Credenciais
Clique em + Criar Credenciais no topo
Selecione Chave da API
O Google gera sua chave imediatamente — ela se parece com AIzaSyD...
Copie-a e armazene em um lugar seguro (um gerenciador de senhas funciona bem)

É isso. A chave está ativa imediatamente.

Passo 6: Proteja Sua Chave da API

Uma chave da API não segura é uma responsabilidade. Se alguém a encontrar no seu repositório público do GitHub ou no código do lado do cliente, pode acumular cobranças na sua conta.

Duas restrições para definir imediatamente:

Restrições de Aplicativo

Limita quais aplicativos ou websites podem usar a chave.

Referenciadores HTTP — para websites. Adicione seu domínio: https://seudominio.com/*
Endereços IP — para aplicativos do lado do servidor. Adicione o IP do seu servidor.
Aplicativos Android/iOS — para aplicativos móveis. Adicione o nome do pacote do seu aplicativo ou ID do bundle.

Restrições de API

Limita quais APIs do Google a chave pode chamar.

Nas configurações da chave, clique em Restringir chave
Selecione apenas as APIs que você ativou no Passo 3
Clique em Salvar

Dessa forma, mesmo que a chave vaze, ela só poderá chamar APIs do Maps — não Gmail, Drive ou qualquer outra coisa.

Melhores Práticas para Gerenciar Sua Chave da API

Alguns hábitos que evitam dores de cabeça depois:

Nunca codifique a chave diretamente no JavaScript do lado do cliente. Qualquer um pode visualizar o código-fonte da sua página e extraí-la. Use variáveis de ambiente no lado do servidor e faça proxy das solicitações.

Use chaves separadas para ambientes separados. Uma chave para desenvolvimento, outra para produção. Assim, você pode rotacionar ou revogar uma sem quebrar a outra.

Monitore o uso semanalmente. Verifique APIs e Serviços → Painel para ver a contagem de solicitações por API. Picos podem indicar abuso ou um bug no seu código.

Rotacione as chaves periodicamente. Crie uma nova chave, atualize seu aplicativo e depois exclua a antiga. A rotação trimestral é uma cadência razoável para a maioria dos projetos.

Defina limites de cota. Nas configurações da chave, você pode limitar as solicitações diárias por API. Isso atua como um teto rígido sobre os custos.

Incorporando o Google Maps em Seu Site

Com sua chave pronta, aqui está o HTML mínimo para exibir um mapa:

<!DOCTYPE html>
<html>
<head>
  <title>Meu Mapa</title>
  <script src="https://maps.googleapis.com/maps/api/js?key=SUA_CHAVE_API&callback=initMap" async defer></script>
  <script>
    function initMap() {
      var map = new google.maps.Map(document.getElementById('map'), {
        center: { lat: 40.7128, lng: -74.0060 },
        zoom: 12
      });
    }
  </script>
</head>
<body>
  <div id="map" style="height: 400px; width: 100%;"></div>
</body>
</html>

Substitua SUA_CHAVE_API pela sua chave real. Os atributos async defer carregam o script sem bloquear a renderização da página.

Para sites WordPress, plugins como WP Google Maps ou o widget de mapa do Elementor lidam com a incorporação — você só precisa colar a chave nas configurações do plugin.

Resolvendo Problemas Comuns de Chave da API

"Esta página não pode carregar o Google Maps corretamente"

Geralmente significa que a chave está faltando, errada ou que a API JavaScript Maps não está ativada. Verifique ambas.

O mapa carrega, mas mostra uma caixa cinza

A API foi carregada, mas initMap() não foi executada. Verifique o console do seu navegador para erros de JavaScript.

Erro "REQUEST_DENIED"

Sua chave tem restrições que bloqueiam a solicitação. Ou o referenciador não corresponde, ou a API não está na lista permitida. Remova temporariamente as restrições para testar e, em seguida, re-adicione-as.

Erro de cobrança / API desativada

Se sua conta de cobrança tiver um problema (cartão expirado, pagamento falhado), o Google desativa as APIs. Resolva o problema de cobrança no Console GCP em Cobrança → Gerenciamento de Conta.

Cota excedida

Você atingiu seu limite diário ou mensal. Verifique APIs e Serviços → Cotas. Você pode solicitar um aumento de cota ou atualizar seu plano de cobrança.

Preços da API do Google Maps (2025)

O Google oferece $200/mês em créditos gratuitos. Depois disso, você paga por solicitação:

API	Preço após o nível gratuito
API JavaScript Maps	$7 por 1.000 carregamentos
API de Geocodificação	$5 por 1.000 solicitações
API de Lugares (básica)	$17 por 1.000 solicitações
API de Direções	$5 por 1.000 solicitações

Para casos de uso de alto volume — como scraping de milhares de listagens de empresas — os custos da API de Lugares se acumulam rapidamente. A $17 por 1.000 solicitações, extrair 50.000 registros de empresas custa $850 apenas em taxas da API, antes de qualquer tempo de desenvolvimento.

É aí que bancos de dados pré-indexados se tornam uma alternativa prática.

Usando Dados do Google Maps para Geração de Leads — Sem Limites de API

A API do Google Maps é construída para incorporar mapas e geocodificar endereços. Não é projetada para extração em massa de dados de negócios. A API de Lugares limita os resultados a 60 por pesquisa, e o scraping em larga escala viola os Termos de Serviço do Google.

Se seu objetivo é construir listas de leads a partir do Google Maps — e não incorporar mapas em um site — um banco de dados pré-indexado é um caminho mais rápido e barato.

IBLead indexa mais de 50 milhões de empresas em 37 países, atualizado semanalmente. Você pesquisa por cidade, código postal, categoria, classificação do Google ou contagem de avaliações. Em seguida, você exporta para CSV instantaneamente — sem chamadas de API, sem espera, sem cobrança por solicitação.

Os dados incluem nome da empresa, endereço, telefone, e-mail (enriquecido a partir do site), classificação do Google, contagem de avaliações e mais de 50 campos por listagem. A IBLead também detecta mais de 160 tecnologias no site de cada empresa — útil para segmentar empresas que utilizam plataformas de CMS específicas ou ferramentas de anúncios.

Por $52 por 10.000 leads, é uma fração do que a API de Lugares custaria para o mesmo volume.

Comece grátis — 200 créditos incluídos

FAQ: Chave da API do Google Maps

A API do Google Maps é gratuita?

Sim, até $200/mês de uso. Depois disso, você paga por solicitação. A maioria dos pequenos sites permanece dentro do nível gratuito. A extração de dados em alto volume é onde os custos aumentam rapidamente.

Posso usar uma chave da API para vários sites?

Tecnologicamente sim, mas é uma má prática. Use chaves separadas por projeto para que você possa rastrear o uso e revogar o acesso de forma independente.

O que acontece se eu não proteger minha chave da API?

Qualquer pessoa que a encontrar pode usá-la. Sua conta de cobrança será cobrada pelo uso deles. O Google tem detecção automatizada para alguns padrões de abuso, mas não é infalível. Sempre restrinja sua chave.

Quanto tempo leva para obter uma chave da API do Google Maps?

Cerca de 10 minutos se você já tiver uma conta do Google. O principal tempo gasto é na configuração da cobrança — tenha seu cartão de crédito pronto.

Existe uma alternativa à API do Google Maps para dados de negócios em massa?

Sim. Se você precisa de listagens de empresas em escala em vez de incorporações de mapas, bancos de dados pré-indexados como o IBLead são mais práticos. Eles não têm preços por solicitação nem o limite de 60 resultados da API de Lugares por pesquisa.

Resumo

Configurar sua chave da API do Google Maps leva seis etapas: criar uma conta GCP, iniciar um projeto, ativar as APIs que você precisa, adicionar cobrança, gerar a chave e restringi-la. Todo o processo leva menos de 15 minutos.

A chave desbloqueia incorporações de mapas, geocodificação e roteamento para seus aplicativos. Para a maioria dos sites, você permanecerá dentro do nível gratuito de $200/mês sem cobranças.

Se você estiver usando o Google Maps para geração de leads em vez de incorporações de mapas, a precificação por solicitação da API e os limites de resultados tornam a extração em massa cara e lenta. Um banco de dados pré-indexado fornece os mesmos dados — mais rápido, mais barato e sem risco de violação dos ToS.