Route Tester
The Route Tester is a lightweight tool for quickly checking which geofences a route crosses and which workflows would fire — without affecting production data.
Access
Navigate to Automations → Route Tester in the Dashboard, or visit /dashboard/route-tester directly.
How It Works
- Upload a GPX or CSV route file (up to 50,000 points, 10MB max)
- The Route Tester analyzes the route against all active geofences
- Results show which geofences the route intersects and which workflows would trigger
Supported File Formats
GPX
Standard GPS exchange format with track points. Must contain at least one track with trackpoints. UTF-8 encoded, 10MB max.
CSV
UTF-8 encoded .csv file (BOM stripped if present).
Required columns (case-insensitive, aliases supported):
| Column | Aliases | Type | Range |
|---|---|---|---|
| latitude | lat, y | float | [-90, 90] |
| longitude | lng, lon, long, x | float | [-180, 180] |
| timestamp | time, datetime, ts | datetime | See formats below |
Optional columns:
| Column | Aliases | Type | Default |
|---|---|---|---|
| elevation | ele, alt, altitude | float (meters) | 0.0 |
| speed | velocity, spd | float (km/h) | Calculated |
| heading | bearing, direction, azimuth | float (0-360°) | Calculated |
Constraints:
- 10MB max file size
- 2–50,000 rows
- Auto-delimiter detection: comma, semicolon, tab
- Validation errors include line numbers
Supported timestamp formats:
- ISO 8601:
2025-01-15T14:30:00Z,2025-01-15T14:30:00+00:00 - ISO 8601 naive:
2025-01-15T14:30:00 - Space separator:
2025-01-15 14:30:00 - European:
15/01/2025 14:30:00 - US:
01/15/2025 14:30:00 - Unix epoch: seconds or milliseconds
What It Reports
- Geofence intersections: Which geofences the route enters and exits, with timestamps
- Workflow triggers: Which active workflows would fire based on the geofence events
- Route summary: Total distance, duration, and number of points