Guia: Configuração da Chave da API do Google Maps (2025)
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 45 milhões de empresas em 45 países, atualizado país a país. 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 44 € 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.
Pronto para começar?
Pesquise empresas do Google Maps por categoria e cidade, com emails e, em França, dados legais.
Experimente o IBLead gratuitamenteObtenha esta lista a partir do seu assistente de IA ou da API
Os mesmos dados estão disponíveis no Claude, no ChatGPT ou em qualquer cliente MCP, e através da API REST.
Exemplo de pedido
“Encontra 200 restaurantes com número de telefone (zona: Portugal) e exporta-os em CSV”
URL do servidor MCP
https://mcp.iblead.com/mcpAPI REST: contar e depois exportar
curl -H "Authorization: Bearer sk_live_..." \
"https://app.iblead.com/api/v1/businesses?country=PT&category=restaurant&has_phone=true&limit=1"
curl -X POST -H "Authorization: Bearer sk_live_..." -H "Content-Type: application/json" \
-d '{"country":"PT","category":"restaurant","has_phone":true,"limit":200}' "https://app.iblead.com/api/v1/export" -o export.csvSubstitua sk_live_... pela sua chave API, disponível no painel.
Artigos relacionados
Diretório de empresas da Arábia Saudita: mais de 240.000 empresas por cidade e setor
Cerca de 240.000 empresas sauditas do Google Maps, por cidade e setor: Riad, Dammam, Tabuk. Telefone, site e nota. 200 créditos grátis, sem cartão.
Como extrair dados do Google Maps: o guia completo (2026)
Descubra todos os metodos para extrair dados do Google Maps: scraping manual, ferramentas automatizadas e bases de dados pre-indexadas. Comparativo completo.
Como encontrar o SIRET de uma empresa atraves do Google Maps
Associar automaticamente as fichas do Google Maps aos dados legais Sirene (SIRET, SIREN, dirigente, codigo APE). O matching SIRET explicado.