Como Ativar a API de Resultados Próximos do Google
Introdução
Este guia fornece um passo a passo completo para configurar a API do Google Resultados Próximos em seu site eDirectory.
O recurso de resultados próximos permite que os visitantes pesquisem anúncios com base em sua localização geográfica atual, exibindo os estabelecimentos mais próximos. Para utilizar esse recurso, será necessário criar uma Chave de API do Servidor em seu projeto do Google Cloud e configurá-la na área administrativa do eDirectory.
Importante: A Chave de API Resultados Próximos do Google é diferente da Chave de API do Google Maps utilizada para exibir mapas. Embora ambas possam pertencer ao mesmo projeto do Google Cloud, elas possuem restrições de segurança diferentes e são configuradas separadamente.
Instruções para integrar a API de Resultados Próximos do Google
Etapa 1: Criar um projeto no Google Cloud Platform
Observação: Se você já criou um projeto no Google Cloud ao configurar o Google Maps, poderá utilizar o mesmo projeto e pular para a Etapa 2: Ativar as APIs necessárias.
1.1. Certifique-se de estar conectado à sua Conta Google e acesse o Google Cloud Platform API Console.
1.2. Clique em Selecionar um projeto na parte superior da página e escolha Novo projeto.

1.3. Preencha as informações do projeto:
- Nome do projeto: informe um nome descritivo (por exemplo, o nome do seu site).
- Organização: caso aplicável, selecione sua organização.
- Em seguida, clique em Criar.

1.4. Selecione o projeto recém-criado.

Etapa 2: Ativar as APIs necessárias
2.1. Clique em Biblioteca.

2.2. Pesquise por "Geocoding".

2.3. Abra individualmente as APIs:
- Geocoding API
- Maps JavaScript API

2.4. Clique em Ativar em ambas.


Importante: Provavelmente, após clicar em "Ativar", o Google solicitará que você vincule seu projeto a uma conta de cobrança. Este é um passo necessário para exibir os mapas em seu site eDirectory. Por favor, configure sua cobrança após ativar as APIs mencionadas acima.

Siga as instruções na tela para vincular uma conta de cobrança ao seu projeto do Google Maps. Por favor, note que este passo é essencial para exibir o mapa no site. O Google não permitirá a exibição dos mapas no site, a menos que uma conta de cobrança esteja configurada, uma vez que eles cobram pelo uso de sua API.
Verifique este artigo do Google para saber mais sobre como eles cobram pela sua API: Faturamento da Plataforma Google Maps
Etapa 3: Criar a Chave de API do Servidor dos Resultados Próximos
3.1. Clique no botão de menu.

3.2. Navegue até "APIs & Serviços" e selecione "Credenciais"

3.3. Clique em "+ Criar credenciais" e selecione "Chave de API."

3.4. No painel exibido à direita, defina o nome da chave de API como "Resultados Próximos" e, em seguida, clique no menu suspenso "Selecionar restrições da API".

3.5. Selecione as duas APIs que você habilitou no Passo 2.4: Maps JavaScript API e Geocoding API.

Observação: Caso essas APIs não apareçam na lista, volte à Etapa 2.4 e confirme que elas foram ativadas.

3.6. Após inserir um nome e selecionar as APIs no painel à direita, role a página para baixo até a seção "Restrições de aplicativo", selecione "Endereços IP" e clique em "Adicionar".

3.7. Adicione o endereço IP do seu servidor e clique em Criar.

Importante para usuários de Hospedagem Compartilhada
Caso seu site esteja hospedado em um dos nossos servidores compartilhados, utilize exatamente os seguintes endereços IP:
- 52.52.23.74
- 54.233.157.59
Importante para usuários com servidor próprio ou dedicado
Caso seu site esteja hospedado em um servidor próprio ou dedicado e você não saiba qual é o endereço IP do servidor, entre em contato com nossa equipe de suporte pelo e-mail:
support@edirectory.com. Nossa equipe ajudará você a identificar os IPs corretos.
3.8. Após clicar em Criar, sua Chave de API será exibida. Clique no ícone de copiar para copiá-la para a área de transferência.

Etapa 4: Integrar a API ao eDirectory
4.1. Na área administrativa do seu site, acesse: Configurações → Idioma & Localidades → Identificação De Localização Do Visitante & Resultados Próximos.
4.2. Ative as opções:
- Ativar Identificação De Localização Do Visitante
- Ativar Resultados Próximos
4.3. Cole a chave de API criada anteriormente no campo Google Api Key (Chave Do Servidor)

4.3. Clique em Salvar Alterações.
Vincular o projeto a uma conta de faturamento
O recurso Resultados Próximos exige que o faturamento no Google Cloud Platform esteja habilitado.
Caso você ainda não tenha configurado o faturamento do seu projeto Google Cloud, siga as instruções do artigo: Como habilitar o Billing para Google Maps e Nearby Results.
Sem o faturamento habilitado, o recurso de Resultados Próximos não funcionará corretamente.
Qual é a diferença entre a APIdo Google Maps e a API dos Resultados Próximos?
Embora ambas possam ser criadas dentro do mesmo projeto do Google Cloud, elas possuem finalidades diferentes.
| Google Maps | Resultados Próximos |
|---|---|
| Utilizada para exibir mapas em todo o site. | Utilizada para localizar anúncios próximos da localização do visitante. |
| Utiliza restrições por domínio. | Utiliza restrições por endereço IP. |
| Configurada em Configurações→ Integrações com Google → Google Maps. | Configurada em Configurações → Idioma & Localidades → Identificação De Localização Do Visitante & Resultados Próximos. |
Quer integrar o Google Maps ao seu site eDirectory? Consulte nosso guia:
Como verificar se a função de Resultados Próximos está funcionando?
Após configurar a API:
- Ative o recurso Identificação De Localização Do Visitante e Resultados Próximos na área administrativa.

- Acesse seu site.
- Permita que o navegador compartilhe sua localização quando solicitado.
- Faça uma pesquisa por anúncios.
- Altere o filtro de pesquisa para Distância.

Se tudo estiver configurado corretamente, os resultados serão exibidos em ordem de proximidade da localização atual do visitante.
Caso o recurso não esteja funcionando, verifique se:
- O faturamento do Google Maps está habilitado.
- A chave de API utiliza restrições por endereço IP.
- Os endereços IP corretos do servidor foram adicionados.
- A chave de API foi inserida no campo correto dentro do área administrativa.
Conclusão
Ao configurar corretamente a API do Google Resultados Próximos, seus visitantes poderão encontrar anúncios próximos à sua localização atual, proporcionando uma experiência de pesquisa muito mais personalizada.
Para isso, basta:
- Criar uma Chave de API com restrições por endereço IP;
- Ativar as APIs necessárias do Google;
- Configurar o faturamento do Google Cloud;
- Integrar a chave na área administrativa do eDirectory.
Caso tenha qualquer dúvida ou precise de ajuda durante a configuração, entre em contato com nossa equipe de suporte pelo e-mail support@edirectory.com.