Extrair Dados do Google Maps com a API JavaScript: Guia Completo

O Google Maps possui uma das maiores bases de dados públicas de informações empresariais do planeta. Cada busca retorna uma lista de empresas com endereços, números de telefone, sites, classificações e avaliações. Se você deseja extrair dados do Google Maps com a API JavaScript em grande escala, este guia o orienta pelos passos exatos — desde a configuração da sua chave da API até a execução de três exemplos práticos.

No final, você saberá como geocodificar endereços, buscar empresas por categoria e localização, e calcular direções. Você também entenderá onde a API tem limitações e o que fazer a respeito.

---

Por que Extrair Dados do Google Maps?

A razão mais comum é a geração de leads. Equipes de vendas extraem listas de negócios locais — restaurantes, dentistas, empreiteiros — filtradas por cidade ou categoria. Mas esse não é o único caso de uso.

Os profissionais de marketing usam dados do Google Maps para monitorar concorrentes: sinais de preços, detalhes de instalações, itens do menu. Analistas imobiliários mapeiam a densidade de negócios para avaliar bairros. Operadores de franquias identificam lacunas em sua área de abrangência.

Em todos esses casos, o objetivo é o mesmo: transformar uma busca no Google Maps em um conjunto de dados estruturado e exportável.

---

Configurando Sua Chave da API do Google Maps

Antes de escrever uma única linha de código, você precisa de uma chave da API. Veja como obter uma.

Vá para console.cloud.google.com. Crie um novo projeto — dê a ele qualquer nome. Assim que o projeto for criado, selecione-o na navegação superior.

Em seguida, vá para APIs e Serviços → Biblioteca. Cada API que você planeja usar deve ser habilitada individualmente. Para os exemplos deste guia, você precisará de:

• API de Geocodificação — converte endereços em coordenadas
• API de Lugares (Nova) — busca empresas por categoria e localização
• API de Direções — calcula rotas entre dois pontos

Habilite cada uma clicando nela e pressionando "Habilitar".

Após habilitar sua primeira API, vá para APIs e Serviços → Credenciais. Sua chave da API aparecerá lá. Copie-a e armazene em um lugar seguro.

Uma observação importante: a API do Google Maps é um serviço pago. Você precisará anexar uma conta de faturamento ao seu projeto. O Google fornece $200 em créditos mensais gratuitos, o que cobre aproximadamente 40.000 solicitações de Geocodificação ou 6.250 solicitações da API de Lugares antes que as cobranças comecem.

---

Exemplo 1: Geocodificando um Endereço

A geocodificação converte um endereço legível por humanos em coordenadas de latitude e longitude. Esta é a base da maioria dos workflows baseados em localização.

O que a API de Geocodificação Faz

Envie uma string de endereço → receba de volta coordenadas. É isso. A resposta também inclui o ID do Lugar, que você pode reutilizar em outras chamadas da API.

A URL da Solicitação

A URL base se parece com isto:

https://maps.googleapis.com/maps/api/geocode/json?address=SEU_ENDERECO&key=SUA_CHAVE_API

O parâmetro address deve ser codificado em URL. Espaços se tornam %20, vírgulas se tornam %2C, e assim por diante.

Implementação em JavaScript

const address = encodeURIComponent("1600 Amphitheatre Parkway, Mountain View, CA");
const apiKey = "SUA_CHAVE_API";

const url = `https://maps.googleapis.com/maps/api/geocode/json?address=${address}&key=${apiKey}`;

fetch(url)
  .then(response => response.json())
  .then(data => {
    const location = data.results[0].geometry.location;
    console.log("Latitude:", location.lat);
    console.log("Longitude:", location.lng);
    console.log("Place ID:", data.results[0].place_id);
  })
  .catch(error => console.error("Erro:", error));

Lendo a Resposta

A resposta é um objeto JSON. As coordenadas estão em results[0].geometry.location. Você obtém lat e lng como campos separados. O ID do Lugar está em results[0].place_id — salve-o se você planeja usar a API de Lugares ou a API de Direções a seguir.

Custo da API de Geocodificação: aproximadamente $5 por 1.000 solicitações. O crédito mensal de $200 cobre 40.000 solicitações antes que a cobrança comece.

---

Exemplo 2: Buscando Empresas por Categoria

É aqui que as coisas se tornam úteis para a geração de leads. A API de Lugares (Nova) permite que você busque empresas por tipo e localização. Você define uma categoria, uma área geográfica e uma contagem de resultados — a API retorna empresas correspondentes.

Habilitando a API Correta

Certifique-se de que você habilitou a API de Lugares (Nova) no seu console do Google Cloud, não a API de Lugares legada. A nova versão usa um endpoint e formato de solicitação diferentes.

Configurando a Solicitação

A API de Lugares (Nova) usa uma solicitação POST para:

https://places.googleapis.com/v1/places:searchNearby

Você envia um corpo JSON com seus parâmetros de busca e inclui sua chave da API e máscara de campo nos cabeçalhos.

Implementação em JavaScript

