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

Guia para obter sua chave API Google Maps com facilidade

Q: O que fazer se minha chave API for comprometida?

Vá imediatamente em "APIs e serviços" > "Credenciais", clique na sua chave e selecione "Regenerar chave". A chave antiga é invalidada instantaneamente. Atualize sua chave em todos os seus aplicativos.

Por Ibrahim DemolCEO IBLeadAtualizado em 12 de junho de 2026

Obter sua chave API Google Maps com facilidade é possível — desde que você siga as etapas corretas na ordem certa. Este guia cobre tudo: a criação da conta Google Cloud Platform, a ativação da API, a geração da chave e a segurança do acesso. Seja você um desenvolvedor iniciante ou experiente, você terá sua chave operacional em menos de 20 minutos.

O que é uma chave API Google Maps?

Uma chave API é uma sequência de caracteres única gerada pelo Google. Ela identifica seu aplicativo junto aos servidores do Google e autoriza o acesso aos serviços Maps.

Concretamente, é uma "senha de aplicativo". Sem ela, o Google rejeita as solicitações. Com ela, você pode exibir mapas, calcular rotas, geolocalizar endereços e muito mais.

Ela também serve para o Google medir seu consumo e cobrar se você ultrapassar os limites gratuitos. Por isso, garantir sua segurança corretamente é tão importante quanto criá-la.

Por que usar a API Google Maps?

Google Maps é a referência mundial para tudo relacionado à cartografia e dados de localização. Sua API é utilizada por milhões de aplicativos.

Os casos de uso são muitos:

Exibir um mapa interativo em um site ou aplicativo móvel
Calcular rotas entre dois pontos (carro, bicicleta, a pé)
Geocodificar endereços (converter um endereço em coordenadas GPS)
Integrar o Street View em uma interface
Acessar dados de negócios locais via Places API

Cada uso corresponde a uma API diferente. Google Maps Platform reúne cerca de vinte serviços distintos, todos acessíveis através de uma chave API.

Etapa 1: Criar uma conta Google Cloud Platform

Tudo começa no Google Cloud Platform (GCP). É o console central que gerencia todos os serviços do Google destinados aos desenvolvedores.

Você precisa de uma conta Gmail ativa. Se você não tiver uma, crie uma primeiro em gmail.com.

Em seguida, acesse cloud.google.com e clique em "Começar gratuitamente". O Google oferece 300 € de créditos gratuitos durante 90 dias para novas contas. Um cartão de crédito é necessário para o registro, mas você não será cobrado até ultrapassar os limites gratuitos.

Preencha o formulário de inscrição: país, tipo de conta (pessoal ou empresarial), informações de pagamento. Uma vez validado, você acessa o painel do GCP.

Etapa 2: Criar um projeto GCP dedicado

No GCP, tudo é organizado por projetos. Um projeto agrupa as APIs ativadas, as chaves geradas, os limites e a cobrança associada.

É altamente recomendável criar um projeto dedicado para cada aplicativo ou uso. Isso facilita a gestão de custos e acessos.

Aqui está como fazer:

No topo da interface, clique no seletor de projeto (ícone em forma de pasta ao lado do logotipo do Google Cloud)
Na janela que se abre, clique em "Novo projeto"
Dê um nome explícito ao seu projeto — por exemplo, "Maps-MonSite" ou "Geocodificação-App"
Deixe a organização padrão se você não tiver uma
Clique em "Criar"

A criação leva alguns segundos. Uma notificação aparece no canto superior direito quando estiver pronta. Em seguida, selecione este projeto como o projeto ativo através do seletor.

Etapa 3: Ativar a API Google Maps desejada

Google Maps Platform reúne várias APIs distintas. Você deve ativar apenas aquelas de que precisa — cada API ativada consome limites separadamente.

Acessar a biblioteca de APIs

No menu lateral esquerdo, clique em "APIs e serviços" e depois em "Biblioteca". Um motor de busca aparece com todas as APIs disponíveis.

As principais APIs Google Maps

