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.
Migrer depuis OpenCage
OpenCage s'est fait connaître en rendant le géocodage accessible : un seul paramètre de clé, une réponse JSON avec un tableau results et un objet components qui décompose une adresse en champs comme road, city et country. Il combine des données issues de plusieurs sources ouvertes plutôt que d'exploiter son propre jeu de données propriétaire, ce qui explique en partie pourquoi les développeurs attachés à la transparence sur l'origine de leurs données de localisation ont tendance à se tourner vers lui.
Quitter un fournisseur choisi en partie pour sa simplicité soulève une question légitime : la nouvelle option reste-t-elle aussi simple ? La réponse honnête dépend de ce à quoi vous la comparez. Une inscription à un compte généraliste avec un formulaire de facturation est une expérience différente du simple ajout d'une clé dans un en-tête, et il vaut la peine de vérifier laquelle des deux vous remplacez réellement.
L'hôte de compatibilité OpenCage de My Geocode reproduit le tableau results et la décomposition components renvoyés par OpenCage, les textes de copyright, de conditions et de confidentialité étant la seule partie qui change. La référence champ par champ se trouve sur /compatibility/opencage/. Pour la plupart des intégrations, cela signifie mettre à jour l'hôte de la requête et la valeur de la clé, tandis que le code qui lit results[0].components.city ou results[0].formatted continue de fonctionner tel qu'il est écrit.
De notre côté, l'authentification accepte un en-tête X-API-Key, un en-tête Authorization: Bearer, l'authentification HTTP Basic ou un paramètre de requête : un client qui envoie déjà sa clé OpenCage comme paramètre de chaîne de requête continuera donc généralement de fonctionner avec une nouvelle valeur de clé, sans autre modification de la logique de requête.
Le niveau gratuit est un élément important de cette comparaison pour tous ceux qui ont choisi OpenCage pour son accessibilité aux petits projets et aux projets personnels. My Geocode offre 2 500 requêtes gratuites par jour depuis n'importe quelle adresse, sans aucune clé requise, et chaque clé dispose en plus de 2 500 requêtes gratuites par jour, comptées par réseau et partagées entre l'usage sans clé et avec clé depuis ce même réseau. Au-delà, la tarification repose sur du crédit prépayé à 0,0001 € par requête ou une clé Unlimited à 50 € par mois, chaque endpoint, y compris chaque hôte de compatibilité, étant facturé au même prix.
Un point à tester directement plutôt qu'à supposer : les annotations. Si votre intégration OpenCage lit des champs d'annotation supplémentaires, comme des informations de fuseau horaire ou de devise incluses dans la réponse de géocodage, comparez les champs documentés de l'hôte de compatibilité à ce qu'attend votre code d'analyse, car une partie de ces détails devra peut-être provenir d'un endpoint dédié, comme la recherche de fuseau horaire de My Geocode, plutôt que d'être intégrée à la réponse de géocodage elle-même.
Pour un projet qui a commencé petit puis a grandi, la simplicité qui a fait d'OpenCage un premier choix facile n'a pas à être sacrifiée en changeant de fournisseur. Une clé qui fonctionne quel que soit le style dans lequel votre client l'envoie déjà, un quota quotidien gratuit sans inscription requise pour commencer à tester, et un prix unique pour tous les endpoints gardent l'expérience de prise en main proche de ce à quoi beaucoup d'utilisateurs d'OpenCage sont habitués.