Migration

Migrer depuis Geocodio

Geocodio s'est bâti une solide réputation spécifiquement autour de la précision des adresses aux États-Unis et au Canada, ainsi que d'un workflow d'import CSV en masse qui permet de géocoder une feuille de calcul d'adresses sans écrire la moindre ligne de code d'intégration. Sa clé d'API est envoyée en paramètre de requête (api_key), et les réponses pour une adresse unique reviennent avec un tableau results contenant des address_components et un champ accuracy qui décrit la confiance de la correspondance.

Le workflow CSV en masse mérite d'être traité comme un élément de migration à part entière, distinct des appels d'API programmatiques effectués par votre application. Une équipe marketing ou un analyste des opérations qui importe une feuille de calcul via un formulaire web une fois par mois n'est pas concerné par les modifications de votre code backend, et ce workflow a besoin de son propre plan, qu'il s'agisse d'écrire un script de traitement par lots sur la nouvelle API ou de le gérer manuellement pendant une période de transition.

Côté programmatique, l'hôte compatible Geocodio de My Geocode reproduit la structure du tableau results et des address_components renvoyés par Geocodio, seul le texte relatif aux droits d'auteur, aux conditions et à la confidentialité changeant. Les détails de référence se trouvent sur /compatibility/geocodio/. Le code qui lit results[0].address_components.city devrait continuer de fonctionner une fois l'hôte et la clé mis à jour.

Quelques points à anticiper spécifiquement en raison de l'orientation régionale de Geocodio :

  • Si votre intégration s'appuie sur des champs d'enrichissement propres aux États-Unis, comme les informations de circonscription électorale du Congrès, vérifiez si cette donnée fait partie du périmètre de votre migration ou si elle nécessitera désormais une recherche séparée
  • Vérifiez si des traitements en masse tournent avec une limite de débit calibrée spécifiquement sur les limites documentées de Geocodio, car des délais de nouvelle tentative conçus autour des chiffres d'un fournisseur ne conviennent pas forcément à un autre
  • Testez un lot d'adresses historiques réelles issues de vos propres données sur le nouvel hôte avant de supposer une parité totale, en particulier pour les cas limites comme les boîtes postales ou les adresses de tournées rurales

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 : quel que soit le mode qu'utilise votre client Geocodio existant pour son paramètre api_key, il a un équivalent ici.

Côté coûts, il n'y a pas de palier tarifaire distinct pour le traitement en masse : chaque endpoint, y compris cet hôte compatible, est facturé au même prix, avec 2 500 requêtes gratuites par jour sans aucune clé, 2 500 autres requêtes gratuites par clé et par jour, décomptées par réseau, et au-delà du crédit prépayé à 0,0001 € par requête ou une clé Unlimited à 50 € par mois. Un gros traitement ponctuel en masse et un flux régulier d'appels d'API coûtent de toute façon le même prix par requête, ce qui fait de l'estimation du coût d'une migration en masse une simple multiplication plutôt qu'une recherche dans une grille de paliers.