API	Uso principal
Maps JavaScript API	Mapas interativos na web
Maps SDK for Android	Mapas em apps Android
Maps SDK for iOS	Mapas em apps iOS
Geocoding API	Conversão de endereço ↔ coordenadas GPS
Places API	Pesquisa e dados de negócios locais
Directions API	Cálculo de rotas
Geolocation API	Localização por rede (sem GPS)
Street View Static API	Imagens do Street View em apps
Distance Matrix API	Distâncias e tempos de viagem em massa

Para um site clássico com um mapa, ative a Maps JavaScript API. Para acessar dados de comércios locais, ative a Places API.

Ativar uma API

Pesquise a API na biblioteca
Clique em seu nome para acessar sua página de detalhes
Clique no botão "Ativar"

A ativação é imediata. Repita a operação para cada API necessária.

Etapa 4: Gerar a chave API Google Maps

Esta é a etapa central. Uma vez que a API esteja ativada, você pode criar a chave que permitirá que seu aplicativo a utilize.

Acessar a seção Credenciais

No menu "APIs e serviços", clique em "Credenciais". Esta página lista todas as chaves API e outras credenciais do seu projeto.

Criar a chave

Clique em "+ Criar credenciais" no topo da página
Selecione "Chave API" no menu suspenso
O Google gera automaticamente uma chave — ela se parece com isto: AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY
Copie esta chave imediatamente e armazene-a em um local seguro (gerenciador de senhas, variável de ambiente, etc.)
Clique em "Fechar"

Importante: nunca compartilhe esta chave publicamente. Não a comite em um repositório Git público. Não a exiba em uma URL acessível.

Etapa 5: Integrar a chave em seu aplicativo

A forma de usar a chave depende da linguagem e do contexto do seu projeto.

Em JavaScript (site web)

Para carregar a API Maps JavaScript em uma página HTML, adicione este script em seu <head> ou antes do fechamento do <body>:

<script src="https://maps.googleapis.com/maps/api/js?key=MINHA_CHAVE_API&callback=initMap" async defer></script>

Substitua MINHA_CHAVE_API pela sua chave real. A função initMap é chamada uma vez que a API é carregada — é aqui que você inicializa seu mapa.

Em Python (requisições de servidor)

Para usar a API Geocoding ou Places a partir de um script Python:

import requests

api_key = "MINHA_CHAVE_API"
endereco = "10 Rue de la Paix, Paris"

url = f"https://maps.googleapis.com/maps/api/geocode/json?address={endereco}&key={api_key}"
response = requests.get(url)
data = response.json()

print(data['results'][0]['geometry']['location'])

Este código retorna as coordenadas GPS do endereço fornecido.

Boa prática: variáveis de ambiente

Nunca coloque sua chave diretamente no código. Use uma variável de ambiente:

import os
api_key = os.environ.get("GOOGLE_MAPS_API_KEY")

Ou um arquivo .env com a biblioteca python-dotenv. Isso evita vazamentos acidentais durante um push no GitHub.

Etapa 6: Restringir e proteger sua chave API

Uma chave não restrita pode ser usada por qualquer pessoa se for descoberta. O Google pode então cobrar por chamadas que você não fez. A restrição, portanto, é inegociável.

Acessar as configurações de restrição

Em "APIs e serviços" > "Credenciais", clique no ícone de lápis ao lado da sua chave. Você acessa a página de configuração detalhada.

Tipos de restrições disponíveis

Restrições de aplicativo — limitam as fontes autorizadas a usar a chave:

