CalculateLocationsDistances
RuleRules are designed to be building blocks for workflow logic.
Changed on:
8 Aug 2025
Overview
The rule calculates distances, in meters, from each location to the order delivery address based on the incoming longitude/latitude. Sends event with attributes containing calculated distances.| Plugin Name | Order Reference Module |
|---|---|
| Namespace | [[account.id]].order |
UI Description
Calculates the distances from each location to the order delivery address. Sends event with attributes containing calculated distances.
Accepts
- ORDER
- FULFILMENT_OPTIONS
Actions
- This rule forwards the input event with name eventName containing attributes with calculated distances.
Rule parameters
| Parameter | Description |
| eventName | The event name triggered by this rule |
Event attributes
| Parameter | Description | Data Type | Required? |
| locations | The map of locations objects with longitude and latitude properties. | Map | Required |
| longitude | The longitude in the request compared to the longitude in the location property for calculate the distances of each location. | Double | Required |
| latitude | The latitude in the request compared to the latitude in the location property for calculate the distances of each location. | Double | Required |
Exceptions
This rule does not explicitly identify any exceptions.
Configuration example
1{
2 "name":"<ACCOUNTID>.order.CalculateLocationsDistances",
3 "props": {
4 "eventName":"UPDATE_ORDER"
5 }
6}Detailed Technical Description
The rule calculates distances using the Great-Circle Distance (GCD) method. Essentially, it determines the shortest path between two points on the Earth's surface, akin to a straight line drawn on a globe. This method accounts for the Earth's curvature, providing precise measurements compared to simpler distance calculations.The distance is calculated in meters for each location, and the information is passed along in an inline event to the next ruleset. The applied formula is the Haversine formula.