L’étape Saisie semi-automatique prend un texte saisi en partie, par exemple 412 n ma, et écrit les adresses de vos propres jeux de données qui y correspondent le mieux, la meilleure en premier.
Une API d’adresses d’API Builder répond déjà à la saisie semi-automatique telle quelle. Utilisez l’étape quand la réponse a besoin de vos propres étapes autour : un flux qui répond à une requête d’API peut prendre le texte, suggérer des adresses, ne garder que celles du secteur de l’appelant, puis les renvoyer.
Configurer l’étape
- Depuis la catégorie Adressage, ajoutez Saisie semi-automatique au flux.
- Sous Dictionnaire, choisissez le pays et les jeux de données d’adresses, et associez leurs champs, exactement comme pour le Géocodeur.
- Sous Entrée et sortie, choisissez le champ Texte saisi : celui qui contient ce que la personne a tapé jusqu’ici.
- Réglez le nombre de Suggestions à renvoyer pour chaque texte, de 1 à 10.
- Choisissez quoi Écrire : Une ligne par suggestion, qui convient à une réponse d’API parce que les lignes sont la liste, ou Une ligne par texte, avec les suggestions en liste.
- Sous Essayer un texte, tapez un texte et choisissez Suggérer pour voir ce que l’étape suggère et de quel jeu de données vient chaque suggestion. La réponse suit la règle que le flux utilise : le même texte donne les mêmes suggestions lorsque le flux s’exécute.
Les jeux de données sont interrogés dans l’ordre de la liste, comme pour le géocodeur : le suivant ne suggère que si les précédents ne suggèrent rien, donc une même adresse n’est jamais suggérée deux fois.
Dans une API
Quand le flux répond à une requête d’API, son dictionnaire est préparé lors de la création de l’API, avec les couches que le flux lit, et non à chaque appel. L’API répond à partir du dictionnaire tel qu’il était à ce moment : choisissez Actualiser les données sur la page de l’API quand les jeux de données changent.
Ce que produit l’étape
- Suggestions : chaque suggestion avec son rang, son texte, l’identifiant de son enregistrement, le jeu de données d’où elle vient et son emplacement.
- Aucune suggestion : les textes sans rien à suggérer, avec la raison : pas de texte, texte de moins de deux caractères, ou rien ne correspond.