Referenciadores HTTP: para chaves usadas em sites. Você lista os domínios autorizados, por exemplo meusite.com/* ou *.meusite.com/*. Qualquer solicitação vinda de outro domínio é rejeitada.
Endereços IP: para chaves usadas no lado do servidor. Você lista os IPs autorizados.
Aplicativos Android: restrição por impressão digital SHA-1 do certificado e nome do pacote.
Aplicativos iOS: restrição por Bundle ID.

Restrições de API — limitam as APIs que esta chave pode chamar:

Selecione "Restringir chave" e marque apenas as APIs que você realmente usa.
Uma chave dedicada à Maps JavaScript API não deve poder chamar a Places API se você não precisar.

Boa prática: uma chave por uso

Crie chaves separadas para cada contexto: uma para o front-end web, uma para o back-end servidor, uma para o app móvel. Se uma chave for comprometida, você a revoga sem impactar as outras.

Compreender a cobrança da Google Maps Platform

A Google Maps Platform não é gratuita além de um certo volume. Cada API tem suas próprias tarifas.

O Google oferece 200 $ de créditos gratuitos por mês a todas as contas. Para a maioria dos pequenos projetos, isso é suficiente para ficar dentro dos limites gratuitos.

Além disso, as tarifas variam conforme a API:

Maps JavaScript API: ~7 $ por 1.000 carregamentos de mapa
Geocoding API: ~5 $ por 1.000 solicitações
Places API (Nearby Search): ~32 $ por 1.000 solicitações

Configure alertas de orçamento no GCP (menu "Cobrança") para ser notificado se seu consumo ultrapassar um limite definido. Você também pode limitar os gastos para evitar surpresas desagradáveis.

Alternativas à API Google Maps para prospecção comercial

A API Google Maps é ideal para exibir mapas e geocodificar endereços em um aplicativo. Mas se seu objetivo é extrair dados de negócios locais para prospecção comercial, a abordagem é diferente.

A API Places do Google dá acesso aos dados de comércios locais — mas é cara em grande escala, limitada a 20 resultados por solicitação, e não fornece os e-mails nem as tecnologias web dos sites.

Para gerar listas de leads a partir do Google Maps, o IBLead é uma alternativa direta. A base cobre mais de 50 milhões de negócios em 37 países, com mais de 50 campos de dados por ficha: nome, endereço, telefone, e-mail, nota do Google, número de avaliações, tecnologias do site e mais.

Sem scraping em tempo real, sem espera. Tudo já está indexado e atualizado semanalmente. Você filtra por cidade, categoria, nota, tecnologias — e exporta em CSV em 2 minutos. A 44€ por 10.000 contatos, isso dá 0,004€ por lead.

FAQ — Chave API Google Maps

A chave API Google Maps é gratuita?

Sim, dentro dos limites do crédito mensal de 200 $ oferecido pelo Google. Para a maioria dos pequenos projetos, esse crédito cobre todo o consumo. Além disso, o Google cobra conforme as chamadas realizadas.

Quanto tempo leva para obter uma chave API Google Maps?

Cerca de 10 a 20 minutos se você começar do zero (criação da conta GCP incluída). Se você já tiver uma conta GCP e um projeto configurado, a geração da chave leva menos de 2 minutos.

É possível usar várias chaves API em um mesmo projeto?

Sim. É até recomendado criar uma chave por uso (front-end, back-end, móvel) para facilitar a gestão das restrições e a revogação em caso de problemas.

O que fazer se minha chave API for comprometida?

Vá imediatamente em "APIs e serviços" > "Credenciais", clique na sua chave e selecione "Regenerar chave". A chave antiga é invalidada instantaneamente. Atualize sua chave em todos os seus aplicativos.

Qual é a diferença entre a API Google Maps e a API Places?

A Maps JavaScript API serve para exibir mapas interativos em um navegador. A Places API serve para pesquisar locais, obter seus detalhes (endereço, horários, avaliações, fotos) e fazer autocompletar endereços. Ambas podem ser usadas juntas em um mesmo projeto.

Pronto para gerar leads a partir do Google Maps?

Se você está procurando extrair dados de negócios locais para sua prospecção — sem codificar, sem gerenciar APIs, sem esperar — o IBLead oferece acesso a mais de 50 milhões de fichas pré-indexadas em 37 países.

Experimente com 200 créditos.

créditos gratuitos — 200 créditos incluídos

Pronto para começar?

Aceda a todas as empresas do Google Maps, enriquecidas com emails e dados legais.

Experimente o IBLead gratuitamente

Também pode gostar

Conselhos para melhorar seu ranking no Google Maps API de dados de empresas Google Maps: integre leads enriquecidos no seu stack Guia: Configuração da Chave da API do Google Maps (2025)