Chave API do Google Places

Passo a passo completo para conseguir sua chave
Voltar ao app

O Raspador do Eneven Prospect busca negócios diretamente no Google Maps usando a API do Google Places. Para isso você precisa de uma chave de acesso (uma senha alfanumérica que começa com AIzaSy...).

A chave é gratuita para uso normal: o Google oferece USD 200 de credito por mes, o que cobre em torno de 100 mil buscas mensais sem custo nenhum.

O Google exige cadastro de cartao de credito, mas nao cobra nada enquanto o uso ficar dentro do limite gratuito.

100% gratuito para uso normal
Antes de comecar: voce precisa de uma conta Google (Gmail)
Ja tenho Gmail. Posso usar essa mesma conta?

Sim. Use a sua conta Gmail normalmente. Pode ser conta pessoal, profissional ou qualquer conta Google que voce ja tenha. Pule esta etapa e va direto para o Passo 1 abaixo.

Nao tenho Gmail. Como crio uma conta Google?

Acesse o link abaixo para criar sua conta Google:

https://accounts.google.com/signup

No celular (mobile):

  1. Abra o link acima no navegador do celular
  2. Preencha: Nome, Sobrenome
  3. Escolha um nome de usuario (ex.: seunome2025) e clique em Proximo
  4. Crie uma senha forte (minimo 8 caracteres, com letras e numeros)
  5. Informe um numero de celular para verificacao e clique em Proximo
  6. Digite o codigo de 6 digitos que o Google enviou por SMS
  7. Aceite os termos e pronto. Sua conta esta criada

No computador (desktop): o processo e identico, apenas com a tela maior e mais facil de visualizar.

[ Print: tela de criacao de conta Google ]

Com a conta criada, va para o Passo 1 abaixo.

Passo a passo para obter a chave API
1Acessar o Google Cloud Console

O Google Cloud Console e o painel onde voce cria e gerencia as credenciais de API. Acesse o link abaixo e faca login com sua conta Google:

https://console.cloud.google.com/

Na primeira vez, o Google pode pedir para aceitar os termos de servico. Aceite e continue.

[ Print: tela inicial do Google Cloud Console ]
2Criar um projeto

Toda credencial precisa estar dentro de um projeto. Siga os passos:

  1. No canto superior esquerdo, ao lado do logo "Google Cloud", clique em Selecionar projeto
  2. Na janela que abrir, clique em Novo projeto (canto superior direito da janela)
  3. No campo Nome do projeto, escreva algo como Eneven Prospect
  4. Clique em Criar
  5. Aguarde alguns segundos. Quando o projeto estiver pronto, clique nele para selecioná-lo

Certifique-se de que o nome do projeto aparece no seletor no topo da pagina antes de continuar.

[ Print: criacao de novo projeto ]
3Ativar a Places API (New)

Agora e preciso ativar a API especifica para busca de lugares. Acesse diretamente pelo link abaixo ou siga o caminho manual:

https://console.cloud.google.com/apis/library

Caminho manual: No menu lateral esquerdo, clique em APIs e servicos e depois em Biblioteca.

  1. Na caixa de busca, digite: Places API
  2. Nos resultados, clique em Places API (New) (esta e a versao atual, de 2024/2025)
  3. Clique no botao azul Ativar
  4. Aguarde alguns segundos ate a pagina confirmar que a API foi ativada
[ Print: ativacao da Places API (New) ]
4Configurar o faturamento (obrigatorio para liberar a API)
Por que o Google pede cartao? O Google exige um metodo de pagamento para identificar que voce e uma pessoa real e nao um robo. O uso basico e gratuito. Voce so seria cobrado se ultrapassar USD 200 de uso por mes, o que equivale a mais de 100 mil buscas.

Acesse a pagina de faturamento:

https://console.cloud.google.com/billing

  1. Clique em Criar conta de faturamento (ou Vincular conta de faturamento se ja aparecer uma opção)
  2. Preencha seu nome, endereco e dados do cartao (Visa, Mastercard ou debito)
  3. Clique em Enviar e ativar o faturamento gratuito (ou botao equivalente)
  4. O Google pode fazer uma cobranca temporaria de R$ 1,00 para validar o cartao. Esse valor e estornado em alguns dias

Cartoes de debito Visa e Mastercard sao aceitos na maioria dos casos. Cartoes pre-pagos geralmente nao funcionam.

[ Print: tela de configuracao de faturamento ]
5Criar a chave de API (Credencial)

Agora voce vai gerar a chave que sera colada no Eneven Prospect. Acesse:

https://console.cloud.google.com/apis/credentials

