Géocodage automatisé des données logistiques avec Open Route Service - Workflow n8n

Responsables logistique et chaîne d'approvisionnement gérant de grandes bases de données d'adresses.
Analystes de données ayant besoin de coordonnées géographiques fiables pour la cartographie ou le reporting.
Entreprises utilisant Google Sheets comme base de données principale pour les données de localisation.
Utilisateurs recherchant des modèles n8n avancés axés sur l'intégration d'API externes et la logique de bouclage.

Ce workflow n8n offre une solution robuste pour les organisations qui doivent convertir rapidement et précisément des adresses stockées dans Google Sheets en coordonnées GPS exactes et en détails géographiques supplémentaires. Le traitement manuel de centaines ou de milliers d'adresses est inefficace ; ce modèle d'automatisation n8n résout ce problème en intégrant Google Sheets directement à l'API Open Route Service.

Le workflow lit les données requises (adresse et code pays), interroge le service de géocodage par lots, et réécrit méticuleusement les informations détaillées de longitude, latitude, arrondissement (borough) et quartier (neighborhood). De plus, la conception spécifique de ce workflow n8n intègre une logique cruciale de limitation de débit (via un nœud Wait n8n) pour garantir que le traitement à haut volume soit stable et conforme aux politiques d'utilisation de l'API, ce qui en fait une solution n8n fiable pour l'enrichissement continu des données.

Le processus débute avec le Déclencheur Manuel n8n (Manual n8n Trigger), conçu pour exécuter le workflow à la demande, généralement pour de grosses opérations par lots. D'abord, le nœud Google Sheets n8n, intitulé 'Collect Addresses' (Collecter les adresses), lit tous les champs d'entrée nécessaires (adresse et pays) depuis votre feuille de calcul spécifiée.

Ces enregistrements sont transmis au nœud Split In Batches n8n 'Loop Over Addresses' (Boucler sur les adresses), qui assure que chaque adresse est traitée séquentiellement. Pour chaque élément du lot, le nœud HTTP Request n8n 'Query Open Route API' (Interroger l'API Open Route) exécute une recherche de géocodage, injectant dynamiquement l'adresse et le code pays dans les paramètres de l'appel API.

Après réception de la réponse API, le nœud Set n8n 'Extract Results' (Extraire les résultats) analyse la sortie JSON, extrayant des informations clés telles que les coordonnées GPS et des balises de localisation descriptives (comme borough et localadmin). Le nœud Google Sheets n8n suivant, 'Save Results' (Sauvegarder les résultats), met à jour la ligne correspondante dans la feuille de calcul avec les données géocodées nouvellement acquises.

Enfin, un nœud Wait n8n '5 sec' introduit un délai crucial de 5 secondes avant que la boucle ne passe à l'adresse suivante. Ce mécanisme de temporisation est essentiel pour respecter les limites de débit de l'API, garantissant la stabilité et l'achèvement réussi de l'ensemble du workflow n8n, surtout lors du traitement de volumes de données élevés.

1. Importer le modèle n8n : Copiez le code JSON fourni et collez-le dans votre instance n8n en utilisant la fonction 'Nouveau' -> 'Importer depuis JSON'.


2. Configurer les identifiants Google Sheets : Configurez le nœud Google Sheets n8n ('Collect Addresses' et 'Save Results') en ajoutant vos identifiants API Google Sheet. Sélectionnez l'ID de votre document cible et le nom de la feuille. Assurez-vous que votre feuille comporte des colonnes mappées pour address, country, longitude, latitude, borough, neighbourhood, et localadmin.


3. Configurer la clé API : Dans le nœud HTTP Request n8n 'Query Open Route API', vous devez obtenir une clé API gratuite depuis la documentation Open Route Service et l'insérer dans le paramètre de requête api_key.


4. Tester le workflow n8n : Cliquez sur le nœud de déclenchement n8n 'When clicking ‘Test workflow’' pour lancer un test et vérifier le flux des données ainsi que l'écriture réussie dans votre feuille de calcul.

When clicking ‘Test workflow’ (Déclencheur Manuel n8n) : Le point de départ pour le workflow n8n de traitement par lots.
Collect Addresses (Nœud Google Sheets n8n) : Lit les données d'adresse brutes depuis la feuille. Configurée pour une opération de lecture (Read).
Loop Over Addresses (Nœud Split In Batches n8n) : Divise les données de la feuille de calcul en éléments individuels pour permettre des appels API séquentiels, essentiel pour une utilisation efficace de l'API dans le modèle n8n.
Query Open Route API (Nœud HTTP Request n8n) : Action de géocodage principale. Configuration clé : Utilise https://api.openrouteservice.org/geocode/search et récupère dynamiquement {{ $json.address }} et {{ $json.country }} pour la recherche.
Extract Results (Nœud Set n8n) : Nœud de transformation de données utilisé pour mapper les résultats de l'API (coordonnées, arrondissement, etc.) en variables propres adaptées au stockage.
Save Results (Nœud Google Sheets n8n) : Met à jour la feuille Google Sheet. Configuration clé : L'opération est définie sur update, faisant correspondre les lignes en fonction de l'ID de l'élément ou du numéro de ligne pour assurer un enrichissement précis des données.

• 5 sec (Nœud Wait n8n) : Implémente un délai crucial de 5 secondes entre les itérations de la boucle pour gérer la limite de débit de l'API Open Route Service, garantissant que ce workflow n8n fonctionne de manière fiable à grande échelle.