API Google Maps e avaliações Google: guia completo de exploração

As avaliações Google se tornaram a decisão de compra nº 1 para os consumidores. 92% dos usuários leem as avaliações antes de escolher uma empresa local. Mas como acessar esses dados de forma sistemática? Como analisá-los em grande escala?

É aí que entra a API Google Maps. Ela oferece acesso estruturado aos dados de milhões de locais, incluindo avaliações, notas, horários e muito mais.

Este artigo mostra como usar a API Google Maps, suas limitações reais, como proteger sua chave API e, acima de tudo, como aproveitar as avaliações para sua prospecção comercial.

---

O que é a API Google Maps?

A API Google Maps não é uma ferramenta única. É um conjunto de APIs distintas, cada uma com um papel específico.

As principais APIs Google Maps

Maps JavaScript API Integra mapas interativos em suas páginas web. Você pode adicionar marcadores, polígonos, rotas. Utilizada por 99% dos sites com um mapa incorporado.

Geocoding API Converte um endereço em coordenadas GPS (latitude/longitude) ou vice-versa. Exemplo: "10 rue de la Paix, Paris" → 48.8566, 2.3522.

Directions API Calcula rotas entre dois pontos. Modos: carro, bicicleta, transporte público, a pé. Retorna a duração, a distância, as etapas detalhadas.

Places API Acessa informações sobre locais: restaurantes, hotéis, comércios, serviços. É a API que você deve usar se estiver procurando extrair dados de negócios (nome, endereço, telefone, site, avaliações).

Distance Matrix API Calcula distâncias e durações entre vários pontos. Útil para otimizar rotas de entrega ou de serviço.

Maps Static API Gera imagens de mapas estáticos (PNG, GIF, JPG) sem interface interativa.

Street View API Acessa imagens panorâmicas do Street View.

Para prospecção comercial e análise de avaliações, você usará principalmente a Places API.

---

Como obter uma chave API Google Maps

Passo 1: Criar uma conta Google Cloud

Acesse console.cloud.google.com.

Faça login com sua conta Google (ou crie uma).

Passo 2: Criar um projeto

No console, clique em "Criar um projeto" (no canto superior esquerdo).

Dê um nome: "Prospecção Comercial", "Análise de Avaliações", etc.

Aguarde alguns segundos para que o projeto seja criado.

Passo 3: Ativar as APIs necessárias

No menu à esquerda, vá em "APIs e serviços" → "Biblioteca".

Pesquise por "Places API" e clique em "Ativar".

Faça o mesmo para "Geocoding API" e "Maps JavaScript API" se precisar.

Passo 4: Criar uma chave API

Vá em "APIs e serviços" → "Credenciais".

Clique em "Criar credenciais" → "Chave API".

Sua chave API será exibida (uma longa sequência de caracteres aleatórios).

Copie-a e mantenha em segredo.

Passo 5: Configurar a cobrança

O Google oferece 200$ de créditos gratuitos por mês para novas contas.

Vá em "Cobrança" e vincule um cartão de crédito.

Importante: mesmo com os créditos gratuitos, você deve configurar a cobrança para usar a API. Sem isso, a API será bloqueada após o esgotamento dos créditos de teste.

---

Precificação da API Google Maps: o que você precisa saber

O Google cobra por chamada de API. As tarifas variam de acordo com o serviço.

Custos reais (2024)

Places API (pesquisa e detalhes)

• Pesquisa por texto: 32$ para 1.000 requisições
• Pesquisa nas proximidades: 32$ para 1.000 requisições
• Detalhes do local: 17$ para 1.000 requisições

Geocoding API

• 5$ para 1.000 requisições

Directions API

• 5$ para 1.000 requisições

Exemplo concreto: extrair 10.000 restaurantes na França

Para buscar todos os restaurantes na França via Places API:

• 1 requisição de pesquisa por área geográfica
• Se você dividir a França em 50 áreas, isso custará: 50 × 0.032$ = 1.60$
• Para recuperar os detalhes de cada restaurante (telefone, horários, avaliações): 10.000 × 0.017$ = 170$
• Total: ~171.60$ para 10.000 restaurantes.

É muito se você precisar fazer isso regularmente.

Quotas e limites

O Google impõe quotas para proteger seus servidores:

• Requisições por segundo: 50 (gratuito) ou 100+ (com solicitação especial)
• Requisições por dia: ilimitadas (mas pagas)
• Resultados por requisição: máximo 20 resultados (Places API)
• Resultados totais por pesquisa: máximo 60 resultados (3 páginas de 20)

Limitação crítica: com a Places API, você só pode recuperar 60 resultados por pesquisa. Para extrair 10.000 restaurantes, você precisará fazer 167 pesquisas diferentes (dividindo geograficamente ou por categoria).

Isso significa 167 requisições de pesquisa × 0.032$ = 5.34$ no mínimo, além das requisições de detalhes.

