A Google Places API é, para a geração de leads, uma das fontes de dados mais fortes do mercado DACH: o Google Maps, com mais de 200 milhões de locais e empresas segundo os próprios números da Google, é o diretório de empresas mais completo do mundo, e a Places API dá-lhe acesso oficial e programático a ele. Neste tutorial, você configura tudo passo a passo — do projeto na cloud, passando pela escolha entre Text Search e Nearby Search, até às field masks e ao modelo de preços atual (à data de julho de 2026).
Por que é o Google Places a melhor fonte de dados para leads B2B?
A Google Places API fornece dados de empresas mais atuais e completos do que qualquer assinatura de base de dados, porque as empresas mantêm os próprios perfis no Maps e a Google incorpora alterações continuamente. Por cada empresa encontrada, você recebe de forma estruturada:
- Nome da empresa e categoria setorial
- Morada e coordenadas GPS
- Número de telefone e URL do site
- Horários de funcionamento e avaliações
- Fotografias e descrições
Precisamente para as PME do espaço DACH, a cobertura é excelente: praticamente todos os negócios com presença física estão listados — do fabricante de máquinas ao escritório de consultoria fiscal. Importante: a utilização através da API oficial distingue-se fundamentalmente do scraping da interface do Maps, que viola os termos de utilização da Google. Mais sobre isto no artigo scraping do Google Maps — o que é legal na Alemanha.
Passo 1: Como configurar o projeto Google Cloud?
Para a Places API precisa de um projeto Google Cloud com conta de faturação associada — mesmo que use apenas a quota gratuita, a Google exige um método de pagamento registado. A configuração demora cerca de 15 minutos:
- Vá a console.cloud.google.com e inicie sessão com uma conta Google
- Crie um novo projeto através do seletor de projetos no canto superior esquerdo, por exemplo com o nome "lead-generation"
- Configure em Faturação uma conta de faturação com método de pagamento e associe-a ao projeto
- Opcionalmente, crie em Orçamentos e alertas um orçamento com limiar de alarme — assim recebe um e-mail antes de surgirem custos
O alarme de orçamento não é um limite de custos, mas apenas uma notificação — quem quer um teto rígido reduz adicionalmente a quota de pedidos da API na consola.
Passo 2: Como ativar e proteger a Places API?
A Places API (New) é a geração atual da interface e a escolha certa para novos projetos — a Places API clássica é considerada legacy. Ativação e proteção em quatro passos:
- Abra APIs & Services → Library, procure por "Places API (New)" e clique em Ativar
- Crie em APIs & Services → Credentials uma nova chave de API
- Restrinja a chave, em API restrictions, à Places API (New) — assim, uma chave divulgada não pode usar outros serviços Google por sua conta
- Defina em Application restrictions uma restrição de IP para o seu servidor, se as consultas correrem a partir de infraestrutura fixa
Trate a chave como uma palavra-passe: não a inclua em repositórios de código; guarde-a como variável de ambiente.
Text Search ou Nearby Search — que método se adequa a listas de leads?
Para a geração de leads, o Text Search é quase sempre a escolha certa, porque entende termos de pesquisa livres como "consultoria fiscal Berlim"; o Nearby Search, pelo contrário, encontra locais de um determinado tipo num raio em torno de coordenadas. As diferenças em resumo:
- Text Search: aceita pedidos em linguagem natural compostos por setor mais região ("empresa de software Munique", "engenharia mecânica PME Suábia"). Por pedido são devolvidos até 20 resultados, com o token de página seguinte (nextPageToken) até 60 no total — segundo a documentação oficial do Text Search, o limite são 60 resultados
- Nearby Search: espera um ponto central (coordenadas), um raio e tipos de local como "electrician" ou "lawyer". Forte quando você quer varrer sistematicamente uma área, por exemplo todos os negócios de artesanato num raio de 20 quilómetros em torno de uma cidade
Na prática, combina os dois: Text Search para a construção de listas por setor, Nearby Search para cobrir por completo, em mosaicos, regiões densas quando o limite de 60 resultados do Text Search se torna restritivo. Além disso, no Text Search contorna o limite de 60 dividindo uma região em vários pedidos mais específicos — em vez de "prestadores de serviços de TI Baviera", use "prestadores de serviços de TI Nuremberga", "prestadores de serviços de TI Augsburgo" e assim por diante.
Quanto custa a Google Places API? (à data de julho de 2026)
A Google Places API tem, desde 1 de março de 2025, um novo modelo de preços: o antigo crédito mensal de 200 dólares foi eliminado e substituído por quotas mensais gratuitas por categoria de SKU — 10.000 chamadas para consultas Essentials, 5.000 para Pro e 1.000 para Enterprise, como a Google documenta nas FAQ oficiais de faturação. A categoria faturada é determinada pelos campos que você solicita em cada pedido:
| Categoria de SKU | Quota gratuita por mês | Campos típicos | Preço Text Search (após quota gratuita) |
|---|---|---|---|
| Essentials (IDs Only) | 10.000 chamadas | Apenas Place IDs | 32 dólares por 1.000 chamadas |
| Pro | 5.000 chamadas | Nome, morada, categoria, coordenadas | 32 dólares por 1.000 chamadas |
| Enterprise | 1.000 chamadas | Adicionalmente site, número de telefone, horários, avaliação | 35 dólares por 1.000 chamadas |
| Enterprise + Atmosphere | 1.000 chamadas | Adicionalmente textos de avaliações e características do local | Nível mais alto, desnecessário para listas de leads |
Para listas de leads, você precisa de site e número de telefone — ou seja, do nível Enterprise. A conta fica assim: 1.000 chamadas Enterprise gratuitas por mês vezes até 20 resultados por chamada dão até 20.000 registos de empresas por mês gratuitamente. Depois disso, 1.000 chamadas adicionais (até 20.000 empresas adicionais) custam 35 dólares. Os preços exatos, incluindo descontos por volume, constam da lista de preços oficial da Google; artigos de blog mais antigos que ainda calculam com o crédito de 200 dólares estão ultrapassados desde março de 2025.
Como é que as field masks reduzem os seus custos de API?
Uma field mask (FieldMask) é a lista de campos de resposta que você solicita por pedido — e é ela que decide o preço: a Google fatura cada pedido na categoria de SKU mais alta da qual você solicite mesmo que seja um único campo. Quem, por descuido, inclui um campo Atmosphere como as avaliações paga a tarifa máxima pelo pedido inteiro.
Para uma pesquisa de leads eficiente em custos, vale por isso:
- Solicite apenas o que realmente precisa — para listas de leads, tipicamente: places.displayName, places.formattedAddress, places.nationalPhoneNumber, places.websiteUri, places.types
- Dispense os campos de avaliações e reviews se não os analisar — eles elevam o pedido à categoria mais cara
- Separe casos de uso: para meras análises de área basta o nível Pro, sem site e telefone, com a quota gratuita maior de 5.000
A field mask é passada como cabeçalho HTTP X-Goog-FieldMask, com os caminhos de campo separados por vírgulas. Sem field mask, a Places API (New) não responde a pedido nenhum — o que, de forma sensata, o obriga a responder à questão dos custos antes da primeira consulta.
Como formular pesquisas de forma estratégica?
A qualidade dos seus leads depende diretamente da qualidade das suas pesquisas — a API só encontra aquilo que você pergunta. Quatro estratégias comprovadas:
- Setor + cidade: "prestadores de serviços de TI Frankfurt" — o padrão para a construção de listas
- Setor + região: "engenharia mecânica Baviera" — mais abrangente, mas limitada pelo teto de 60 resultados; melhor dividir por cidades
- Orientada ao problema: "consultoria fiscal PME" — encontra fornecedores que se posicionam assim
- Específica de nicho: "agência de e-commerce Düsseldorf" — menos resultados, mas taxa de acerto mais alta na qualificação
Com um modelo de linguagem como o Claude, você pode gerar automaticamente dezenas de variantes de pesquisa a partir da descrição do seu produto — diferentes sinónimos, designações setoriais e combinações de locais que manualmente nunca escreveria por completo. É exatamente assim que a anilead.io trabalha: da sua descrição de cliente-alvo nascem automaticamente 8 a 12 pesquisas por execução.
Como chegar do site ao endereço de e-mail?
A Places API fornece o URL do site, mas nenhum endereço de e-mail — o enriquecimento é o segundo passo da pipeline. Um web crawler trata disso automaticamente:
- Visite programaticamente cada site encontrado
- Verifique as páginas típicas /kontakt, /impressum e /ueber-uns à procura de padrões de e-mail — a obrigação de Impressum (aviso legal obrigatório nos sites alemães) garante que quase todos os sites profissionais na Alemanha indicam um endereço
- Distinga endereços genéricos (info@, kontakt@) de endereços pessoais e priorize os últimos
- Valide tecnicamente os endereços antes de entrarem no CRM
Nota jurídica: um endereço de e-mail extraído não é uma autorização para e-mails publicitários. Segundo o § 7, n.º 2, da UWG (lei alemã contra a concorrência desleal), a publicidade por e-mail exige, por princípio, consentimento, também no B2B — planeie por isso o primeiro contacto por telefone (com consentimento presumido), carta ou LinkedIn e obtenha aí o consentimento para e-mail. Este artigo não substitui aconselhamento jurídico.
É permitido usar a Places API para geração de leads?
A Places API é o caminho oficialmente previsto pela Google para usar dados do Maps de forma programática — ao contrário do scraping da interface do Maps, que viola os termos de utilização. Ainda assim, você tem de respeitar dois níveis: as regras da plataforma Google (por exemplo, requisitos de armazenamento e atribuição de conteúdos, sendo que os Place IDs podem ser guardados permanentemente) e o direito alemão na utilização subsequente dos dados. Como se trata de dados comerciais publicamente visíveis, o tratamento pode apoiar-se num interesse legítimo (art. 6.º, n.º 1, alínea f) do RGPD, o regulamento europeu de proteção de dados), desde que você documente a ponderação de interesses e implemente os direitos dos titulares. Encontra o enquadramento detalhado, incluindo a distinção face ao scraping, no artigo scraping do Google Maps — o que é legal na Alemanha.
Conclusão: a pipeline completa
O Google Places fornece os dados de empresas, o crawler de sites os endereços de e-mail, o scoring por IA a priorização, e a exportação leva tudo para o CRM — estes quatro passos formam uma pipeline de leads completa, cujos dados brutos, dentro da quota gratuita da API, não lhe custam um cêntimo. O guia de automação de vendas B2B explica como todo o stack de automação encaixa; o artigo gerar leads B2B gratuitamente mostra que outras fontes de dados gratuitas valem a pena como complemento.
Para quem não quer construir a pipeline por conta própria: a anilead.io é um software de geração de leads B2B para o mercado DACH que encontra empresas através do Google Places, extrai endereços de e-mail e avalia cada lead com Claude AI. Não é necessária uma chave própria da API da Google — a pesquisa corre na infraestrutura da anilead.io e o tratamento de dados em servidores da UE em Frankfurt. O plano Free inclui 50 créditos de leads por mês, sem cartão de crédito.
Perguntas frequentes sobre a Google Places API para geração de leads
O crédito de 200 dólares da Google Maps Platform ainda existe?
Não. A Google eliminou o crédito mensal de 200 dólares a 1 de março de 2025 e substituiu-o por quotas mensais gratuitas por categoria de SKU: 10.000 chamadas para consultas Essentials, 5.000 para Pro e 1.000 para Enterprise (à data de julho de 2026). Para consultas de leads com site e número de telefone vale a quota Enterprise de 1.000 chamadas por mês.
Quantos leads recebo dentro da quota gratuita?
Até 20.000 registos de empresas por mês: 1.000 chamadas Enterprise gratuitas vezes até 20 resultados por pedido de Text Search. Se dispensar site e número de telefone, aplica-se a quota Pro com 5.000 chamadas — até 100.000 registos de base. O gargalo prático raramente é a API, mas sim a capacidade de qualificação e abordagem.
Preciso de conhecimentos de programação para a Places API?
Para a utilização direta, sim — precisa de um projeto na cloud, de uma chave de API e de um script que faça pedidos e processe respostas; com conhecimentos básicos de Python ou JavaScript, isso resolve-se numa tarde. Sem programação, use uma ferramenta como a anilead.io, que traz pesquisa Places, extração de e-mails e scoring por IA já montados e não exige chave de API própria.
A Places API também fornece endereços de e-mail?
Não, os endereços de e-mail não são um campo da Places API — ela fornece, entre outros, nome, morada, número de telefone e URL do site. O endereço de e-mail obtém-se num segundo passo, quando um crawler visita o site da empresa e analisa as páginas de contacto e de Impressum. Tenha em conta, para a abordagem, o § 7 da UWG: os e-mails publicitários pressupõem, por princípio, um consentimento.
