Chave API Google Maps: Guia completo para começar em 2025

Você quer integrar o Google Maps no seu site, no seu app móvel ou acessar os dados cartográficos do Google? Você precisa de uma chave API.

É mais simples do que parece. Este artigo mostra como criá-la em 5 etapas, como protegê-la corretamente e integrá-la ao seu projeto — sem complicações.

O que é uma chave API Google Maps?

Uma chave API é uma sequência de caracteres única gerada pelo Google. Ela funciona como um identificador: autentica seu aplicativo e permite o acesso aos serviços do Google Maps.

Na prática: seu app ou site envia essa chave ao Google. O Google verifica se você tem permissão para usar a API e, em seguida, retorna os dados (mapas, endereços, geolocalização, etc.).

Por que uma chave API é necessária

O Google usa chaves API por três razões:

1. Autenticação — O Google sabe que é você quem está fazendo a solicitação, e não outra pessoa
2. Monitoramento de uso — O Google mede quantas vezes você chama a API (para faturamento)
3. Segurança — Você pode restringir o uso a determinados domínios ou aplicativos

Sem uma chave API, o Google não saberia quem você é. Com ela, você pode usar Maps JavaScript, Directions, Geocoding, Distance Matrix e mais de 10 outros serviços.

Os diferentes tipos de chaves API Google Maps

O Google oferece vários tipos de chaves, dependendo da sua necessidade:

Chave API para Web (JavaScript) Usada para exibir mapas interativos em um site. É a mais comum. Exemplo: você tem um site de restaurante e integra um mapa para mostrar sua localização.

Chave API para Android Dedicada a apps Android. Você a configura com o SHA-1 do seu certificado de aplicativo.

Chave API para iOS Dedicada a apps iOS. Você a configura com o Bundle ID do seu app.

Chave API para Geolocalização Acesso à API de Geolocalização para localizar um usuário (endereço IP, pontos de acesso WiFi, etc.).

Chave API para Street View Integração das imagens do Street View no seu app ou site.

Cada tipo tem suas próprias restrições e configurações. Você pode criar várias chaves para diferentes projetos.

Etapa 1: Criar uma conta no Google Cloud Platform

Antes de tudo, você precisa de uma conta no Google Cloud Platform (GCP). É o console central onde você gerencia todas as APIs do Google.

Requisitos

• Uma conta Gmail (obrigatória)
• Um método de pagamento válido (mesmo para o teste gratuito)

Criar sua conta GCP

1. Vá para Google Cloud
2. Clique em “Teste gratuito” (no canto superior direito)
3. Faça login com sua conta Gmail
4. Aceite os termos e insira suas informações de pagamento

O Google lhe dá $300 em créditos gratuitos por 90 dias. Você não será cobrado até ultrapassar esse valor.

O que você recebe com o teste gratuito

• Acesso completo ao Google Cloud Platform
• Uso gratuito da maioria das APIs (com limites)
• Créditos para serviços pagos
• Suporte técnico básico

Uma vez que sua conta é criada, você acessa o Painel do GCP. Esse é o seu ponto de partida para tudo.

Etapa 2: Criar e configurar um projeto GCP

Um projeto GCP é um contêiner para suas APIs, suas credenciais e suas configurações. Cada projeto é isolado dos outros — isso é útil se você gerencia vários apps ou sites.

Criar um novo projeto

1. Faça login em console.cloud.google.com
2. No canto superior esquerdo, você verá “Selecionar um projeto” (com um pequeno menu suspenso)
3. Clique nele
4. Uma janela se abre. Clique em “NOVO PROJETO”
5. Dê um nome ao seu projeto (ex: "Meu Site Maps" ou "App Móvel v1")
6. Selecione uma organização (ou deixe em branco)
7. Clique em “Criar”

O Google cria o projeto. Isso leva alguns segundos.

Selecionar seu projeto como ativo

Uma vez criado, volte ao menu “Selecionar um projeto” e clique no seu novo projeto para ativá-lo.

Agora você está no seu projeto. Você verá o Painel com estatísticas vazias (normal, você ainda não ativou nada).

Por que criar um projeto dedicado?

Se você tem vários sites ou apps, crie um projeto por site. Isso permite que você: - Gerencie as chaves API separadamente - Acompanhe os custos por projeto - Revogue uma chave sem afetar os outros projetos - Compartilhe o acesso a um projeto sem compartilhar todos os seus projetos

Etapa 3: Ativar as APIs Google Maps

Agora que seu projeto existe, você precisa ativar as APIs que vai usar.

Acessar a Biblioteca de APIs

1. No menu lateral esquerdo, clique em “APIs e serviços”
2. Em seguida, clique em “Biblioteca”