---

Proteger sua chave API Google Maps

Sua chave API é como uma senha. Se alguém a roubar, pode fazer chamadas de API às suas custas.

Riscos reais

• Um atacante usa sua chave para fazer 100.000 requisições em uma noite: 3.000$ de custos
• Sua aplicação web expõe a chave em JavaScript: qualquer usuário pode copiá-la do código-fonte
• Um funcionário a posta acidentalmente no GitHub: os bots a detectam em segundos

Como proteger sua chave

1. Restringir por domínio (HTTP Referrer)

No console Google Cloud, vá em "Credenciais" → clique na sua chave API.

Em "Restrições de aplicativos", escolha "Chave de site web HTTP (sites, domínios)".

Adicione seus domínios autorizados:

• www.seusite.com
• seusite.com
• app.seusite.com

Apenas as requisições provenientes desses domínios serão aceitas.

2. Restringir por API

Em "Restrições de API", marque apenas as APIs que você usa.

Se você usar apenas a Places API, desative Geocoding, Directions, Street View, etc.

Dessa forma, mesmo que alguém roube sua chave, não poderá usá-la para acessar outros serviços.

3. Monitorar o uso

Vá em "Cobrança" → "Relatórios de uso".

Verifique todos os dias quantas chamadas de API você faz.

Configure um alerta: se você ultrapassar X$ por dia, receberá um e-mail.

4. Rotação regular

Crie uma nova chave API a cada 3 meses.

Exclua a chave antiga.

Isso limita o tempo durante o qual uma chave roubada pode ser usada.

5. Nunca expor a chave no frontend

❌ Errado:

// No seu código JavaScript visível
const apiKey = "AIzaSyD..."; // EXPosta
fetch(`https://maps.googleapis.com/maps/api/place/textsearch/json?key=${apiKey}&query=restaurants`)

✅ Certo:

// Do seu frontend
fetch('/api/search-restaurants?query=restaurants')
// Seu backend faz a chamada API com a chave

Seu backend (Node.js, Python, PHP) mantém a chave em segredo. O frontend nunca a vê.

6. Para aplicativos móveis

Use um proxy backend. Seu aplicativo móvel chama seu servidor, que chama o Google Maps.

A chave API nunca é armazenada no aplicativo (ela pode ser descompilada).

---

Places API: como extrair dados de locais

A Places API fornece acesso às informações básicas sobre um local.

Tipos de pesquisa

Text Search (pesquisa por texto)

https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants+paris&key=YOUR_API_KEY

Retorno:

• Nome do restaurante
• Endereço
• Nota Google
• Número de avaliações
• Coordenadas GPS
• Place ID

Nearby Search (pesquisa nas proximidades)

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=48.8566,2.3522&radius=5000&type=restaurant&key=YOUR_API_KEY

Pesquisa todos os restaurantes em um raio de 5 km ao redor de uma coordenada.

Place Details (detalhes do local)

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ...&key=YOUR_API_KEY

Recupera as informações completas: telefone, site, horários, fotos, avaliações, etc.

Dados disponíveis via Places API

• Nome, endereço completo, código postal
• Telefone
• Site
• Categorias (tipo de negócio)
• Nota Google (0-5 estrelas)
• Número total de avaliações
• Horários de funcionamento
• Fotos (número e URL)
• Coordenadas GPS
• Place ID (identificador único Google)

O que a Places API NÃO fornece

❌ Texto das avaliações (conteúdo dos comentários)
❌ Autor das avaliações
❌ Data das avaliações
❌ Detalhes da ficha (fotos detalhadas, vídeos)
❌ Histórico de alterações

Para acessar o texto das avaliações, você deve fazer scraping diretamente da página do Google Maps ou usar uma ferramenta especializada.

---

Analisar as avaliações Google: estratégia e implementação

As avaliações Google são uma mina de ouro para entender seus concorrentes e identificar oportunidades de negócios.

Passo 1: Definir seus critérios de análise

Antes de analisar, decida o que você está procurando.

Caso de uso 1: Identificar concorrentes mal avaliados

Você é uma agência de reputação online. Você procura empresas com uma nota < 3 estrelas para contatá-las.

Critérios:

• Nota média < 3 estrelas
• Pelo menos 20 avaliações (para evitar casos isolados)
• Últimas avaliações datando de menos de 3 meses (problema recente)

Caso de uso 2: Analisar a satisfação por setor

Você é um consultor de marketing. Você analisa a satisfação média na sua região para cada setor (restaurantes, salões de beleza, encanadores, etc.).

Critérios:

• Nota média por setor
• Número de avaliações por setor
• Evolução da nota ao longo de 12 meses

Caso de uso 3: Encontrar clientes para uma agência web

Você vende serviços web. Você procura empresas com um site ruim (ultrapassado, não responsivo, sem formulário de contato).

