[WIP] Geofencing CF docs

_includes/docs/user-guide/calculated-fields/index.md

@@ -26,7 +26,7 @@ Using expressions, scripts, or specialized processing modes, users can standardi
 - **Energy analytics** — calculating hourly/daily consumption and identifying peak loads. 
 - **Smoothing and filtering** — applying rolling averages, statistical aggregations, and noise reduction to telemetry. 
 - **Predictive maintenance** — generating derived metrics and detecting potential failures based on trends. 
-- **Geofencing scenarios** — checking zone membership, generating ENTER/EXIT events, and monitoring route compliance. 
+- **Geofencing** — evaluating real-time GPS coordinates against defined zones to track entity presence (INSIDE/OUTSIDE) and detect zone transition events (ENTERED/LEFT).
 - **Propagation** — automatically transferring attributes or telemetry to related entities for data synchronization. 
 - **Group data aggregation** — computing min/max/avg/sum/count for sets of related devices or assets. 
 - **Historical time-series analysis** — performing time window aggregation, trend analysis, and statistical evaluation. 

docs/user-guide/calculated-fields/geofencing-calculated-field.md

@@ -1,7 +1,7 @@
 ---
 layout: docwithnav
 title: Geofencing calculated field
-description: For complex calculations, TBEL is used. It enables advanced operations such as conditional statements, loops, and access to historical data.
+description: For evaluating real-time GPS coordinates against defined zones to track entity presence (INSIDE/OUTSIDE) and detect zone transition events (ENTERED/LEFT).
 breadcrumbs: "true"
 breadcrumbs-steps: "1"
 hidetoc: "true"

docs/user-guide/resources/calculated-fields/geofencing/complex-fleet-management-example-assets-data.csv

@@ -0,0 +1,4 @@
+name;type;zoneType;perimeter
+North East Fleet;Fleet;;
+Service Zone A;Zone;allowed;"[[40.70345836671014,-74.14999275085601],[40.70237254064465,-74.15064451111766],[40.700758707969165,-74.1460418404481],[40.70184397401624,-74.14536055935832],[40.70256571358523,-74.14739370346071]]"
+No-Go Zone A;Zone;restricted;"[[40.703492899942965,-74.15011153362617],[40.701933407657414,-74.15106506223482],[40.70216935786786,-74.15171935248779],[40.70372335389025,-74.15071110193402]]"

docs/user-guide/resources/calculated-fields/geofencing/complex-fleet-management-example-devices-data.csv

@@ -0,0 +1,3 @@
+name;type;latitude;longitude
+Truck 101;Truck;40.703231;-74.150586
+Truck 102;Truck;40.701081;-74.146437

docs/user-guide/resources/calculated-fields/geofencing/complex-fleet-management-example-fleet-asset-profile.json

@@ -0,0 +1,10 @@
+{
+  "name": "Fleet",
+  "description": null,
+  "image": null,
+  "defaultRuleChainId": null,
+  "defaultDashboardId": null,
+  "defaultQueueName": null,
+  "defaultEdgeRuleChainId": null,
+  "default": false
+}

docs/user-guide/resources/calculated-fields/geofencing/complex-fleet-management-example-geofencing-cf.json

@@ -0,0 +1,72 @@
+{
+  "type": "GEOFENCING",
+  "name": "Fleet Geofencing",
+  "debugSettings": {
+    "failuresEnabled": true,
+    "allEnabled": true,
+    "allEnabledUntil": 0
+  },
+  "configurationVersion": 0,
+  "configuration": {
+    "type": "GEOFENCING",
+    "entityCoordinates": {
+      "latitudeKeyName": "latitude",
+      "longitudeKeyName": "longitude"
+    },
+    "zoneGroups": {
+      "restrictedArea": {
+        "perimeterKeyName": "perimeter",
+        "reportStrategy": "REPORT_TRANSITION_EVENTS_AND_PRESENCE_STATUS",
+        "createRelationsWithMatchedZones": true,
+        "refDynamicSourceConfiguration": {
+          "type": "RELATION_PATH_QUERY",
+          "levels": [
+            {
+              "direction": "TO",
+              "relationType": "Contains"
+            },
+            {
+              "direction": "FROM",
+              "relationType": "FleetToRestrictedZone"
+            }
+          ]
+        },
+        "relationType": "InsideZone",
+        "direction": "TO"
+      },
+      "serviceArea": {
+        "perimeterKeyName": "perimeter",
+        "reportStrategy": "REPORT_TRANSITION_EVENTS_AND_PRESENCE_STATUS",
+        "createRelationsWithMatchedZones": true,
+        "refDynamicSourceConfiguration": {
+          "type": "RELATION_PATH_QUERY",
+          "levels": [
+            {
+              "direction": "TO",
+              "relationType": "Contains"
+            },
+            {
+              "direction": "FROM",
+              "relationType": "FleetToAllowedZone"
+            }
+          ]
+        },
+        "relationType": "InsideZone",
+        "direction": "TO"
+      }
+    },
+    "scheduledUpdateEnabled": true,
+    "scheduledUpdateInterval": 60,
+    "output": {
+      "type": "TIME_SERIES",
+      "strategy": {
+        "type": "IMMEDIATE",
+        "ttl": 0,
+        "saveTimeSeries": true,
+        "saveLatest": true,
+        "sendWsUpdate": true,
+        "processCfs": true
+      }
+    }
+  }
+}

docs/user-guide/resources/calculated-fields/geofencing/complex-fleet-management-example-truck-device-profile.json

@@ -0,0 +1,29 @@
+{
+  "name": "Truck",
+  "description": "",
+  "image": null,
+  "type": "DEFAULT",
+  "transportType": "DEFAULT",
+  "provisionType": "DISABLED",
+  "defaultRuleChainId": null,
+  "defaultDashboardId": null,
+  "defaultQueueName": null,
+  "provisionDeviceKey": null,
+  "firmwareId": null,
+  "softwareId": null,
+  "defaultEdgeRuleChainId": null,
+  "default": false,
+  "profileData": {
+    "configuration": {
+      "type": "DEFAULT"
+    },
+    "transportConfiguration": {
+      "type": "DEFAULT"
+    },
+    "provisionConfiguration": {
+      "type": "DISABLED",
+      "provisionDeviceSecret": null
+    },
+    "alarms": null
+  }
+}

docs/user-guide/resources/calculated-fields/geofencing/complex-fleet-management-example-zone-asset-profile.json

@@ -0,0 +1,10 @@
+{
+  "name": "Zone",
+  "description": null,
+  "image": null,
+  "defaultRuleChainId": null,
+  "defaultDashboardId": null,
+  "defaultQueueName": null,
+  "defaultEdgeRuleChainId": null,
+  "default": false
+}