const apiKey = "SUA_CHAVE_API";

const payload = {
  includedTypes: ["restaurant"],
  maxResultCount: 10,
  locationRestriction: {
    circle: {
      center: {
        latitude: 40.7128,
        longitude: -74.0060
      },
      radius: 500.0
    }
  }
};

const headers = {
  "Content-Type": "application/json",
  "X-Goog-Api-Key": apiKey,
  "X-Goog-FieldMask": "places.displayName,places.formattedAddress,places.nationalPhoneNumber,places.websiteUri,places.rating"
};

fetch("https://places.googleapis.com/v1/places:searchNearby", {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => {
    data.places.forEach(place => {
      console.log(place.displayName.text, "-", place.formattedAddress);
    });
  })
  .catch(error => console.error("Erro:", error));

Entendendo as Máscaras de Campo

O cabeçalho X-Goog-FieldMask controla quais campos de dados a API retorna. Solicite apenas o que você precisa — isso afeta tanto o desempenho quanto o custo.

Máscaras de campo comuns para extração de dados empresariais:

Campo	O que retorna
places.displayName	Nome da empresa
places.formattedAddress	Endereço completo
places.nationalPhoneNumber	Número de telefone
places.websiteUri	URL do site
places.rating	Classificação média do Google
places.userRatingCount	Número de avaliações
places.regularOpeningHours	Horários de funcionamento

O Limite de 120 Resultados

Aqui está uma restrição rígida: a API de Lugares retorna um máximo de 20 resultados por solicitação, e a paginação é limitada a cerca de 60 resultados totais por área de busca. Se você precisar de mais, terá que dividir sua área geográfica em círculos menores e executar várias solicitações.

Essa é a principal razão pela qual os desenvolvedores buscam alternativas quando precisam extrair dados do Google Maps em grande escala.

Custo da API de Lugares: aproximadamente $32 por 1.000 solicitações para campos de dados básicos. Campos avançados (avaliações, fotos) custam mais.

---

Exemplo 3: Calculando Direções Entre Dois Pontos

A API de Direções calcula rotas entre uma origem e um destino. Ela retorna tempo de viagem, distância e instruções passo a passo.

Casos de Uso

Otimização de rotas para equipes de vendas externas. Estimativas de tempo de entrega. Mapeamento de áreas de cobertura de serviços. Identificação de quais empresas estão dentro de um tempo de deslocamento específico a partir de uma localização.

A URL da Solicitação

https://maps.googleapis.com/maps/api/directions/json?origin=ORIGEM&destination=DESTINO&mode=driving&departure_time=TIMESTAMP&key=SUA_CHAVE_API

Para origem e destino, você pode usar:

• Um endereço formatado: "Montreal, QC, Canadá"
• Coordenadas: "45.5017,-73.5673"
• Um ID de Lugar: "place_id:ChIJDbdkHFQayUwR7-8fITgxTmU"

Implementação em JavaScript

const apiKey = "SUA_CHAVE_API";
const origin = "place_id:ChIJDbdkHFQayUwR7-8fITgxTmU"; // Montreal
const destination = "place_id:ChIJrxNRX7IFzkwR7RXdMeFRaUU"; // Ottawa
const departureTime = Math.floor(Date.now() / 1000); // Timestamp atual

const url = `https://maps.googleapis.com/maps/api/directions/json?origin=${encodeURIComponent(origin)}&destination=${encodeURIComponent(destination)}&mode=driving&departure_time=${departureTime}&key=${apiKey}`;

fetch(url)
  .then(response => response.json())
  .then(data => {
    const route = data.routes[0].legs[0];
    console.log("Distância:", route.distance.text);
    console.log("Duração:", route.duration.text);
    console.log("Duração no trânsito:", route.duration_in_traffic?.text);
  })
  .catch(error => console.error("Erro:", error));

Convertendo Datas em Timestamps

O parâmetro departure_time requer um timestamp Unix — o número de segundos desde 1º de janeiro de 1970. Para converter uma data específica, use epochconverter.com ou execute isto em JavaScript:

const date = new Date("2025-06-15T09:00:00");
const timestamp = Math.floor(date.getTime() / 1000);
console.log(timestamp);

Custo da API de Direções: aproximadamente $5 por 1.000 solicitações.

---

Considerações Legais para Extração de Dados do Google Maps

Usar a API oficial do Google Maps mantém você dentro dos termos de serviço do Google. Essa é a abordagem mais segura. Mas ainda existem regras a seguir.

Respeite os limites de taxa. Cada API tem cotas diárias. Excedê-las gera erros e potencial suspensão da conta. Monitore seu uso no console do Google Cloud.

Acesse apenas dados públicos. A API retorna informações empresariais visíveis publicamente. Não tente acessar dados privados de usuários ou contornar a autenticação.

Não armazene dados indefinidamente. Os termos do Google restringem por quanto tempo você pode armazenar certos tipos de dados. Verifique os termos específicos para cada API que você utiliza.

Uso comercial é permitido — com condições. Você pode usar dados extraídos para geração de leads, pesquisa de mercado e inteligência de negócios. Você não pode revender dados brutos do Google Maps como um produto autônomo.

Para scraping direto (sem a API oficial), a situação legal é mais nebulosa. Os termos de serviço do Google proíbem o scraping de suas propriedades sem permissão. Os tribunais emitiram decisões mistas sobre isso. O caminho mais seguro é sempre a API oficial.

---

As Limitações da API do Google Maps

A API funciona bem para extrações pequenas a médias. Mas tem restrições reais quando você precisa de volume.

Os custos aumentam rapidamente. A API de Lugares cobra cerca de $32 por 1.000 solicitações. Extrair 50.000 listagens de negócios custa aproximadamente $1.600 apenas em taxas da API — antes de qualquer tempo de desenvolvimento.

O limite de 120 resultados. Nenhuma busca única retorna mais de 120 resultados. Cobrir uma cidade inteira requer dezenas de azulejos geográficos sobrepostos, cada um com sua própria chamada da API.

Sem exportação em massa. A API retorna JSON. Você escreve o código para analisá-lo, remover duplicatas e exportar para CSV. Isso é trabalho de engenharia real.

Gaps de dados. Nem toda empresa possui um site, número de telefone ou e-mail. A API retorna o que o Google tem — o que varia de acordo com a localização e o tipo de negócio.

---

A Alternativa Sem Código: IBLead

Se você precisa extrair dados do Google Maps sem escrever código da API, o IBLead foi feito para isso.

O IBLead é uma base de dados pré-indexada de mais de 50 milhões de empresas em 37 países. Tudo já foi extraído e indexado — atualizado semanalmente. Você busca por cidade, código postal, região ou país inteiro. Filtre por categoria, classificação do Google, contagem de avaliações ou as tecnologias que uma empresa usa em seu site. Depois, exporte para CSV instantaneamente.

Sem configuração de API. Sem limites de taxa para gerenciar. Sem cobrança por solicitação.

O IBLead detecta mais de 160 tecnologias web por listagem de negócios — plataformas de CMS, ferramentas de análise, pixels de anúncios, processadores de pagamento. Esses são dados que a API do Google Maps não retorna de forma alguma. Você também pode acessar até 500 avaliações do Google por listagem, incluindo texto da avaliação, classificação, data e autor.

Para 10.000 leads, você está olhando para $52 — isso dá $0,004 por contato. O teste oferece 200 créditos para você testar por conta própria.

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

---

Perguntas Frequentes

É legal extrair dados do Google Maps?

Usar a API oficial do Google Maps é legal e está dentro dos termos de serviço do Google. O scraping direto sem a API viola os termos do Google e traz riscos legais. Para uso comercial, a API ou um provedor de dados licenciado é a abordagem correta.

Qual é o limite de resultados ao fazer scraping do Google Maps?

A API de Lugares retorna um máximo de 20 resultados por solicitação, com paginação limitada a cerca de 60 resultados por área de busca. Ferramentas de scraping direto costumam atingir um limite de ~120 resultados por consulta. Para cobrir áreas maiores, você precisa dividir a geografia em azulejos menores.

Quanto custa a API do Google Maps?

Os preços variam de acordo com o tipo de API. A geocodificação custa cerca de $5 por 1.000 solicitações. A API de Lugares custa cerca de $32 por 1.000 solicitações para dados básicos. Direções custam cerca de $5 por 1.000 solicitações. O Google fornece $200 em créditos mensais gratuitos, que cobrem o uso moderado antes que as cobranças se apliquem.

Posso exportar dados do Google Maps para Excel ou CSV?

A API retorna JSON — você precisa escrever código para convertê-lo em CSV ou Excel. Ferramentas como o IBLead pulam completamente essa etapa: busque, filtre e exporte diretamente para CSV em menos de dois minutos.

Quais campos de dados posso extrair do Google Maps?

Através da API oficial: nome da empresa, endereço, número de telefone, site, classificação, contagem de avaliações, horários de funcionamento, coordenadas e ID do Lugar. O IBLead adiciona endereços de e-mail (enriquecidos a partir de sites de empresas), perfis de redes sociais, stack tecnológico e até 500 avaliações completas do Google por listagem.

---

Concluindo

Extrair dados do Google Maps com a API JavaScript é simples uma vez que você entende as três APIs principais: Geocodificação para coordenadas, Lugares para busca de negócios e Direções para roteamento. Cada uma tem documentação clara, preços previsíveis e suporte oficial do Google.

Os trade-offs são reais, no entanto. Os custos da API aumentam em volume. Os limites de resultados exigem azulejamento geográfico. E você ainda precisa escrever o código para analisar, remover duplicatas e exportar seus dados.

Para desenvolvedores que constroem aplicações cientes da localização, a API é a ferramenta certa. Para equipes de vendas e profissionais de marketing que precisam de listas de negócios rapidamente, uma solução pré-indexada economiza horas de trabalho de engenharia.

De qualquer forma, você agora tem a visão completa para tomar a decisão certa para seu caso de uso.