Addon de Geolocalização

Gostaria de saber mais sobre as localizações dos usuários que preenchem seus formulários? Com o addon de Geolocalização do WPForms, você pode coletar facilmente dados geográficos para cada um de seus leads.

Este tutorial mostrará como instalar e usar o addon de Geolocalização para WPForms.

---

Configurando o Addon de Geolocalização

Antes de começar, você precisará garantir que o WPForms esteja instalado e ativado em seu site WordPress.

Depois de instalar o WPForms e sua licença for verificada, você poderá rapidamente instalar e ativar o addon de Geolocalização.

Após ativar o addon, você pode configurar suas configurações acessando WPForms » Configurações e selecionando a aba Geolocalização.

A partir daqui, você terá a opção de escolher qual provedor você gostaria de receber suas informações de geolocalização.

Nas seções a seguir, abordaremos como configurar as APIs do Google Places e do Mapbox Search.

API do Google Places

Primeiro, selecione Google Places na lista de opções na seção Geolocalização.

Depois de selecionar a opção Google Places, configurações adicionais aparecerão. Você precisará recuperar sua chave de API do Google Places para poder inseri-la no campo fornecido. Para fazer isso, abra o Google Cloud Console em uma nova aba ou janela do navegador.

Gerando Sua Chave de API do Google Places

No topo do seu painel do Google Cloud, selecione o projeto para o qual você deseja habilitar esta chave de API no menu Selecionar um projeto.

Se você ainda não criou um projeto, clique em NOVO PROJETO para configurar um.

Depois de abrir seu projeto, você deverá ser redirecionado para o painel de APIs e Serviços. Se não for, abra o menu sanduíche no canto superior esquerdo da tela e vá para APIs e Serviços » APIs e serviços ativados.

Em seguida, clique em + ATIVAR APIS E SERVIÇOS.

Isso abrirá a Biblioteca de APIs. Pesquise e ative as seguintes APIs:

• API Places
• API JavaScript Maps
• API Geocoding

Para habilitar uma API para seu projeto, você só precisa clicar no botão azul HABILITAR abaixo do nome dela.

Após habilitar todas as três APIs, navegue até as configurações de Credenciais indo em APIs e Serviços » Credenciais no menu à esquerda. A partir daqui, clique em + CRIAR CREDENCIAIS e selecione a opção chave de API para gerar uma chave de API.

Na janela pop-up com sua nova chave de API, clique em Editar chave de API.

Na próxima tela, você precisará configurar as seguintes opções:

Definir uma Restrição de Aplicação

Para permitir que sua chave de API seja usada com o WPForms, você precisará selecionar a opção Websites.

Restrições de Website

Depois de permitir que sua chave seja usada em websites, é recomendado restringir quais domínios podem usá-la por motivos de segurança. Para fazer isso, clique em + ADICIONAR na seção de Restrições de Website.

Em seguida, insira o domínio do seu website no campo fornecido. Se você quiser permitir que sua chave seja usada em um domínio inteiro, insira-o com uma barra (/) seguida por um asterisco (*) no final.

Você pode adicionar quantos itens precisar para habilitar sua chave para todo o seu site ou para vários sites.

Restrições de API

Depois de restringir sua chave por Aplicação e Website, você precisará restringi-la por API. Para fazer isso, selecione a opção Restringir chave.

Isso revelará um menu suspenso, do qual você precisará selecionar as APIs específicas para as quais deseja restringir sua chave.

Neste menu suspenso, selecione as seguintes APIs:

• API Places
• API JavaScript Maps
• API Geocoding

Depois de selecionar essas APIs, clique no botão Salvar para salvar suas configurações.

Copiando Sua Chave de API do Google Places

Após salvar suas configurações, você será redirecionado para uma visão geral de todas as suas chaves de API disponíveis. Para visualizar sua chave, clique na opção MOSTRAR CHAVE em Ações.

Uma janela pop-up aparecerá exibindo a chave de API. A partir daqui, copie a chave clicando no ícone de cópia e retorne às suas configurações do WPForms.

De volta às suas configurações do WPForms, cole a Chave de API que você acabou de copiar no campo Chave de API e salve suas configurações.

Se você deseja pré-preencher seus formulários com as localizações dos usuários, ative a opção Localização Atual para a posição LIGADO.

É tudo o que você precisa saber para configurar a API do Google Places. Na próxima seção, abordaremos como usar o provedor Mapbox, que é outra ótima opção para fornecer dados de geolocalização.

API de Pesquisa Mapbox

Para começar a configurar a API do Mapbox Search, selecione Mapbox Search na lista de opções na seção Geocodificação.

Depois de selecionar a opção Mapbox Search API, configurações adicionais aparecerão. Você precisará criar um token de acesso do Mapbox Search. Para fazer isso, primeiro você precisará fazer login no painel da sua conta Mapbox.

