Migrer une automatisation Zapier ou Make vers un nouvel hôte de géocodage
Les automatisations sans code construites autour d'une étape de géocodage demandent une autre approche de migration que le code sur mesure. Voici comment gérer ce changement.
Quitter une intégration HERE Autosuggest
L'endpoint Autosuggest de HERE renvoie des suggestions d'adresses et de lieux à mesure que l'utilisateur tape, structurées sous forme de tableau items dont chaque entrée contient un title, un resultType indiquant si la suggestion est une adresse complète, un lieu ou une catégorie, et souvent un objet de surlignage indiquant quels caractères correspondent à la saisie. Ce mélange de types de résultats, adresses, lieux et catégories réunis dans une même réponse, est l'un des aspects les plus distinctifs de l'approche de HERE, et il mérite d'être soigneusement cartographié avant de supposer que la saisie semi-automatique d'un autre fournisseur fonctionne de manière identique.
Les intégrations d'autosuggestion sont généralement profondément liées à un composant front-end précis, un champ d'adresse avec une liste déroulante, et les détails d'interaction (la rapidité d'apparition des suggestions, le rendu du surlignage, ce qui se passe quand un utilisateur ignore les suggestions et continue simplement à taper) comptent généralement plus pour les utilisateurs finaux que n'importe quel détail d'implémentation côté serveur. La migration est donc en partie une tâche back-end et en partie une revue de l'expérience utilisateur.
My Geocode propose la saisie semi-automatique d'adresses telle que documentée sur /docs/address-autocomplete/, avec sa propre forme de requête et de réponse. Comme le mélange des résultats et le comportement de classement sont réellement propres à l'implémentation de chaque fournisseur, il vaut la peine de tester cet endpoint directement avec des requêtes représentatives de votre propre base d'utilisateurs, plutôt que de supposer que la structure de résultats à types mélangés de HERE est reprise telle quelle. Chaque fournisseur trace différemment la frontière entre ce qui compte comme une suggestion d'adresse et ce qui compte comme un lieu.
Étapes qui fonctionnent généralement bien pour ce type de migration :
- Recensez les valeurs
resultTypeprécises sur lesquelles votre code front-end se base actuellement pour ses branchements, car cette logique de branchement est la partie la plus susceptible de nécessiter un ajustement - Passez en revue le comportement de surlignage ou de sous-chaîne correspondante que votre interface affiche actuellement, et vérifiez si le nouvel endpoint fournit un équivalent ou si ce détail d'interface doit être retravaillé
- Testez le nouvel endpoint sur un échantillon de requêtes historiques réelles issues de vos journaux, et non sur des adresses de test synthétiques, car les habitudes de frappe réelles des utilisateurs (fautes de frappe, mots partiels, abréviations) révèlent des différences de classement que des données de test propres ne montreront pas
L'authentification utilise une clé envoyée via X-API-Key, Authorization: Bearer, l'authentification HTTP Basic ou un paramètre de requête. La tarification comprend 2 500 requêtes gratuites par jour sans clé, 2 500 de plus gratuites par clé et par jour, comptées par réseau, puis du crédit prépayé à 0,0001 € par requête ou une clé Unlimited à 50 € par mois, au même tarif pour tous les endpoints de la plateforme.
Étant donné la fréquence à laquelle l'autosuggestion se déclenche par rapport à un appel de géocodage classique, puisque presque chaque frappe peut déclencher une requête, il vaut la peine d'estimer le volume par rapport à votre quota quotidien gratuit et au tarif par requête avant un lancement complet, plutôt que de découvrir le schéma d'utilisation réel seulement une fois en production.