Questions · Adresses

Comment ajouter l'autocomplétion des adresses à mon formulaire ?

Ce que voit celui qui remplit

Il écrit « pl de la comedie » et voit « Place de la Comédie », avec les communes où cette voie existe ; s'il a déjà rempli la ville, les suggestions se resserrent sur elle. La voie choisie, il tape le numéro et le formulaire lui dit s'il existe : le code postal qui arrive est celui qui revient à ce numéro, ce qui compte à Paris, Lyon et Marseille, où il change avec l'arrondissement.

À la sélection, les champs adresse, code postal et commune se remplissent avec la fiche passée par le moteur, la même que celle de la vérification d'adresse. Le fichier naît propre au lieu d'être nettoyé après.

Comment cela se compte

Par session, pas par touche enfoncée. Les demandes de suggestion pendant la frappe sont gratuites ; une seule opération est comptée quand l'utilisateur sélectionne l'adresse et que les champs se remplissent. S'il change ensuite le numéro et resélectionne dans la même session, rien n'est compté de nouveau. Chaque session admet jusqu'à trente demandes et vaut dix minutes. Les tarifs sont sur la page des tarifs.

Comment cela s'intègre

Trois pièces :

1. Un jeton API, depuis votre espace personnel.
2. Un petit relais sur votre serveur, une page qui reçoit la demande du navigateur, ajoute le jeton et la transmet à notre point d'accès. Il est nécessaire parce que le jeton ne doit jamais se trouver dans le code qui tourne dans le navigateur.
3. Le widget ra-suggerisci.js, sans dépendances : vous lui indiquez l'adresse du relais et les sélecteurs des champs du formulaire, et il fait le reste : il gère lui-même l'attente pendant la frappe, le contexte des champs déjà remplis et le remplissage au choix.

Ceux qui préfèrent faire eux-mêmes appellent directement le point d'accès /api/v1/suggest : un identifiant de session généré par le client, le texte tapé, les champs déjà connus comme contexte ; puis l'action de sélection avec la voie choisie et le numéro. Tout est dans la documentation de l'API et dans la spécification OpenAPI.

Cas particuliers

• Autres pays : les suggestions existent dans chaque pays dont le référentiel des adresses est en service (la liste) ; le formulaire passe le pays choisi par l'utilisateur et le widget cherche là, avec la forme du numéro et du code postal de ce pays. L'utilisateur peut tout écrire dans un seul champ (« Kalverstraat 92 Amsterdam ») : la réponse dit comment elle l'a lu (parsed : voie, numéro, code postal). Dans un pays sans référentiel, la réponse le dit et n'ouvre aucune session : la saisie continue à la main, sans rien compter.
• WooCommerce et PrestaShop : rien à écrire, il y a le plugin WooCommerce et le module PrestaShop avec l'autocomplétion à la commande et la vérification des commandes.
• Voie qui n'apparaît pas : l'utilisateur peut toujours écrire l'adresse en entier ; la fiche passera par la vérification plus tard, depuis le fichier ou l'API.
• Plusieurs formulaires, plusieurs sites : le même jeton sert à tous les formulaires ; le relais peut être sur chaque site ou unique.

Ce qui arrive aux champs

La voie est complétée dans sa forme correcte, la commune choisie parmi celles qui ont cette voie, le code postal mis par le moteur. Dans les villes à arrondissements, c'est avec le numéro qu'arrive le code postal de l'arrondissement.