Offline DIGIPIN Geolocation Encoding and Decoding Microservice - n8n Workflow

Logistics Companies: Needing fast, offline coordinate-to-address mapping in India.
Developers: Seeking to build custom geolocation microservices without external API dependencies.
n8n Automation Specialists: Looking for advanced examples of using the n8n Code node for complex mathematical functions.
Organizations Utilizing n8n templates for digital address verification systems.

The DIGIPIN system is a critical geolocation tool in India for precise location sharing. This specialized n8n workflow solves the problem of needing an external, paid, or rate-limited geocoding API by implementing the full DIGIPIN generation and decoding logic entirely within JavaScript inside the n8n environment.

This robust n8n workflow operates as two distinct API endpoints, each using a unique n8n trigger Webhook. Because the core logic resides in a custom n8n node (Code node), all processing is handled locally, offering exceptional speed and reliability. Implementing this specialized n8n node setup means you can instantly convert latitude/longitude into a 10-character DIGIPIN, or convert a DIGIPIN back into precise coordinates, making this one of the most powerful geographical n8n templates available for India-focused applications.

This automation functions via two parallel API routes, both starting with an n8n trigger Webhook:

1. Generate DIGIPIN (Encoding):

1. Decode DIGIPIN (Decoding):

Both paths leverage the power of the custom Code n8n node to provide a complete, self-contained geographical microservice.

To start using this powerful n8n workflow, follow these steps:

1. Import the n8n workflow: Copy the provided JSON data and paste it directly into your n8n instance via the 'New' menu -> 'Import from JSON'.


2. Activate the Webhooks: The two Webhook nodes (EncodeWebhook and DecodeWebhook) are already configured as an n8n trigger. Ensure your n8n instance is publicly accessible or running within a test environment.


3. Find Your URL: After activating the n8n workflow, your specific webhook URLs will be available. If self-hosting, use your domain, e.g., https://n8n.yourcompany.com/webhook/generate-digipin.


4. No Credentials Required: Since the core logic is pure JavaScript within the n8n node, no external API keys or credentials are required for this particular n8n template.

This n8n workflow relies heavily on the Code node for proprietary logic and the Webhook nodes for API exposure.

EncodeWebhook & DecodeWebhook (n8n Trigger):
Function: Serves as the public API endpoints, triggering the n8n workflow.
Key Configuration: Set to Response Mode: Respond to Webhook Node and use unique paths (generate-digipin and decode-digipin).

DIGIPINGenerationCode (Code n8n node):
Function: Contains the complete JavaScript implementation of the DIGIPIN encoding algorithm. It takes lat and lon from the incoming request and generates the digipin field in the output.
Key Configuration: Contains hardcoded boundary checks for India and the 4x4 grid array (DIGIPINGRID) necessary for the recursive quadtree-like encoding.

DIGIPINDecode_Code (Code n8n node):
Function: Executes the inverse JavaScript logic to decode a provided DIGIPIN string back into decodedLatitude and decodedLongitude.
Key Configuration: Includes logic to remove hyphens and performs validation checks on the pin length and characters.

Switch - Check for Success (Switch n8n node):
Function: Controls the flow based on the result of the Code node. It routes to success if the digipin field exists, or to failure if the error field exists.
Key Configuration: Uses an 'exists' operation on key fields like {{ $json.digipin }} and {{ $json.error }} to ensure the correct webhook responder n8n node is executed.

Respond to Webhook (Respond to Webhook n8n node):
Function: Sends the final HTTP response back to the API caller. Error responders use HTTP 422, while success responders use HTTP
200.
* Key Configuration: Dynamically constructs the JSON response body to include the status, input parameters, and the generated output (DIGIPIN or coordinates).