Critérios:

• Sem site (ou site muito antigo)
• Nota Google < 4 estrelas (insatisfação possível relacionada ao web)
• Número de avaliações > 50 (empresa estabelecida, pode se permitir investir)

Passo 2: Extrair os dados

Use a Places API para recuperar a nota e o número de avaliações.

Exemplo em Python:

import requests

API_KEY = "YOUR_API_KEY"

def search_restaurants(city, min_rating=3.0):
    url = "https://maps.googleapis.com/maps/api/place/textsearch/json"
    params = {
        "query": f"restaurants {city}",
        "key": API_KEY
    }
    
    response = requests.get(url, params=params)
    results = response.json().get("results", [])
    
    filtered = [
        {
            "name": r["name"],
            "address": r["formatted_address"],
            "rating": r.get("rating", 0),
            "review_count": r.get("user_ratings_total", 0),
            "place_id": r["place_id"]
        }
        for r in results
        if r.get("rating", 0) >= min_rating
    ]
    
    return filtered

# Uso
restaurants = search_restaurants("Paris", min_rating=4.0)
for r in restaurants:
    print(f"{r['name']} - {r['rating']} ⭐ ({r['review_count']} avaliações)")

Passo 3: Analisar o conteúdo das avaliações

A Places API não fornece o texto das avaliações. Você deve fazer scraping diretamente ou usar uma ferramenta.

Análise manual (para pequeno volume)

1. Vá ao Google Maps
2. Abra a ficha do concorrente
3. Leia as avaliações (da mais recente para a mais antiga)
4. Anote os temas recorrentes: serviço, preço, limpeza, prazo, etc.

Análise automatizada (para grande volume) Use uma ferramenta de scraping ou uma API de terceiros que extraia o texto das avaliações.

Busque os temas:

• Positivos: "serviço rápido", "atendimento caloroso", "excelente custo-benefício"
• Negativos: "espera muito longa", "pessoal rude", "caro pela qualidade"

Passo 4: Identificar oportunidades

Exemplo 1: Encanador mal avaliado

Você encontra um encanador com 2.8 ⭐ (45 avaliações). Avaliações recentes mencionam: "orçamento muito caro", "sem acompanhamento", "prazo de intervenção longo".

Oportunidade: contatar o proprietário para oferecer uma agência de marketing para melhorar sua reputação e seu atendimento ao cliente.

Exemplo 2: Restaurante sem site

Você encontra um restaurante com 4.2 ⭐ (120 avaliações), mas sem site. Avaliações mencionam: "difícil encontrar os horários", "sem reserva online".

Oportunidade: oferecer um site com reserva online.

Exemplo 3: Salão de beleza em queda

Você encontra um salão com uma nota que caiu (4.5 → 3.8 em 6 meses). Avaliações recentes: "o proprietário mudou", "menos bom que antes", "preços aumentados".

Oportunidade: contatar o novo proprietário para oferecer um treinamento de atendimento ou uma auditoria de serviço.

---

Limitações reais da API Google Maps para extração de dados

Limite 1: Você só pode recuperar 60 resultados por pesquisa

A Places API retorna no máximo 20 resultados por página, 3 páginas = 60 resultados.

Para extrair 10.000 restaurantes na França, você precisará fazer 167 pesquisas diferentes (por área geográfica ou por subcategoria).

Impacto: tempo de processamento longo, custos elevados, risco de atingir as quotas.

Limite 2: As avaliações não são acessíveis

A Places API fornece o número de avaliações e a nota média, mas não o texto das avaliações.

Para analisar o conteúdo (o que os clientes realmente dizem), você deve fazer scraping diretamente do Google Maps.

Impacto: você precisará usar duas ferramentas (API + scraper) para ter uma visão completa.

Limite 3: As quotas e custos se acumulam rapidamente

Cada requisição tem custo. Para extrair 10.000 restaurantes com detalhes, conte com 170$+.

Se você precisar atualizar os dados todo mês, isso será 2.000$ por ano no mínimo.

Impacto: solução cara para PMEs e agências.

Limite 4: Os dados não são atualizados em tempo real

A API indexa os dados, mas há um atraso. Um novo restaurante pode levar dias para aparecer.

Impacto: dados ligeiramente obsoletos.

Limite 5: Restrições geográficas e legais

O Google limita as requisições por região para evitar abusos. Alguns países têm restrições adicionais.

Impacto: impossível extrair massivamente certos setores.

---

Usar IBLead: uma alternativa para a prospecção Google Maps

Se você está procurando extrair dados do Google Maps e avaliações em grande escala, a API Google Maps tem suas limitações (custos, quotas, dados incompletos).

O IBLead oferece uma abordagem diferente: uma base de dados pré-indexada de mais de 5 milhões de fichas do Google Maps, atualizada mensalmente, com acesso completo às avaliações Google.