Landmarks — Geofences, POI & Routes
Geofence creation, POI placement, route drawing, import/export wizard, and the Landmarks Studio interface.
Last updated April 17, 2026
Landmarks Studio
The Landmarks Studio (title with subtitle and item count display) is the geospatial management center for creating and managing geofences, points of interest (POI), and routes. Changes are persisted with the Save Changes button, and errors are handled with appropriate messaging.
Geofences
Geofence Form Fields
| Field | Label | Validation | Notes |
|---|---|---|---|
| Name | nameLabel | Required, min length, max length | Placeholder: nameLabel/placeholder |
| Description | descriptionLabel | Optional, max length | Placeholder: descriptionLabel/placeholder |
| Radius | radiusLabel | Must be positive (radiusPositive), max meters (radiusMax) | Applies to circle geofences only |
| Tolerance | toleranceLabel | Must be positive (tolerancePositive), max meters (toleranceMax) | Helper text explaining tolerance behavior |
| Color | colorLabel | Required selection | 'Color selected' confirmation and pick color ARIA label |
| Active | activeLabel | Boolean toggle | Enables or disables geofence alerting |
| Marker | Optional | — | Optional custom marker icon for the geofence center |
Geofence Types
| Type | Validation | Description |
|---|---|---|
| Circle | circleRequired | Click the map to place center, then set radius in meters |
| Line | lineRequired | Draw a polyline path on the map; tolerance defines the buffer zone |
| Polygon | polygonRequired | Draw a closed polygon shape on the map by clicking vertices |
Points of Interest (POI)
- clickToPlace — click on the map to place the POI marker
- clickMapRequired — validation error if no map location is selected
- dragToAdjust — drag the marker to fine-tune its position after placement
- Category — searchable dropdown (searchPlaceholder) with required validation
Routes
- drawPath — click on the map to draw route waypoints
- drawRequired — validation error if no path is drawn
- Source / Destination search — searchable address inputs for start and end points
- Generating route — loading state while OSRM calculates the route
- Route generated — success state after calculation completes
- Route search hint — helper text for address search usage
- Could not generate / Failed to generate — error states for failed routing
Import Wizard
The import wizard has 6 steps for bulk importing geofences, POIs, or routes from CSV files.
| Step | Label | Description |
|---|---|---|
| 1 | stepSelect | Choose the import type: Geofences, POIs, or Routes |
| 2 | stepUpload | Download sample CSV, upload CSV file (drag-drop or browse), paste CSV data, then Parse and Continue |
| 3 | stepMap | Map CSV columns to platform fields. Shows detected rows count, column search, and mapping required validation |
| 4 | stepValidate | Validate data with blocking errors and warnings. Options: re-validate, fix errors (description), warnings found (description), validation passed state |
| 5 | stepProcess | Live streaming processing with connection states (Live/Syncing/Offline). Row-by-row status: success/failed/pending/waiting. Live logs display |
| 6 | stepComplete | Summary with total stats, success/fail counts, download failed CSV option, and Done button |
Export
- Select data type: Geofences, POIs, or Routes
- Exporting state indicator shown during file generation
- File format note describes the output format
- Exported success confirmation upon completion
Tip
The import wizard supports live streaming during the processing step. You can monitor each row's import status in real-time with Live, Syncing, and Offline connection indicators.
Warning
Geofence tolerance defines the buffer zone around line and polygon geofences. A tolerance of 50 meters means alerts trigger when a vehicle is within 50 meters of the boundary.