O que é que faz?

O Address Autocomplete for Gravity Forms ajuda os utilizadores a submeter moradas corretas mais depressa, mostrando sugestões alimentadas pelo Google à medida que escrevem. Funciona com ambos Morada e Texto de linha única campos.

Quando um utilizador seleciona uma sugestão, o plugin também pode capturar metadados de localização úteis (como o ID do local e as coordenadas) e mapear partes principais de moradas – ou até mesmo executar uma pesquisa de código postal – para preencher campos dedicados (incluindo ocultos) para encaminhamento, automatização ou relatórios.

Características

Preenchimento de moradas mais rápido
Os utilizadores recebem sugestões alimentadas pelo Google à medida que escrevem, reduzindo o número de carateres a introduzir e acelerando os envios.
Funciona com campos de Morada + Texto de Linha Única
Ative o preenchimento automático em qualquer tipo de campo, para que possa manter os seus esquemas de formulário existentes.
Mapeamento de campos analisados
Insira a Morada (Linha 1), Linha 2, Cidade/Localidade, Distrito/Região, Código Postal e País em qualquer campo escolhido do mesmo formulário, incluindo campos ocultos.
Tratamento de endereços compatível com o plano internacional
Suporta moradas globais e utiliza etiquetas neutras em termos de país nas definições para equipas fora dos EUA.
Restringir resultados por país
Limite as sugestões a países específicos utilizando códigos ISO (por exemplo, US, CA, GB).
Metadados guardados com cada entrada
Armazena o ID do Local, a latitude, a longitude e a morada formatada para integrações, automatização e resolução de problemas.
Compatível com WordPress Multisite
Ative na rede uma vez para o utilizar em todos os seus sub-sites. (Modo de rede disponível nos planos Ilimitados.)
Tradução pronta
Totalmente compatível com o seu plugin de tradução escolhido.pré-traduções não incluídas, mas brevemente disponíveis)
pesquisa de código postal
Transforme um único campo numa pesquisa de código postal que preenche automaticamente os campos de Cidade e Estado/Região (incluindo os ocultos) — ideal para formulários de “verifique a sua área” e encaminhamento de CRM.

Saltar para os Detalhes da Funcionalidade

Como ativo o plugin?

Após comprar o Address Autocomplete para o Gravity Forms, precisará de:

Instale o plugin no seu site WordPress.
Gere e insira a sua chave da API do Google.
Ativar a Previsão de Endereço ou Campo de texto de uma linha.

As instruções abaixo mostram como instalar o seu plugin, gerar uma chave da API do Google para o preenchimento automático de moradas e ativá-la num campo de morada ou num campo de texto de linha única.

Registar o plugin com Plugin Brewery

Gerar e introduzir a chave de API do Google

Antes de poder utilizar o Preenchimento Automático de Moradas, tem de gerar uma chave de API na consola da Google Cloud Platform.

Ativar em campos de endereço

Ativar em campos de texto de uma linha

Gerar uma chave da API do Google

Criar ou Selecionar um Projeto do Google Cloud Existente

Antes de poderes obter a tua chave da API do Google, tens de criar novo projeto do Google Cloud Platform (ou selecione um existente, caso já o tenha).

Nota: Se estiver a criar um novo projeto GCP, recomendamos que o delimite ao website em que está a trabalhar, para o caso de precisar de outros serviços de API da Google para o mesmo website.

Ativar as APIs Obrigatórias

Depois de criar ou selecionar um projeto do Google Cloud, navegue até APIs e Serviços > Biblioteca de APIs e ative as seguintes APIs:

Nota: A Google requer que uma conta de faturação seja associada ao seu projeto antes de ativar a Places API. Para a maioria dos sites, a utilização encontra-se dentro do escalão gratuito da Google, mas ainda assim é necessário um método de pagamento.

Places API (Novo)

Link Rápido

Poderá notar uma “Places API” e uma “Places API (New)” – O nosso plugin foi construído para ser compatível com a “Places API (New)”

API Maps JavaScript

Link Rápido

Gerar Chave

Agora que tem ambas as API ativadas no seu projeto, pode gerar a sua chave de API.

Ir para APIs e Serviços > Credenciais, depois clique em “+ Create Credentials” e por fim clique em “API key”

Vai surgir uma janela de diálogo lateral onde poderá atribuir um nome à sua chave.

