Que fait-il ?

L'outil de saisie automatique d'adresses pour Gravity Forms aide les utilisateurs à soumettre plus rapidement des adresses exactes en affichant des suggestions Google pendant la saisie. Compatible avec les deux Adresse et Texte sur une seule ligne champs.

Lorsqu'un utilisateur sélectionne une suggestion, le plugin peut également capturer des métadonnées de localisation utiles (comme l'identifiant du lieu et les coordonnées) et cartographier les éléments clés de l'adresse – ou même effectuer une recherche de code postal – pour remplir des champs dédiés (y compris les champs cachés) pour le routage, l'automatisation ou la création de rapports.

Fonctionnalités

Saisie d'adresse plus rapide
Les utilisateurs reçoivent des suggestions de Google pendant qu'ils tapent, ce qui réduit le nombre de frappes et accélère les soumissions.
Fonctionne avec les champs Adresse + Texte sur une seule ligne
Activez la saisie semi-automatique pour les deux types de champs afin de conserver la mise en page de vos formulaires existants.
Cartographie des champs analysés
Envoyez l'adresse (ligne 1), la ligne 2, la ville, l'état/la région, le code postal et le pays dans n'importe quel champ choisi sur le même formulaire, y compris les champs cachés.
Gestion des adresses adaptée aux normes internationales
Prend en charge les adresses internationales et utilise des libellés neutres en matière de pays dans les paramètres des équipes situées hors des États-Unis.
Limiter les résultats par pays
Limitez les suggestions à des pays spécifiques en utilisant les codes ISO (par exemple, États-Unis, Canada, Royaume-Uni).
Métadonnées enregistrées avec chaque entrée
Stocke l'identifiant du lieu, la latitude, la longitude et l'adresse formatée pour les intégrations, l'automatisation et le dépannage.
Compatible avec WordPress Multisite
Activez le mode réseau une seule fois pour l'utiliser sur tous vos sous-sites. (Mode réseau disponible avec les forfaits Illimités.)
Prêt pour la traduction
Entièrement compatible avec le plugin de traduction que vous avez choisi. (Pré-traductions non incluses, mais à venir prochainement)
Recherche par code postal
Transformez un seul champ en une recherche par code postal qui remplit automatiquement vos champs Ville et État/Région (y compris les champs cachés) — idéal pour les formulaires “ vérifiez votre zone ” et le routage CRM.

Passer aux détails de la fonctionnalité

Comment puis-je activer le plugin ?

Après avoir acheté Address Autocomplete pour Gravity Forms, vous devrez :

Installez le plugin sur votre site WordPress.
Générez et saisissez votre clé API Google.
Activer la saisie automatique dans une adresse ou Champ de texte sur une seule ligne.

Les instructions ci-dessous vous montreront comment installer votre plugin, générer une clé API Google pour l'autocomplétion d'adresse et l'activer sur un champ d'adresse ou un champ de texte sur une seule ligne.

Enregistrez le plugin auprès de Plugin Brewery

Générez et saisissez la clé API Google.

Avant de pouvoir utiliser la saisie automatique d'adresses, vous devez générer une clé API dans la console Google Cloud Platform.

Activer sur les champs d'adresse

Activer sur les champs de texte à ligne unique

Générer une clé API Google

Créer ou sélectionner un projet Google Cloud existant

Avant de pouvoir obtenir votre clé API Google, vous devez créer un nouveau Projet Google Cloud Platform (ou sélectionnez-en un existant si vous en avez un).

Remarque : Si vous créez un nouveau projet GCP, nous vous recommandons de le limiter au site web sur lequel vous travaillez, au cas où vous auriez besoin d’autres services d’API Google pour ce même site.

Activer les API requises

Après avoir créé ou sélectionné un projet Google Cloud, accédez à API et services > Bibliothèque d'API et activez les API suivantes :

Remarque : Google exige qu'un compte de facturation soit associé à votre projet avant d'activer l'API Places. Pour la plupart des sites, l'utilisation est incluse dans le forfait gratuit de Google, mais un moyen de paiement reste nécessaire.

API Places (Nouveau)

Lien rapide

Vous remarquerez peut-être “ Places API ” et “ Places API (New) ” – Notre plugin est conçu pour être compatible avec “ Places API (New) ”.”

API JavaScript de cartes

Lien rapide

Générer une clé

Maintenant que vous avez activé les deux API dans votre projet, vous pouvez générer votre clé API.

Aller à API et services > Identifiants, Cliquez ensuite sur “ + Créer des identifiants ” puis sur “ Clé API ”.”

Une fenêtre de dialogue latérale s'affichera, vous permettant de nommer votre clé.