Caminho manual: Menu lateral esquerdo, clique em APIs e servicos e depois em Credenciais.

  1. Clique em + Criar credenciais (botao no topo da pagina)
  2. Selecione Chave de API
  3. Uma janela vai aparecer mostrando a sua chave. Ela tem o formato AIzaSy...
  4. Clique em Copiar (icone de copiar ao lado da chave) e guarde em algum lugar seguro
  5. Clique em Fechar
[ Print: chave de API gerada ]
6Restringir a chave (recomendado)

Restringir a chave e uma medida de seguranca para que ela so funcione com a Places API. Se alguem descobrir sua chave, nao conseguira usar em outros servicos.

  1. Na lista de credenciais, clique no nome da chave que voce acabou de criar
  2. Role ate a secao Restricoes de API
  3. Selecione Restringir chave
  4. No campo que aparece, escolha Places API (New)
  5. Clique em Salvar
[ Print: tela de restricao da chave ]
7Colar a chave no Eneven Prospect
  1. Abra o Eneven Prospect no celular ou computador
  2. Toque no menu Raspador (icone de lupa na barra inferior)
  3. No campo "Sua chave da API do Google Places", cole a chave copiada no Passo 5
  4. Clique em Testar e Salvar
  5. Se aparecer a mensagem "Chave salva e funcionando", esta tudo certo
[ Print: campo da chave no Eneven Prospect ]
8Primeiro teste
  1. Ainda na tela do Raspador, no campo "O que voce quer pesquisar?", escreva: restaurante em Sao Paulo, SP
  2. Deixe a quantidade de paginas em 1 (para o teste ser rapido)
  3. Clique em Pesquisar negocios
  4. Em alguns segundos, os resultados devem aparecer na tela com nome, telefone, site e endereco
[ Print: resultados da primeira busca ]

Se nao aparecer nada ou der erro: veja as solucoes abaixo na secao de perguntas frequentes.

Duvidas frequentes e erros comuns
Vou ser cobrado? Quanto custa por mes?

Para o uso normal do Raspador, nao. O Google oferece USD 200 de credito gratuito por mes. Cada pagina de resultados (20 lugares) custa cerca de USD 0,04. Isso significa que voce pode buscar ate 100 mil negocios por mes de graca.

Se ultrapassar esse limite (o que exige um volume de uso muito grande), o Google começa a cobrar automaticamente. Voce pode configurar alertas de orcamento no proprio Console para nao ser surpreendido.

O Google aceita cartao de debito?

Sim. Cartoes de debito das bandeiras Visa e Mastercard sao aceitos na maioria dos casos. Cartoes pre-pagos (como os descartaveis de bancos digitais) geralmente nao funcionam. Se o seu cartao de debito nao for aceito, use um cartao de credito.

Apareceu o erro REQUEST_DENIED. O que faco?

Esse erro significa que a chave existe mas nao esta autorizada a usar a Places API. Verifique os dois pontos abaixo:

  1. A Places API (New) foi ativada? Acesse console.cloud.google.com/apis/library, busque "Places API" e confirme que aparece como "Ativada".
  2. O faturamento esta vinculado? Sem faturamento, a API nao funciona mesmo com a chave ativa. Acesse console.cloud.google.com/billing e verifique se tem uma conta de faturamento vinculada ao projeto.

Apos corrigir, pode levar ate 5 minutos para a mudanca fazer efeito.

A busca retornou 0 resultados. O que pode ser?

Algumas causas comuns:

  • Cidade escrita errada: escreva de forma clara, como "dentista em Curitiba, PR". Incluir o estado ajuda muito.
  • Nicho muito especifico: tente termos mais simples. Em vez de "micropigmentacao de sobrancelha", use "estetica".
  • Chave com restricao excessiva: se voce restringiu a chave por IP ou HTTP referrer, isso pode bloquear o Raspador. Remova as restricoes de site/IP e mantenha apenas a restricao por API (Places API).
Perdi minha chave. Como recupero?

Acesse console.cloud.google.com/apis/credentials, clique no nome da chave que voce criou e copie o valor mostrado na pagina. Se preferir, crie uma nova chave clicando em + Criar credenciais e repita os passos 5 e 6 deste guia.

Posso usar a mesma chave em varios dispositivos?

Sim. A chave e vinculada ao seu projeto no Google Cloud, nao ao dispositivo. Voce pode usar a mesma chave no celular, no tablet e no computador. O consumo do credito gratuito e somado entre todos os usos.

Como configuro um alerta para nao ser cobrado?

Acesse console.cloud.google.com/billing, clique na sua conta de faturamento e depois em Orcamentos e alertas. Configure um orcamento de USD 1 (um dolar) com alerta em 90%. Assim voce recebe um e-mail se o uso se aproximar do limite gratuito.

Ainda com duvidas sobre a chave API?
Fale diretamente com o suporte.

Falar com o Suporte