Google Places do zero: projeto, faturamento, chave restrita e teto de gasto

Para que serve no AFK

• Ver a reputação no mapa: nota, quantidade de avaliações, categoria, endereço, telefone, site, horário de hoje e link do mapa de uma empresa. Pode ser a sua, a de um cliente ou a de um concorrente.
• Ler o que falta no perfil: sem site, sem telefone, sem horário, menos de 10 avaliações, nota abaixo de 4,0 ou perfil marcado como fechado.
• Acompanhar ao longo do tempo: o AFK guarda cada consulta. Na seguinte, mostra quantas avaliações entraram e quanto a nota mexeu. Com uma lista de empresas vigiadas, ele compara todas por nota.
• Completar o raio-x e a proposta: a consulta entra no departamento Reputação do raio-x de um prospect.

A API não devolve o texto das avaliações nem as respostas do dono. A busca de empresas por região, para prospecção, roda no OpenStreetMap, grátis e sem chave.

Antes: grátis ou pago

Uma consulta do AFK é um pedido ao Google. Acompanhar 20 empresas toda semana dá cerca de 90 consultas por mês, dentro do grátis. Varrer uma cidade inteira passa disso rápido. O preço pode mudar: confira em mapsplatform.google.com/pricing e na tabela de preços para desenvolvedores.

Parte 1: conta Google e verificação em duas etapas

1. Use uma conta Google do negócio. Pode ser o Gmail que você já usa no Google Agenda ou no Google AI Studio.
2. Ligue a verificação em duas etapas: abra myaccount.google.com, clique em Segurança e login e, em Como você faz login no Google, clique em Ativar a verificação em duas etapas. Siga as etapas da tela.

Essa conta vai ter um cartão cadastrado. Quem entra nela gasta o seu dinheiro.

Parte 2: criar o projeto e ativar o faturamento

O console do Google Cloud pode aparecer em português ou em inglês. Os nomes abaixo trazem o inglês entre parênteses.

1. Abra console.cloud.google.com/projectcreate. Em Nome do projeto, digite afk e clique em Criar (Create).
2. Abra console.cloud.google.com/billing e clique em Criar conta (Create account).
   • Dê um nome, escolha o país Brasil e clique em Continuar (Continue).
   • Crie o perfil de pagamentos com o cartão. O Google pode fazer uma reserva de até US$ 1 para conferir o cartão. Não é cobrança, e ela some em alguns dias.
   • Clique em Enviar e ativar faturamento (Submit and enable billing).
3. Confira se o projeto afk está ligado a essa conta: no topo do console, escolha o projeto afk e abra Faturamento (Billing) no menu. Se aparecer que o projeto não tem conta de faturamento, clique em Vincular uma conta de faturamento (Link a billing account), escolha a conta e confirme.

Parte 3: ativar a Places API (New)

1. Com o projeto afk escolhido no topo, abra console.cloud.google.com/apis/library/places.googleapis.com.
2. Confira se o nome na página é Places API (New) e clique em Ativar (Enable).

A Places API sem o "(New)" é a versão Legacy. Ela não liga em projeto novo, e o AFK não usa.

Parte 4: criar a chave e restringir

1. Abra console.cloud.google.com/apis/credentials, com o projeto afk no topo.
2. Clique em Criar credenciais (Create credentials) e depois em Chave de API (API key).
3. Em Restrições de API (API restrictions), marque Restringir chave (Restrict key) e deixe só Places API (New) na lista. O console exige pelo menos uma API na restrição.
4. Em Restrições do aplicativo (Application restrictions):
   • AFK no seu computador: deixe Nenhum (None). A internet de casa muda de IP, e a restrição por IP derrubaria a chave.
   • AFK numa VPS com IP fixo: escolha Endereços IP (IP addresses) e cadastre o IP da VPS. É a restrição que o Google recomenda para servidor.
   • Não use Sites (Websites, por referenciador): a consulta do AFK não sai de um site.