À ce stade, vous pouvez faire défiler vers le bas et cliquer sur “ Créer ” pour que votre clé soit générée immédiatement. CEPENDANT… vous devez définir une restriction à l’étape suivante afin d’empêcher toute utilisation non autorisée de votre clé.

Remarque : Ceci est très important ! Les clés sont visibles, vous ne voulez donc pas que des personnes mal intentionnées s'approprient votre utilisation gratuite.

Faites défiler jusqu'à “ Restrictions de l'application ” dans la fenêtre de dialogue.

Sous “ Restrictions d'application ”, sélectionnez “ Sites Web ”.”

Sous “ Restrictions relatives aux sites Web ”, ajoutez les sites Web sur lesquels la clé API doit être utilisée. N’ajoutez pas « https ».

Nous recommandons d'ajouter un domaine générique afin de garantir que la clé fonctionne sur les domaines avec et sans www, comme ceci : *.example-website.com/*

Cliquez sur « Créer » et votre clé apparaîtra ensuite.

Votre clé API est maintenant créée ! Copiez-la et collez-la dans les paramètres de saisie automatique d'adresse du plugin. Le tour est joué !

Formatage du domaine : Saisissez chaque domaine sur sa propre ligne en utilisant le format suivant : example.com/* - Non https://, pas de barre oblique finale sur le domaine lui-même, mais incluez /* à la fin pour permettre l'accès à toutes les pages. Pour couvrir tous les sous-domaines (comme www), ajouter une entrée séparée comme *.example.com/*. Pour le développement local, utilisez localhost ou localhost:3000/* en fonction de votre configuration.

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

Conditions d'utilisation et politique de confidentialité de Google

Plugin Brewery Address Autocomplete envoie les données du formulaire aux services Google pour effectuer des recherches d'adresses. Conformément aux directives de Google, toute application utilisant l'API Places doit afficher un lien vers le site de Google. Conditions d'utilisation et politique de confidentialité.

Selon votre pays ou région, vous pourriez également être tenu d'obtenir le consentement de l'utilisateur avant de collecter des données de localisation.

Détails des fonctionnalités

Types de champs pris en charge

Fonctionne avec les deux types de champs Gravity Forms :

Champ d'adresse (saisie multiple)
Texte sur une seule ligne (saisie d'adresse sur une seule ligne)

Utilisez les champs Adresse lorsque vous souhaitez des sous-champs d'adresse GF natifs, ou Texte sur une seule ligne lorsque vous souhaitez une mise en page de formulaire plus simple.

Mappage d'adresses analysées (Nouveau)

Associez les composants d'adresse sélectionnés à des champs dédiés dans votre formulaire :

Adresse Ligne 1
Ligne d'adresse 2
Code postal / ZIP
Ville
Etat / Province / Région
Pays

Idéal pour les champs cachés utilisés dans les contrôles de zone de livraison, le routage CRM, les notifications conditionnelles et l'automatisation.

Recherche de code postal (Nouveau)

Transformez un champ de texte sur une seule ligne en champ de recherche par code postal. Activez la saisie semi-automatique de l'adresse, puis activez la recherche par code postal dans les paramètres avancés du champ.

Les suggestions se limitent aux codes postaux.
Ce champ ne conserve que le code sélectionné (et non l'adresse complète).
La ville, l'État/la région (et le pays/comté si cartographié) se remplissent automatiquement, y compris dans les champs cachés.
Fonctionne pour tous les pays ayant des codes postaux

Idéal pour les vérifications de zone de service, la logique d'expédition et l'envoi de données de localisation propres à votre CRM.

Traitement des codes postaux/zips sur une seule ligne

Pour les champs de texte sur une seule ligne, l'extension utilise l'adresse formatée de Google et ajoute le code postal lorsqu'il est disponible mais absent du texte affiché. Si Google ne renvoie pas de code postal pour un résultat, il est impossible d'en ajouter un.

Métadonnées enregistrées dans les métadonnées de l'entrée

Lorsque les utilisateurs sélectionnent une suggestion, le plugin enregistre :

ID du lieu
Latitude
Longitude
Adresse formatée

Restrictions géographiques + Assistance internationale

Vous pouvez limiter les suggestions à des pays spécifiques avec des codes ISO alpha-2 (par exemple : US,CA,GB), ou laisser sans restriction pour les formes globales.

Les options d'étiquetage et de mappage sont indépendantes du pays, ce qui permet de conserver des flux de travail clairs pour les équipes américaines et non américaines.

Performances et compatibilité

Conçu pour les sites de production réels :

Les scripts front-end s'initialisent uniquement là où des champs activés existent.
Compatible avec les flux Gravity Forms standard et AJAX
Compatible avec les configurations de mise en cache/CDN courantes dans la plupart des cas.

Fusionner les balises

Lorsqu'un visiteur sélectionne une suggestion de saisie automatique, l'extension peut enregistrer des métadonnées sur l'entrée. Vous pouvez ensuite insérer ces données dans les confirmations, les notifications et autres emplacements compatibles avec les balises de fusion de Gravity Forms.

Format: {pb_aac:ID:KEY}

Remplacez ID par l'ID du champ Adresse ou du champ Texte sur une seule ligne pour lequel la saisie semi-automatique de l'adresse est activée (le même champ où apparaissent les suggestions).

Clés disponibles (KEY):

CLÉ	Ce qu'il produit
`place_id`	ID de lieu Google
`lat`	Latitude
`lng`	Longitude
`formatted`	Adresse formatée (chaîne de caractères formatée par Google)
`google_maps_url`	URL de recherche Google Maps construite à partir de l'identifiant du lieu (ou des coordonnées latitude/longitude si l'identifiant du lieu est manquant).

Exemples (si votre champ de saisie automatique est le champ 12) :

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

Sélecteur : Dans l’éditeur de formulaire, les champs activés reçoivent également ces balises dans le sélecteur de balises de fusion, sous des étiquettes telles que “ Saisie semi-automatique de l’adresse : … ”.

Note: Les valeurs n'existent que pour les entrées où une suggestion a été sélectionnée et les métadonnées enregistrées ; sinon, l'étiquette est vide (conventionnellement).

FAQ

L'API Google Places est-elle gratuite ?

Google applique automatiquement un crédit mensuel de $200 à votre compte, qui est déduit de votre facturation pour l'utilisation de l'API Places. Pour la plupart des sites, ce crédit couvre tous les coûts ; aux tarifs actuels, il couvre environ 10 000 sessions de saisie automatique par mois.

Cela dit, les prix peuvent changer, alors vérifiez le Tableau des prix de la plateforme Google Maps pour les derniers chiffres.

Puis-je l'utiliser avec le champ “ Texte sur une seule ligne ” ?

Oui ! En plus du champ Adresse standard, vous pouvez activer la saisie semi-automatique pour tout champ de texte sur une seule ligne. Idéal pour les formulaires ne nécessitant qu’une seule adresse.

Cela fonctionne-t-il pour les adresses internationales ?

Absolument. Le plugin prend en charge les données d'adresses globales de Google.

L'installation est-elle compliquée ?

Pas du tout. Il vous suffit d'ajouter votre clé API Google dans les paramètres de l'extension, d'activer la saisie automatique dans les champs de votre choix, et le tour est joué. C'est aussi simple que ça.

Puis-je limiter les résultats à certains pays ?

Oui. Dans les paramètres de champ, indiquez une liste de codes pays ISO 3166-1 alpha-2 séparés par des virgules (par exemple, US,CA,GB).

Quelle API Places dois-je activer dans Google Cloud ?

Activez “ Places API (New) ” car l’ancienne “ Places API ” est vouée à être abandonnée et “ Maps JavaScript API ”.

Puis-je utiliser les métadonnées d'adresse dans les notifications ou les intégrations ?

Oui. La fonction de saisie automatique d'adresse ajoute des balises de fusion pour l'identifiant du lieu, la latitude, la longitude, l'adresse formatée et l'URL de Google Maps. Utilisez le sélecteur de balises de fusion de Gravity Forms dans vos notifications, confirmations ou flux.

Les développeurs peuvent-ils personnaliser les données renvoyées par Google ?

Oui. Utilisez le pb_aac_request Filtre JavaScript pour ajuster la requête — par exemple, orienter les résultats vers une région, ajouter un cadre de délimitation ou étendre la recherche pour inclure les entreprises.

Puis-je utiliser un champ comme recherche de code postal ?

Oui. Dans un champ de texte sur une seule ligne, activez la saisie semi-automatique de l'adresse, puis la recherche par code postal. Le champ affiche des suggestions de code postal ; en en sélectionnant une, les champs Ville et État/Région (y compris les champs masqués) sont automatiquement remplis. Idéal pour les formulaires de type “ vérifiez votre zone géographique ” et le routage CRM.

	Connectez-vous à votre site WordPress et accédez à Extensions > Ajouter une extension > Téléverser une extension > Installez le fichier zip et activez-le. Une fois activé, le plugin apparaît dans Formulaires > Modules complémentaires > Installés et ses paramètres se trouvent sous Formulaires > Paramètres > Saisie automatique d'adresse.
	Dans le menu de navigation de gauche, accédez à Formulaires > Paramètres > Saisie automatique d'adresses > Licence. Saisissez votre clé de licence et activez-la. Passez ensuite aux paramètres de génération de clé API Google ci-dessous.

	Ajoutez un champ Adresse à votre formulaire.
	Ouvrez les paramètres du champ, accédez à Avancé section, et activer la Saisie automatique d'adresse case à cocher.