¿Qué hace?

La función de autocompletado de direcciones para Gravity Forms ayuda a los usuarios a enviar direcciones precisas más rápidamente mostrando sugerencias de Google mientras escriben. Funciona con ambos Dirección y Texto de una sola línea campos.

Cuando un usuario selecciona una sugerencia, el complemento también puede capturar metadatos de ubicación útiles (como el ID del lugar y las coordenadas) y mapear partes clave de la dirección, o incluso realizar una búsqueda de código postal, para completar campos específicos (incluidos los ocultos) para el enrutamiento, la automatización o la elaboración de informes.

Características

Finalización de direcciones más rápida
Los usuarios reciben sugerencias de Google mientras escriben, lo que reduce la cantidad de pulsaciones de teclas y acelera el envío de formularios.
Funciona con campos de dirección y texto de una sola línea.
Habilita la función de autocompletar en cualquiera de los dos tipos de campo, para que puedas conservar el diseño de tus formularios actuales.
Mapeo de campos analizados
Envíe la dirección (línea 1, línea 2), la ciudad/pueblo, el estado/región, el código postal y el país a cualquier campo seleccionado en el mismo formulario, incluidos los campos ocultos.
Gestión de direcciones internacional
Admite direcciones globales y utiliza etiquetas neutrales en cuanto al país en la configuración para equipos fuera de los EE. UU.
Restringir los resultados por país
Limite las sugerencias a países específicos utilizando códigos ISO (por ejemplo, EE. UU., Canadá, Reino Unido).
Metadatos guardados con cada entrada
Almacena el ID del lugar, la latitud, la longitud y la dirección formateada para integraciones, automatización y resolución de problemas.
Compatible con WordPress Multisite
Actívalo una sola vez para usarlo en todos tus subdominios. (Modo de red disponible en planes ilimitados).
Listo para traducir
Totalmente compatible con el plugin de traducción que haya elegido.Las pretraducciones no están incluidas, pero lo estarán próximamente.)
Búsqueda de código postal
Convierta un solo campo en una búsqueda por código postal que complete automáticamente los campos de ciudad y estado/región (incluidos los ocultos), ideal para formularios de "verifique su área" y enrutamiento de CRM.

Ir a los detalles de la función

¿Cómo habilito el plugin?

Después de comprar Address Autocomplete para Gravity Forms, deberá:

Instala el plugin en tu sitio web de WordPress.
Genera e introduce tu clave API de Google.
Habilitar la función de autocompletar en una dirección o Campo de texto de una sola línea.

Las instrucciones que aparecen a continuación le mostrarán cómo instalar su complemento, generar una clave API de Google para la función de autocompletado de direcciones y habilitarla en un campo de dirección o en un campo de texto de una sola línea.

Registra el plugin con Plugin Brewery

Genera e introduce la clave API de Google.

Antes de poder usar la función de autocompletar direcciones, debe generar una clave API en la consola de Google Cloud Platform.

Habilitar en campos de dirección

Habilitar en campos de texto de una sola línea

Generación de una clave API de Google

Crear o seleccionar un proyecto de Google Cloud existente

Antes de poder obtener tu clave API de Google, necesitas crear uno nuevo Proyecto de Google Cloud Platform (o seleccione uno existente si ya lo tiene).

Nota: Si está creando un nuevo proyecto de GCP, le recomendamos que lo defina para el sitio web en el que está trabajando, por si acaso necesita otros servicios de la API de Google para el mismo sitio web.

Habilitar las API necesarias

Después de haber creado o seleccionado un proyecto de Google Cloud, vaya a API y servicios > Biblioteca de API y habilite las siguientes API:

Nota: Google requiere que tengas una cuenta de facturación vinculada a tu proyecto antes de habilitar la API de Places. Para la mayoría de los sitios, el uso se incluye en el plan gratuito de Google, pero aun así se requiere un método de pago.

API de lugares (Nueva)

Enlace rápido

Es posible que veas "Places API" y "Places API (New)". Nuestro plugin está diseñado para ser compatible con "Places API (New)".“

API de JavaScript para mapas

Enlace rápido

Generar clave

Ahora que tienes ambas API habilitadas en tu proyecto, puedes generar tu clave API.

Ir a API y servicios > Credenciales, Luego, haga clic en “+ Crear credenciales” y, finalmente, haga clic en “Clave API”.”

Se desplegará una ventana de diálogo lateral donde podrá nombrar su clave.

