Route Optimization
Multi-stop route optimization with OSRM engine, multiple point sources (landmarks, map, coordinates, CSV), analysis, and Google Maps integration.
Last updated April 17, 2026
Route Optimization Overview
The Route Optimization module calculates the most efficient sequence for visiting multiple stops. It uses the OSRM (Open Source Routing Machine) engine for driving route calculations and supports multiple ways to add waypoints.
Point Sources
From Landmarks
The Landmarks source has 2 sub-tabs: POIs and Geofences. Each provides a searchable list of existing landmarks with an "already added" label for items already included in the route.
Map Location
- Click the map to add a waypoint at that location
- Click the route line to insert a waypoint between existing points
- Note: Available in 2D map mode only
Enter Lat/Lng
Manual coordinate entry form accepting latitude and longitude values. Enter decimal degree coordinates and add to the route.
Bulk Upload
- CSV format with hint describing expected columns (name, latitude, longitude)
- Paste CSV — paste data directly into the text area
- Errors found — validation messages displayed for invalid rows
- Preview count — number of valid points parsed from the CSV
- Validation: invalid lat, invalid lon, invalid name messages for malformed data
Point Management
| Action | Description |
|---|---|
| Drag to Move | Drag a waypoint marker on the map to reposition it |
| Set as Start | Designate this point as the route starting point (green marker) |
| Set as End | Designate this point as the route ending point (red marker) |
| Edit Point | Edit point details; shows source label with ID |
| Delete Point | Remove this waypoint from the route |
| Clear All | Remove all waypoints with a confirmation dialog (title and description) |
Route Analysis
| Metric | Description |
|---|---|
| Original | Total distance and time for the points in their original order |
| Optimized | Total distance and time after OSRM optimization |
| Saved Percentage | Percentage of distance/time saved by optimization |
| Time Metric | Estimated driving time for the optimized route |
| Copy Google Maps Link | Copies the optimized route as a Google Maps URL |
| Open in Google Maps | Opens the optimized route directly in Google Maps |
Create Route
After optimization, save the route with a name (route name label with placeholder). The create route description explains that saved routes appear in Landmarks Studio.
Map Legend
| Element | Description |
|---|---|
| Powered by OSRM | Attribution to the routing engine |
| Original route | Displayed in one color (e.g., blue) |
| Optimized route | Displayed in a different color (e.g., green) |
| Driving route | Follows actual road network |
| Start point | Green marker indicating route origin |
| End point | Red marker indicating route destination |
States
| State | Description |
|---|---|
| Initializing map | Map component is loading |
| Loading map | Map tiles are being fetched |
| Ready to optimize | Waypoints added; shows hint to begin optimization |
| Already optimal | The current point sequence is already the most efficient |