Depois de acessar o painel da sua conta, localize a barra de navegação e clique em Tokens.

Isso o levará à página de tokens de acesso, onde você pode adicionar e gerenciar seus tokens.

O Mapbox fornece um token de acesso padrão para você, no entanto, recomendamos a criação de um novo token que você possa usar especificamente para o WPForms. Para fazer isso, clique no botão Criar um token.

Clicar neste botão o levará a uma nova página onde você pode criar um novo token de acesso. Na seção Nome do token, localize o campo Nome e digite um rótulo para ajudar a associá-lo a um projeto.

Em seguida, role para baixo até a seção Escopos do token. Aqui você verá vários escopos públicos selecionados por padrão. Deixe esta seção como está.

Em seguida, role para baixo até a seção Restrições de token e insira a URL do seu site no campo URL.

Depois de digitar sua URL, clique no botão Adicionar URL para adicionar a URL.

Depois de preencher os campos necessários, clique no botão Criar token.

Em seguida, você verá uma janela modal solicitando a confirmação da senha da sua conta. Digite sua senha e clique em Enviar.

Agora você será redirecionado de volta à página de tokens de acesso, onde verá o novo token que acabou de criar. Clique no ícone de cópia para copiar o token.

Depois de copiar seu token de acesso, volte às configurações do WPForms e cole o token no campo Token de Acesso.

Se você quiser preencher previamente seus formulários com as localizações dos usuários, ative a opção Localização Atual.

Quando terminar, certifique-se de salvar suas configurações.

Em seguida, você verá uma prévia do mapa. Se você decidiu compartilhar sua localização, verá sua localização atual representada no mapa.

Na próxima seção, abordaremos como adicionar preenchimento automático de endereço aos seus formulários.

Adicionando Autocompletar de Endereço aos Seus Formulários

Depois de configurar suas configurações de Geolocation, você pode habilitar o recurso de preenchimento automático do addon Geolocation em seus formulários.

Para fazer isso, primeiro você precisará criar um novo formulário ou editar um existente. Em seguida, no construtor de formulários, adicione um campo Endereço ou um campo Texto de Linha Única.

Se você quiser exibir o endereço em várias linhas, selecione o campo Endereço.

Se preferir exibir o endereço em uma única linha, escolha o campo Texto de Linha Única.

Em seguida, abra o painel Opções do Campo para seu campo Endereço ou Texto de Linha Única e clique na aba Avançado para abrir configurações adicionais. A partir daqui, você pode ativar o recurso de preenchimento automático de endereço selecionando a opção Habilitar Preenchimento Automático de Endereço.

Se desejar, você também pode exibir um mapa interativo no frontend do seu site selecionando a opção Exibir Mapa. Isso revelará um menu suspenso onde você pode escolher se deseja mostrar o mapa acima ou abaixo do campo do seu formulário.

Depois de configurar tudo, certifique-se de salvar seu formulário.

Aqui está um exemplo de como seu formulário pode parecer no frontend com as opções de mapa e preenchimento automático de endereço habilitadas:

Usando o Campo de Mapa

O Campo Mapa no WPForms permite exibir locais específicos em um mapa interativo dentro de seus formulários. Ao contrário do campo Endereço, que coleta a localização dos usuários que enviam seu formulário, o Campo Mapa exibe locais que você configura, como endereços de escritórios, locais de lojas ou pontos de retirada. Este recurso é ideal para exibir vários locais de negócios ou ajudar os usuários a identificar áreas de serviço específicas.

Para obter instruções detalhadas passo a passo sobre como adicionar locais, personalizar marcadores, configurar configurações avançadas e lidar com vários locais, consulte nosso guia completo sobre Usando o Campo Mapa no WPForms.

Visualizando Dados de Localização de Entradas

Para visualizar os dados de geolocalização de uma entrada, vá para WPForms » Entradas e escolha o formulário para o qual você gostaria de ver os detalhes de geolocalização. Em seguida, clique em Visualizar para abrir a página de uma entrada individual.

Além de um mapa interativo, você verá detalhes como a cidade, estado, país e CEP do usuário, bem como coordenadas aproximadas de latitude e longitude da cidade do usuário.

Incluindo Dados de Geolocalização em E-mails de Notificação de Formulário

Se desejar, você também pode incluir dados de geolocalização em e-mails de notificação automáticos para seus formulários.

Para configurar isso, abra o construtor de formulários e vá para Configurações » Notificações. Em seguida, role até a seção Mensagem de E-mail e adicione a tag inteligente {entry_geolocation}.

Quando o e-mail de notificação for enviado, ele incluirá dados de localização do usuário.

É isso! Agora você sabe como coletar dados de geolocalização para saber mais sobre seus usuários.

Em seguida, você gostaria de enviar diferentes e-mails de notificação dependendo das seleções de formulário dos usuários? Para saber como, confira nosso tutorial sobre notificações condicionais de formulário.