En este punto, puede desplazarse hacia abajo y hacer clic en "Crear" y su clave se generará inmediatamente, SIN EMBARGO... debe establecer una restricción en el siguiente paso para evitar el uso no autorizado de su clave.

Nota: ¡Esto es muy importante! Las claves son visibles, así que no querrás que personas malintencionadas roben tu uso gratuito.

Continúe desplazándose hasta “Restricciones de la aplicación” en la ventana de diálogo.

En “Restricciones de la aplicación”, seleccione “Sitios web”.”

En “Restricciones del sitio web”, agregue los sitios web donde se debe usar la clave API. No agregue https.

Recomendamos agregar un dominio comodín para garantizar que la clave funcione en dominios con y sin www, como se muestra a continuación: *.example-website.com/*

Haz clic en crear y tu clave aparecerá a continuación.

¡Tu clave API ya está creada! Cópiala y pégala en la configuración de Autocompletar direcciones del plugin, ¡y listo!

Formato de dominio: Introduzca cada dominio en una línea separada utilizando el formato example.com/* - No https://, sin barra diagonal final en el dominio mismo, pero incluya /* al final para permitir todas las páginas. Para cubrir todos los subdominios (como www), agregue una entrada separada como *.example.com/*. Para el desarrollo local, utilice localhost o localhost:3000/* dependiendo de tu configuración.

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

Términos de servicio y política de privacidad de Google

Plugin Brewery Address Autocomplete envía datos de formulario a los servicios de Google para potenciar las búsquedas de direcciones. Según las directrices de Google, cualquier aplicación que utilice la API de Places debe mostrar un enlace a Google. Términos de servicio y política de privacidad.

Dependiendo de su país o región, es posible que también deba obtener el consentimiento del usuario antes de recopilar datos de ubicación.

Detalles de la característica

Tipos de campos admitidos

Funciona en ambos tipos de campos de Gravity Forms:

Campo de dirección (múltiples entradas)
Texto de una sola línea (entrada de dirección de una sola línea)

Utilice los campos de dirección cuando desee subcampos de dirección nativos de GF, o el campo de texto de una sola línea cuando desee un diseño de formulario más sencillo.

Asignación de direcciones analizadas (Nuevo)

Asigne los componentes de dirección seleccionados a campos específicos en su formulario:

Dirección Línea 1
Línea de dirección 2
Código postal / ZIP
Ciudad / Pueblo
Estado / Provincia / Región
País

Ideal para campos ocultos utilizados en comprobaciones de zonas de entrega, enrutamiento de CRM, notificaciones condicionales y automatización.

Búsqueda de código postal (Nuevo)

Convierta un campo de texto de una sola línea en un buscador de códigos postales. Active la función de autocompletar direcciones y, a continuación, active la búsqueda por código postal en la configuración avanzada del campo.

Las sugerencias se limitan a códigos postales.
El campo guarda únicamente el código seleccionado (no la dirección completa).
La ciudad, el estado/región (y el país/condado si está mapeado) se rellenan automáticamente, incluso en los campos ocultos.
Funciona en cualquier país que tenga códigos postales.

Ideal para la verificación de áreas de servicio, la lógica de envíos y el envío de datos de ubicación precisos a su CRM.

Información postal/de código postal en una sola línea

Para los campos de texto de una sola línea, el complemento utiliza la dirección formateada de Google y agrega el código postal cuando está disponible pero no aparece en el texto mostrado. Si Google no devuelve un código postal para un resultado, no se puede agregar.

Metadatos guardados en la entrada Meta

Cuando los usuarios seleccionan una sugerencia, el complemento almacena:

ID del lugar
Latitud
Longitud
Dirección formateada

Restricciones por país + Soporte internacional

Puede restringir las sugerencias a países específicos con códigos ISO alfa-2 (por ejemplo: US,CA,GB), o dejar sin restricciones para formularios globales.

Las etiquetas y las opciones de mapeo son independientes del país, por lo que los flujos de trabajo siguen siendo claros tanto para los equipos de EE. UU. como para los de otros países.

Rendimiento + Compatibilidad

Diseñado para entornos de producción reales:

Los scripts de interfaz se inicializan solo donde existen campos habilitados.
Funciona con flujos de Gravity Forms estándar y AJAX.
Compatible con la mayoría de las configuraciones de almacenamiento en caché/CDN.

Etiquetas de combinación

Cuando un visitante selecciona una sugerencia de autocompletar, el complemento puede almacenar metadatos en la entrada. Puedes insertar esos datos en confirmaciones, notificaciones y otros lugares que admitan las etiquetas de combinación de Gravity Forms.

Formato: {pb_aac:ID:KEY}

Reemplace ID con el ID del campo de Dirección o Texto de una sola línea que tenga habilitada la función de autocompletar dirección (el mismo campo donde aparecen las sugerencias).

Claves disponibles (KEY):

LLAVE	Lo que produce
`place_id`	ID de lugar de Google
`lat`	Latitud
`lng`	Longitud
`formatted`	Dirección formateada (cadena formateada por Google)
`google_maps_url`	Una URL de búsqueda de Google Maps construida a partir del ID del lugar (o latitud/longitud si falta el ID del lugar).

Ejemplos (si su campo de autocompletar es el 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}

Selector: En el editor de formularios, los campos habilitados también obtienen estas etiquetas en el selector de etiquetas de combinación bajo etiquetas como "Autocompletar dirección:...".

Nota: Los valores solo existen para las entradas en las que se seleccionó una sugerencia y se guardaron los metadatos; de lo contrario, la etiqueta aparece vacía (por diseño).

Preguntas frecuentes

¿La API de Google Places es gratuita?

Google aplica automáticamente un crédito mensual de $200 a tu cuenta, que se utiliza para facturar el uso de la API de Places. Para la mayoría de los sitios, esto cubre todos los costos; según las tarifas actuales, aproximadamente 10 000 sesiones de autocompletado al mes se incluyen en dicho crédito.

Dicho esto, los precios pueden cambiar, así que compruébelo. Tabla de precios de la plataforma Google Maps para conocer las cifras más recientes.

¿Puedo usarlo con el campo "Texto de una sola línea"?

¡Sí! Además del campo de dirección estándar, puedes habilitar la función de autocompletar en cualquier campo de texto de una sola línea. Ideal para formularios que solo requieren ingresar una dirección.

¿Funciona para direcciones internacionales?

Por supuesto. El complemento admite datos de direcciones globales de Google.

¿La configuración es complicada?

Para nada. Simplemente añade tu clave API de Google en la configuración del plugin, habilita la función de autocompletar en los campos que elijas y listo. Es así de sencillo.

¿Puedo restringir los resultados a países específicos?

Sí. En la configuración del campo, proporcione una lista separada por comas de códigos de país ISO 3166-1 alfa-2 (por ejemplo, US,CA,GB).

¿Qué API de Places debo habilitar en Google Cloud?

Habilite la “API de lugares (nueva)” ya que la “API de lugares” anterior está programada para ser descontinuada y también la “API de JavaScript de mapas”.

¿Puedo usar metadatos de direcciones en notificaciones o integraciones?

Sí. La función de autocompletar direcciones agrega etiquetas de combinación para ID de lugar, latitud, longitud, dirección formateada y URL de Google Maps. Utilice el selector de etiquetas de combinación de Gravity Forms en cualquier notificación, confirmación o mapa de feed.

¿Pueden los desarrolladores personalizar los resultados de Google?

Sí. Utilice el pb_aac_request Filtro JavaScript para ajustar la solicitud; por ejemplo, para sesgar los resultados hacia una región, agregar un cuadro delimitador o ampliar la búsqueda para incluir empresas.

¿Puedo usar un campo como buscador de códigos postales?

Sí. En un campo de texto de una sola línea, active la función de autocompletar dirección y, a continuación, la búsqueda por código postal. El campo muestra sugerencias de código postal y, al seleccionar una, se rellenan los campos de ciudad y estado/región elegidos (incluidos los ocultos). Ideal para formularios del tipo “verifique su área” y para el enrutamiento de CRM.

	Inicia sesión en tu sitio web de WordPress y ve a Plugins > Añadir plugin > Subir plugin > Instala el archivo zip y actívalo. Una vez activado, el plugin aparece en Formularios > Complementos > Instalados y su configuración se encuentra en Formularios > Configuración > Autocompletar direcciones.
	En el menú de navegación de la izquierda, vaya a Formularios > Configuración > Autocompletar direcciones > Licencia. Introduzca su clave de licencia y actívela. A continuación, acceda a la configuración de generación de claves de la API de Google que se muestra más abajo.

	Agregue un campo de dirección a su formulario.
	Abra la configuración del campo, navegue hasta el Avanzado sección y habilitar la Autocompletar direcciones caja.