5. Clique em Criar (Create) ou Salvar (Save) e copie a chave. Ela começa com AIza. Para ver de novo depois, abra a chave na mesma página e clique em Mostrar chave (Show key).

O Google avisa: você responde pela cobrança de uma chave sem restrição usada por outra pessoa.

Parte 5: pôr orçamento, alerta e cota por dia

Faça esta parte antes da primeira consulta.

1. Orçamento com alerta: abra console.cloud.google.com/billing/budgets, ou Faturamento → Orçamentos e alertas (Budgets & alerts), e clique em Criar orçamento (Create budget).
   • Nome: afk-places.
   • Escopo (Scope): o projeto afk.
   • Valor (Amount): um valor pequeno, por exemplo o equivalente a US$ 5.
   • Ações (Actions): os alertas já vêm em 50%, 90% e 100%. O e-mail vai para quem administra a conta de faturamento.
   • Clique em Concluir (Finish).
2. Cota por dia (o teto de verdade): abra Google Maps Platform → Cotas (Quotas) e escolha Places API (New). Marque a cota de busca por texto (Text Search), clique em Editar (Edit), digite o limite e envie.
   • Para ficar no grátis da faixa Enterprise, o Google ensina: 1.000 dividido por 31 dá 32 por dia.
   • Se a lista só mostrar limite por minuto, baixe esse limite e conte com o alerta do orçamento.
   • O limite vira à meia-noite do horário do Pacífico, entre 4h e 5h da manhã no horário de Brasília.

Parte 6: colar no AFK

1. No painel do AFK, abra Conexões, clique no cartão Google Places, cole em Chave do Google Places e clique em Salvar conexão.
2. Esse cartão não tem o botão Testar. Para conferir, peça ao AFK: "como está a nota da minha empresa no Google?". Se vier a nota, a chave funciona.

No dia a dia

Erros e soluções

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande a chave.

Para entender as chaves em geral, veja O que é chave, quais eu preciso e onde colar. A chave do Gemini também sai de um projeto Google, mas é outra chave: veja Chave do Gemini no Google AI Studio (tem camada grátis).

Fontes oficiais (conferido em 30/10/2026): developers.google.com/maps/billing-and-pricing/pricing (Text Search Enterprise: 1.000 grátis por mês e US$ 35 por 1.000 na primeira faixa; Text Search Pro: 5.000 grátis e US$ 32) · developers.google.com/maps/documentation/places/web-service/text-search (nota, avaliações, telefone, site e horário puxam a faixa Enterprise) · developers.google.com/maps/get-started (projeto com faturamento é obrigatório; crédito de boas-vindas de US$ 300) · docs.cloud.google.com/free/docs/free-cloud-features (cartão obrigatório; reserva de até US$ 1; sem cobrança automática no fim do teste de 90 dias) · docs.cloud.google.com/billing/docs/how-to/create-billing-account (criar a conta de faturamento) · developers.google.com/maps/documentation/places/web-service/get-api-key (criar a chave; restrição de API obrigatória; responsabilidade pela chave sem restrição) · developers.google.com/maps/api-security-best-practices (restrição por IP para servidor; IP dinâmico atrapalha) · developers.google.com/maps/billing-and-pricing/manage-costs (orçamento não limita o gasto; cota por dia limita; 1.000 ÷ 31 = 32; virada à meia-noite do Pacífico) · docs.cloud.google.com/billing/docs/how-to/budgets (Orçamentos e alertas; alertas em 50%, 90% e 100%) · developers.google.com/maps/documentation/places/web-service/usage-and-billing (Google Maps Platform → Cotas → Editar) · developers.google.com/maps/documentation/places/web-service/legacy/overview-legacy (Places API Legacy não ativa em projeto novo) · developers.google.com/maps/documentation/places/web-service/faq (causas de REQUEST_DENIED) · support.google.com/accounts/answer/185839 (verificação em duas etapas).