Você verá uma lista de centenas de APIs do Google. Você vai procurar a que precisa.

Procurar e ativar uma API

Se você quiser exibir um mapa interativo em um site: 1. Procure “Maps JavaScript API” 2. Clique no resultado 3. Clique em “Ativar”

O Google ativa a API para seu projeto. Isso leva alguns segundos.

Se você quiser converter um endereço em coordenadas GPS: 1. Procure “Geocoding API” 2. Clique em “Ativar”

Se você quiser calcular rotas: 1. Procure “Directions API” 2. Clique em “Ativar”

Você pode ativar várias APIs no mesmo projeto. Elas compartilharão a mesma chave API (ou chaves separadas, você decide).

Verificar se a API está ativada

Vá em “APIs e serviços” → “APIs ativadas”. Você verá a lista de todas as APIs que ativou para este projeto.

Etapa 4: Criar sua chave API Google Maps

Agora que a API está ativada, você precisa criar a chave API que vai autenticar seu aplicativo.

Gerar a chave

1. Vá em “APIs e serviços” → “Credenciais”
2. No topo, clique em “+ Criar credenciais”
3. Selecione “Chave API”

O Google gera uma chave API automaticamente. Ela se parece com isso:

AIzaSyDxxxxxxxxxxxxxxxxxxxxxxxxxxx

É uma longa sequência de caracteres. Copie-a e guarde em algum lugar (você vai precisar dela em breve).

Dar um nome à sua chave

Por padrão, o Google a chama de "API key 1". Não é muito útil. Renomeie-a:

1. Clique no ícone de lápis ao lado da sua chave
2. Dê um nome descritivo (ex: "Site Web Maps", "App Móvel Android")
3. Clique em “Salvar”

Isso ajuda você a se organizar se tiver várias chaves.

Etapa 5: Proteger sua chave API

ATENÇÃO: uma chave API não protegida pode ser usada por qualquer um. Alguém poderia roubar sua chave e fazer milhares de chamadas à API — e você seria cobrado.

É por isso que você DEVE restringir o uso da sua chave.

Configurar as restrições por HTTP Referrer

Essa é a maneira mais comum para um site.

1. Vá em “Credenciais”
2. Clique na sua chave API
3. Em “Restrições de chave”, selecione “Restrição HTTP Referrer”
4. Clique em “Adicionar um item”
5. Insira seu domínio: https://meusite.com/*
6. Clique em “Salvar”

Agora, sua chave API só funciona em meusite.com. Se alguém tentar usá-la de outro domínio, o Google recusará.

Configurar as restrições para um app móvel

Para Android ou iOS, você não pode usar HTTP Referrer (um app não tem um "domínio").

No lugar, você usa:

Para Android: - Impressão digital SHA-1 (fingerprint do seu certificado) - Nome do pacote

Para iOS: - Bundle ID

Peça essas informações ao seu desenvolvedor. Elas são específicas para seu app.

Restringir as APIs

Você também tem a opção de restringir QUAIS APIs sua chave pode usar.

Exemplo: sua chave pode usar APENAS a Maps JavaScript API, não a Directions API.

1. Nas configurações da sua chave, vá em “Restrições de API”
2. Selecione “Restringir uso”
3. Marque apenas as APIs que você usa
4. Clique em “Salvar”

Essa é uma camada de segurança adicional. Se alguém roubar sua chave, ele só poderá usar as APIs autorizadas.

Os erros de segurança a evitar

