Como Ativar a API de Resultados Próximos do Google
Introdução
Este artigo fornece um guia abrangente, passo a passo, sobre como configurar a API de Resultados Próximos do Google para o seu site eDirectory. Integrar essa API essencial garante que seus usuários vejam listagens geograficamente relevantes para sua localização atual diretamente na página de resultados de busca, melhorando significativamente sua experiência de busca local. Siga estas instruções cuidadosamente para habilitar essa funcionalidade.
Instruções para Configurar a API de Resultados Próximos:
- Criando um Projeto no Console da API do Google Cloud Platform:
- 1.1. Enquanto estiver logado na sua Conta do Google, navegue até o Console da API do Google Cloud Platform: https://console.cloud.google.com/apis/dashboard
- 1.2. Clique no dropdown "Selecionar um projeto" na parte superior e então selecione "Novo projeto."
- 1.3. Na caixa de diálogo "Novo projeto", insira as seguintes informações:
- Nome do projeto: Digite um nome descritivo para seu projeto, idealmente relacionado ao seu site (por exemplo, "Meu Site eDirectory").
- Organização: Se você tiver uma Organização do Google Cloud configurada, selecione-a no dropdown. Caso contrário, este campo pode ser opcional.
- Localização: Escolha a localização do projeto do Google Cloud que está geograficamente mais próxima de você ou da sua base de usuários principal.
- Depois de preencher as informações necessárias, clique no botão "Criar".
- Ativando as APIs de Geocodificação e Maps JavaScript:
- 2.1. Após seu projeto ser criado, clique no botão de menu (três linhas horizontais) no canto superior esquerdo. Navegue até "APIs e Serviços" e então clique em "Biblioteca."
- 2.2. Na página da Biblioteca de APIs, role para baixo ou use a barra de pesquisa para encontrar a categoria "Maps" e clique nela.
- 2.3. Dentro da categoria "Maps", localize e clique em "API de Geocodificação" e "API JavaScript do Maps." Você também pode usar a barra de pesquisa na parte superior da página da Biblioteca para encontrá-las diretamente.
- 2.4. Nas páginas individuais tanto da "API de Geocodificação" quanto da "API JavaScript do Maps," clique no botão "Habilitar."
Nota: Após clicar em "Ativar" para qualquer uma das APIs, o Google provavelmente solicitará que você vincule seu projeto a uma conta de faturamento. Este é um passo obrigatório para exibir mapas e utilizar serviços baseados em localização em seu site eDirectory. Por favor, siga as instruções na tela para configurar suas informações de faturamento após ativar as APIs. A política do Google requer uma conta de faturamento vinculada para o uso da API, e os mapas não serão exibidos sem isso. Para informações mais detalhadas sobre faturamento da Google Maps Platform, consulte este artigo oficial do Google: https://developers.google.com/maps/billing-and-pricing/billing
- Criando a Chave da API de Resultados Próximos:
- 3.1. Clique no botão de menu novamente, navegue até "APIs e Serviços" e depois selecione "APIs e serviços habilitados."
- 3.2. Na página "APIs e serviços habilitados", clique em "Credenciais" no menu à esquerda. Depois, clique em "Criar credenciais" na parte superior e selecione "chave da API" no menu suspenso.
- 3.3. Na janela pop-up exibindo sua nova chave da API, clique em "Editar chave da API" para configurar suas restrições.
- 3.4. Na página de configuração da chave da API, preencha as seguintes informações obrigatórias:
- 1. Nome: Você pode dar um nome descritivo à sua chave da API, como "Chave da API de Resultados Próximos."
- 2. Restrições de aplicação: Selecione a opção "Endereços IP (servidores web, cron jobs, etc.)"
Nota Importante para Usuários de Hospedagem Compartilhada: Se o seu site estiver hospedado em um de nossos servidores compartilhados, por favor insira os seguintes endereços IP exatamente como listados:
52.52.23.74
52.9.39.107
54.233.157.59
Nota Importante para Usuários de Servidores Dedicados ou Auto-Hospedados: Se o seu site é auto-hospedado ou está em um servidor dedicado e você não tem certeza dos endereços IP do seu servidor, entre em contato com nossa equipe de suporte pelo support@edirectory.com para obter assistência na identificação dos endereços IP corretos a serem adicionados aqui.
- 3. Restrições da API: Ative a opção "Restringir chave". Em seguida, na lista de APIs disponíveis, selecione tanto a "API de Geocodificação" quanto a "API JavaScript de Mapas" (as mesmas APIs que você ativou na etapa 2.4). Após selecionar ambas, clique no botão "Salvar" na parte inferior da página.
- 3.5. Você será redirecionado de volta para a página "Credenciais". Localize a chave da API que você acabou de criar. Para visualizar e copiar o código da chave, clique no link "Mostrar chave" (ícone de olho). Uma janela pop-up exibirá sua chave da API. Clique no ícone de copiar ao lado da chave para copiá-la para a sua área de transferência.
- Integrando a Chave da API de Resultados Próximos no eDirectory:
- 4.1. No seu Gerenciador de Sites eDirectory, navegue até Configurações → Idioma & Geografia → Detecção de Localização do Visitante & Resultados Próximos.
- 4.2. No campo "Chave da API do Google (Chave do Servidor)", cole a chave da API que você copiou no passo 3.5.
- 4.3. Clique no botão "Salvar alterações".
Nota: Por favor, note que a chave da API necessária para a integração do Google Maps (usada para exibir o mapa em si) e a chave da API (Chave do Servidor) para a funcionalidade de Resultados Próximos são diferentes. Elas servem a propósitos distintos e requerem configurações diferentes dentro da Google Cloud Platform. A chave da API do Google Maps JavaScript é usada principalmente para renderizar mapas na parte frontal do seu site, enquanto a chave da API de Resultados Próximos (Chave do Servidor), configurada com restrições de IP, é usada para acessar e recuperar com segurança dados de localização para listagens próximas.
Uma vez que a API de Resultados Próximos esteja configurada com sucesso, os usuários do seu site poderão filtrar os resultados de busca com base na distância de sua localização atual, fornecendo informações valiosas sobre a proximidade dos anúncios.
Vinculando Seu Projeto da API de Resultados Próximos a uma Conta de Cobrança:
Como mencionado na etapa 2, exibir Resultados Próximos em seu site eDirectory exige mais do que apenas obter uma chave de API. Para garantir seu funcionamento adequado e ininterrupto, a cobrança deve ser ativada para o projeto da Google Cloud Platform associado à sua chave de API de Resultados Próximos. Por favor, siga os passos descritos neste guia para ativar a cobrança para seu projeto: Como Habilitar o Faturamento para o Google Maps. Este passo é crucial para uma integração sem falhas e totalmente operacional.
Conclusão
Seguindo diligentemente este guia abrangente, passo a passo, você pode configurar com sucesso a API de Resultados Próximos do Google para seu site eDirectory. Esta integração melhorará significativamente a experiência do usuário, permitindo que os visitantes descubram facilmente os anúncios localizados perto deles, tornando seu processo de busca mais eficiente e relevante.
Lembre-se de garantir que todas as APIs necessárias (Geocoding e Maps JavaScript) estejam ativadas em seu projeto da Google Cloud Platform, que uma conta de cobrança esteja corretamente vinculada ao seu projeto e que você tenha integrado corretamente a chave da API (Chave do Servidor) em seu Gerenciador de Sites eDirectory. Se você encontrar alguma dificuldade durante o processo de configuração, verifique cada etapa, confirme que a cobrança está ativa e revise as restrições de endereço IP que você definiu para sua chave de API.
Para mais assistência, nossa equipe de suporte dedicada está sempre disponível em support@edirectory.com. Com a API de Resultados Próximos configurada corretamente, seu site oferecerá uma experiência mais dinâmica, ciente da localização e, em última análise, mais amigável para todos.