Neste ponto, podia fazer scroll para baixo e clicar em “Criar” e a sua chave seria gerada imediatamente, CONTUDO... deve definir uma restrição na mesma no passo seguinte para impedir a utilização não autorizada da sua chave.

Nota: Isto é muito importante! As chaves são visíveis, por isso não quer que agentes maliciosos roubem a sua utilização gratuita

Continue a deslocar para baixo até “Restrições de aplicação” na janela de diálogo.

Em “Restrições de aplicações”, selecione “Websites”

Em “Website restrictions” adicione os seus websites onde a chave de API deve ser utilizada. Não adicione https.

Recomendamos adicionar um domínio universal (wildcard) para garantir que a chave funcione em domínios com e sem www, da seguinte forma: *.example-website.com/*

Clique em criar e a sua chave aparecerá a seguir.

Agora a sua chave de API foi criada! Copie-a e cole-a nas definições de Autocompletação de Moradas do *plugin* e está tudo pronto!

Formatação de domínios: Insira cada domínio na sua própria linha usando o formato example.com/* — não https://, sem barra final no próprio domínio, mas incluir /* no fim para permitir todas as páginas. Para abranger todos os subdomínios (como www), adicione uma entrada separada como *.example.com/*. Para desenvolvimento local, utilize localhost ou localhost:3000/* Dependendo da sua configuração.

yourdomain.com/*
*.yourdomain.com/*
staging.yourdomain.com/*
localhost:8080/*

Termos de Serviço e Política de Privacidade do Google

O recurso de preenchimento automático de endereços do Plugin Brewery envia dados de formulário para os serviços do Google para realizar buscas de endereços. De acordo com as diretrizes do Google, qualquer aplicativo que utilize a API Places deve exibir um link para o site do Google. Termos de Serviço e Política de Privacidade.

Dependendo do seu país ou região, você também poderá ser obrigado a obter o consentimento do usuário antes de coletar dados de localização.

Detalhes da Funcionalidade

Tipos de campos suportados

Funciona em ambos os tipos de campo do Gravity Forms:

Campo de endereço (entrada múltipla)
Texto de linha única (entrada de endereço em uma única linha)

Use os campos de endereço quando desejar subcampos de endereço nativos do GF ou o campo Texto de Linha Única quando preferir um layout de formulário mais simples.

Mapeamento de Endereços Analisados (Novo)

Mapeie os componentes de endereço selecionados para campos específicos em seu formulário:

Endereço Linha 1
Linha de endereço 2
Postal / CEP
Cidade / Vila
Estado/Província/Região
País

Ideal para campos ocultos usados em verificações de zona de entrega, roteamento de CRM, notificações condicionais e automação.

Consulta de CEP (Novo)

Transforme um campo de texto de linha única em uma busca por código postal. Ative o preenchimento automático de endereço e, em seguida, habilite a busca por código postal nas configurações avançadas do campo.

As sugestões se limitam a códigos postais/CEP.
O campo armazena apenas o código selecionado (e não o endereço completo).
Cidade, Estado/Região (e País/Condado, se mapeado) são preenchidos automaticamente, inclusive em campos ocultos.
Funciona para qualquer país que tenha códigos postais.

Ideal para verificações de área de serviço, lógica de envio e envio de dados de localização precisos para o seu CRM.

Manuseio de texto postal/CEP em linha única

Para campos de texto de linha única, o plugin usa o endereço formatado do Google e adiciona o código postal quando disponível, mas ausente no texto exibido. Se o Google não retornar um código postal para um resultado, não será possível adicioná-lo.

Metadados salvos na entrada Meta

Quando os usuários selecionam uma sugestão, o plugin armazena:

Identificação do local
Latitude
Longitude
Endereço formatado

Restrições por país + suporte internacional

Você pode restringir as sugestões a países específicos com códigos ISO alfa-2 (por exemplo: US,CA,GB), ou deixe sem restrições para formulários globais.

As opções de rótulos e mapeamento são neutras em relação ao país, portanto os fluxos de trabalho permanecem claros para equipes dos EUA e de outros países.

Desempenho + Compatibilidade

Projetado para locais de produção reais:

Os scripts de front-end são inicializados apenas onde os campos habilitados existem.
Funciona com fluxos padrão e AJAX do Gravity Forms.
Compatível com configurações comuns de cache/CDN na maioria das configurações.

Mesclar tags

Quando um visitante seleciona uma sugestão de preenchimento automático, o plugin pode armazenar metadados na entrada. Você pode inserir esses dados em confirmações, notificações e outros locais que suportam tags de mesclagem do Gravity Forms.

Formatar: {pb_aac:ID:KEY}

Substitua ID pelo ID do campo de endereço ou de texto de linha única que tenha o recurso de preenchimento automático de endereço ativado (o mesmo campo onde as sugestões aparecem).

Chaves disponíveis (KEY):

CHAVE	O que ele produz
`place_id`	ID do Google Places
`lat`	Latitude
`lng`	Longitude
`formatted`	Endereço formatado (string formatada pelo Google)
`google_maps_url`	Um URL de pesquisa do Google Maps construído a partir do ID do local (ou latitude/longitude, caso o ID do local esteja ausente).

Exemplos (se o seu campo de autocompletar for o campo 12):

{pb_aac:12:place_id}
{pb_aac:12:lat}
{pb_aac:12:lng}
{pb_aac:12:formatted}
{pb_aac:12:google_maps_url}

Seletor: No editor de formulários, os campos habilitados também recebem essas tags no seletor de tags de mesclagem, sob rótulos como "Preenchimento automático de endereço: ...".

Observação: Os valores só existem para entradas em que uma sugestão foi selecionada e os metadados foram salvos; caso contrário, a tag fica vazia (por design).

Perguntas Frequentes

A API do Google Places é gratuita?

O Google aplica automaticamente um crédito mensal de $200 à sua conta, que é usado para pagar o uso da API Places. Para a maioria dos sites, isso cobre todos os custos — nas taxas atuais, aproximadamente 10.000 sessões de preenchimento automático por mês se enquadram nesse crédito.

Dito isso, os preços podem mudar, então verifique o Tabela de preços da plataforma Google Maps Para obter os números mais recentes.

Posso usar esse recurso no campo "Texto de Linha Única"?

Sim! Além do campo de endereço padrão, você pode ativar o preenchimento automático em qualquer campo de texto de linha única. Ideal para formulários que precisam apenas de um endereço.

Funciona para endereços internacionais?

Com certeza. O plugin é compatível com dados de endereço globais do Google.

A configuração é complicada?

De jeito nenhum. Basta adicionar sua chave da API do Google nas configurações do plugin, ativar o preenchimento automático nos campos escolhidos e pronto. É simples assim.

Posso restringir os resultados a países específicos?

Sim. Nas configurações do campo, forneça uma lista de códigos de país ISO 3166-1 alpha-2 separados por vírgulas (por exemplo, US,CA,GB).

Qual API do Google Places devo ativar no Google Cloud?

Habilite a “API Places (Nova)”, pois a “API Places” legada será descontinuada, assim como a “API JavaScript de Mapas”.

Posso usar metadados de endereço em notificações ou integrações?

Sim. O recurso de Autocompletar Endereços adiciona tags de mesclagem para ID do local, latitude, longitude, endereço formatado e URL do Google Maps. Use o seletor de tags de mesclagem do Gravity Forms em qualquer notificação, confirmação ou mapeamento de feed.

Os desenvolvedores podem personalizar os resultados da pesquisa do Google?

Sim. Use o pb_aac_request Filtro JavaScript para ajustar a solicitação — por exemplo, direcionando os resultados para uma região, adicionando uma caixa delimitadora ou expandindo para incluir empresas.

Posso usar um campo para pesquisa de CEP/código postal?

Sim. Em um campo de texto de linha única, habilite o Preenchimento Automático de Endereço e, em seguida, ative a Pesquisa de CEP. O campo exibe sugestões de CEP e, ao selecionar uma delas, os campos de Cidade e Estado/Região escolhidos (incluindo os ocultos) serão preenchidos automaticamente. Ótimo para formulários do tipo "verifique sua área" e para roteamento em CRM.

	Inicie sessão no seu site WordPress e navegue até Plugins > Adicionar plugin > Carregar plugin > Instale o ficheiro zip e ative-o. Assim que ativado, o plugin aparece em Formulários > Extensões > Instalados e as respetivas definições encontram-se em Formulários > Definições > Preenchimento Automático de Moradas.
	Na navegação à esquerda, aceda a Formulários > Definições > Preenchimento Automático de Moradas > Licença. Introduza a sua chave de licença e ative-a. Em seguida, avance para as definições de geração de chaves da API do Google abaixo.

	Adicione um campo de Morada ao seu formulário.
	Abra as definições do campo, navegue até ao Avançado seção, e ative a Preenchimento Automático de Moradas caixa de seleção.