NUNCA coloque sua chave API em público: - ❌ Em um arquivo público do GitHub - ❌ Em uma URL visível (ex: https://site.com?key=AIzaSy...) - ❌ Em um e-mail ou mensagem Slack - ❌ Em SHA-1 ou outro "codificação" (não é realmente seguro)

No lugar: - ✅ Armazene-a em uma variável de ambiente - ✅ Coloque-a em um arquivo .env (nunca comitado no GitHub) - ✅ Use as restrições HTTP Referrer ou SHA-1 - ✅ Revogue a chave se ela for comprometida

Integrar sua chave API no seu código

Agora que você tem sua chave, como usá-la?

Para um site web (JavaScript)

Essa é a maneira mais simples. Você adiciona uma tag <script> com sua chave:

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

Substitua AIzaSyDxxxxxxxxxxxxxxxxxxxxxxxxxxx pela sua chave verdadeira.

Depois, no seu JavaScript, você define a função initMap:

function initMap() {
  const map = new google.maps.Map(document.getElementById('map'), {
    zoom: 12,
    center: { lat: 48.8566, lng: 2.3522 } // Paris
  });
}

Isso exibe um mapa centrado em Paris.

Para um app Android

No seu arquivo AndroidManifest.xml:

<meta-data
  android:name="com.google.android.geo.API_KEY"
  android:value="AIzaSyDxxxxxxxxxxxxxxxxxxxxxxxxxxx" />

Para um app iOS

No seu arquivo AppDelegate.swift:

import GoogleMaps

GMSServices.provideAPIKey("AIzaSyDxxxxxxxxxxxxxxxxxxxxxxxxxxx")

Para uma requisição API direta (Python, Node.js, etc.)

Se você fizer chamadas HTTP diretas para a API do Google Maps (por exemplo, Geocoding):

import requests

url = "https://maps.googleapis.com/maps/api/geocode/json"
params = {
  "address": "1600 Amphitheatre Parkway, Mountain View, CA",
  "key": "AIzaSyDxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

response = requests.get(url, params=params)
data = response.json()
print(data)

As limites e os custos da API Google Maps

O Google cobra pelo uso de suas APIs. Mas há limites gratuitos.

Limites gratuitos (por mês)

API	Limite gratuito
Maps JavaScript API	28.000 chamadas/mês
Geocoding API	25.000 chamadas/mês
Directions API	25.000 chamadas/mês
Distance Matrix API	25.000 chamadas/mês
Places API	25.000 chamadas/mês

Uma vez que você ultrapassa, o Google cobra pelo uso.

Preços (após ultrapassar os limites gratuitos)

• Maps JavaScript API: $7 por 1.000 chamadas
• Geocoding API: $5 por 1.000 chamadas
• Directions API: $5 por 1.000 chamadas

Se você tem um site com 100.000 visitas por mês, e cada visitante carrega um mapa, você faz 100.000 chamadas. Isso custa cerca de 700€/mês.

Como reduzir os custos

1. Cache os resultados — se você fizer Geocoding (endereço → coordenadas), armazene o resultado. Não há necessidade de refazer a solicitação.
2. Limite as chamadas — carregue o mapa apenas se o usuário solicitar
3. Use os limites gratuitos — para um site pequeno, 28.000 chamadas/mês geralmente são suficientes

O que fazer se você precisar de muitos dados do Google Maps?

Se você precisar extrair listas de negócios (nomes, endereços, telefones, e-mails) do Google Maps, a API do Google não é a solução certa.

Por quê? Porque a API é projetada para exibir mapas e fazer cálculos (rotas, distâncias). Ela não é otimizada para extrair listas de negócios em grande escala.

É aí que uma base de dados pré-indexada como o IBLead se torna útil.

IBLead vs API Google Maps

Caso de uso: você quer encontrar todos os encanadores de Paris

Com a API do Google: - Você precisa fazer centenas de chamadas à API (caro) - Você está limitado a 120 resultados por pesquisa - Você não pode filtrar por classificação, número de avaliações ou tecnologias - Isso leva horas

Com o IBLead: - Base de dados pré-indexada (mais de 5 milhões de negócios) - Exportação em CSV em 2 cliques - Filtros avançados (classificação do Google, número de avaliações, tecnologias detectadas, SIRET na França) - Resultados instantâneos - A partir de €44/mês

Exemplo concreto: uma agência de SEO quer encontrar todos os restaurantes sem Google Analytics para abordá-los.

Com a API do Google? Impossível — a API não detecta tecnologias.

Com o IBLead? Você filtra por "tecnologias detectadas = sem Google Analytics" e exporta a lista em 30 segundos.

O IBLead não é uma alternativa à API do Google. É complementar. Você usa a API para exibir um mapa em seu site. Você usa o IBLead para extrair listas de negócios.

FAQ — Chave API Google Maps

Posso compartilhar minha chave API com outra pessoa?

Não. Cada chave API é pessoal. Se você compartilhá-la, a outra pessoa pode usá-la para fazer chamadas à sua conta (e você será cobrado). Se você precisar compartilhar o acesso a um projeto GCP, use os papéis de acesso nas configurações do projeto.

O que eu faço se minha chave API for comprometida?

1. Vá em “Credenciais”
2. Clique no ícone de lixeira ao lado da sua chave
3. Confirme a exclusão

Criar uma nova chave. As chamadas à chave antiga falharão imediatamente.

Quantas chaves API posso criar?

Quantas você quiser. Não há limite. Isso é útil se você tiver vários apps ou sites e quiser gerenciá-los separadamente.

Posso usar a mesma chave API para um site web E um app móvel?

Tecnicamente sim. Mas não é recomendado. Crie uma chave por plataforma. Isso permite que você revogue uma chave se ela for comprometida, sem afetar as outras.

A API Google Maps é gratuita?

Parcialmente. Você tem limites gratuitos (28.000 chamadas/mês para a Maps JavaScript). Além disso, você paga pelo uso. Os créditos de teste gratuito (300$) geralmente cobrem os primeiros meses.