Microservice de codage et de décodage de géolocalisation DIGIPIN hors ligne - Workflow n8n

Entreprises de logistique : Nécessitant une cartographie rapide et hors ligne des coordonnées vers adresses en Inde.
Développeurs : Cherchant à créer des microservices de géolocalisation personnalisés sans dépendances d'API externes.
Spécialistes de l'automatisation n8n : À la recherche d'exemples avancés d'utilisation du nœud Code n8n pour des fonctions mathématiques complexes.
Organisations Utilisant des modèles n8n pour des systèmes de vérification d'adresses numériques.

Le système DIGIPIN est un outil de géolocalisation essentiel en Inde pour un partage précis de la position. Ce flux de travail n8n spécialisé résout le problème de la nécessité d'une API de géocodage externe, payante ou soumise à des limites de débit, en implémentant l'intégralité de la logique de génération et de décodage DIGIPIN entièrement en JavaScript au sein de l'environnement n8n.

Ce flux de travail n8n robuste fonctionne comme deux points de terminaison API distincts, chacun utilisant un déclencheur Webhook n8n unique. Étant donné que la logique principale réside dans un nœud n8n personnalisé (nœud Code), tout le traitement est géré localement, offrant une vitesse et une fiabilité exceptionnelles. La mise en œuvre de cette configuration spécialisée de nœuds n8n vous permet de convertir instantanément la latitude/longitude en un DIGIPIN à 10 caractères, ou de reconvertir un DIGIPIN en coordonnées précises, faisant de ceci l'un des modèles n8n géographiques les plus puissants disponibles pour les applications axées sur l'Inde.

Cette automatisation fonctionne via deux itinéraires d'API parallèles, commençant tous deux par un Webhook de déclenchement n8n :

1. Génération du DIGIPIN (Encodage) :

1. Décodage du DIGIPIN (Décodage) :

Les deux chemins exploitent la puissance du nœud Code n8n personnalisé pour fournir un microservice géographique complet et autonome.

Pour commencer à utiliser ce puissant flux de travail n8n, suivez ces étapes :

1. Importer le flux de travail n8n : Copiez les données JSON fournies et collez-les directement dans votre instance n8n via le menu 'Nouveau' -> 'Importer depuis JSON'.


2. Activer les Webhooks : Les deux nœuds Webhook (EncodeWebhook et DecodeWebhook) sont déjà configurés comme déclencheurs n8n. Assurez-vous que votre instance n8n est accessible publiquement ou en cours d'exécution dans un environnement de test.


3. Trouver votre URL : Après avoir activé le flux de travail n8n, vos URL de webhook spécifiques seront disponibles. En cas d'auto-hébergement, utilisez votre domaine, par exemple https://n8n.votreentreprise.com/webhook/generate-digipin.


4. Aucun identifiant requis : Étant donné que la logique principale est du JavaScript pur au sein du nœud n8n, aucune clé API ou identifiant externe n'est requis pour ce modèle n8n particulier.

Ce flux de travail n8n repose fortement sur le nœud Code pour la logique propriétaire et sur les nœuds Webhook pour l'exposition de l'API.

EncodeWebhook & DecodeWebhook (Déclencheur n8n) :
Fonction : Sert de points de terminaison API publics, déclenchant le flux de travail n8n.
Configuration clé : Défini sur Mode de réponse : Répondre au nœud Webhook et utilise des chemins uniques (generate-digipin et decode-digipin).

DIGIPINGenerationCode (Nœud Code n8n) :
Fonction : Contient l'implémentation JavaScript complète de l'algorithme d'encodage DIGIPIN. Il prend lat et lon de la requête entrante et génère le champ digipin dans la sortie.
Configuration clé : Contient des vérifications des limites codées en dur pour l'Inde et le tableau de grille 4x4 (DIGIPINGRID) nécessaires pour le codage de type quadtree récursif.

DIGIPINDecode_Code (Nœud Code n8n) :
Fonction : Exécute la logique JavaScript inverse pour décoder une chaîne DIGIPIN fournie en coordonnées decodedLatitude et decodedLongitude.
Configuration clé : Inclut la logique pour supprimer les tirets et effectue des vérifications de validation sur la longueur et les caractères du code.

Switch - Check for Success (Nœud Switch n8n) :
Fonction : Contrôle le flux en fonction du résultat du nœud Code. Il achemine vers le succès si le champ digipin existe, ou vers l'échec si le champ error existe.
Configuration clé : Utilise une opération 'existe' sur des champs clés comme {{ $json.digipin }} et {{ $json.error }} pour s'assurer que le nœud répondeur webhook correct est exécuté.

Respond to Webhook (Nœud Répondre au Webhook n8n) :
Fonction : Envoie la réponse HTTP finale à l'appelant de l'API. Les répondeurs d'erreur utilisent HTTP 422, tandis que les répondeurs de succès utilisent HTTP
200.
* Configuration clé : Construit dynamiquement le corps de réponse JSON pour inclure le statut, les paramètres d'entrée et la sortie générée (DIGIPIN ou coordonnées).