Route Map Widget

Overview

Route Map Widget includes its own configuration fields in the widget configuration flow.

Configuration Fields

• Alias
• Devices
• Selected Device ID
• Title
• Show Title
• Location Mode
• Latitude Key
• Longitude Key
• GPS Key
• Heading Key
• Speed Key
• Timestamp Key
• Default Zoom
• Default Lat
• Default Lon
• Auto Fit
• Show Start Marker
• Show End Marker
• Show Live Marker
• Marker Shape — pin, circle, square, triangle, diamond, arrow, fleet (vehicle); applies to start / end / live / stop / playback markers
• Allow Zero Coordinates
• Max Points
• Route Color
• Route Opacity
• Line Width
• Basemap (tenant default / OpenStreetMap / Google Maps / custom style URL)
• Map Style Url (when basemap is custom style URL)
• Playback (enablePlayback)
• Detect stops (detectStops)
• Color by speed (colorBySpeed)
• Reverse geocode (enableReverseGeocode, Nominatim opt-in)
• Loading Devices
• Loading Keys
• Global Keys
• Device ID
• Device Ids
• Telemetry Keys
• Metric

Industry options

When enabled:

• Playback — play/pause + scrubber moves a marker along the historical path
• Detect stops — dwell segments (low speed / little movement) shown as purple markers; trip count in header
• Color by speed — path segments colored green → blue → amber → red by speed
• Reverse geocode — optional Nominatim lookup (rate-limited ~1 req/s)

Defaults

• Alias — null
• Selected Device ID — (first selected device)
• Title — "Route Map"
• Show Title — true
• Latitude Key — "lat"
• Longitude Key — "lon"
• GPS Key — "gps"
• Heading Key — ""
• Speed Key — ""
• Timestamp Key — ""
• Default Zoom — 4
• Default Lat — 20.5937
• Default Lon — 78.9629
• Auto Fit — true
• Show Start Marker — true
• Show End Marker — true
• Show Live Marker — true
• Marker Shape — "pin"
• Max Points — 1500
• Route Color — "#2563eb"
• Route Opacity — 0.9
• Line Width — 4
• Basemap — inherit (Tenant Settings → Maps)
• Map Style Url — ""
• enablePlayback — false
• detectStops — false
• colorBySpeed — false
• enableReverseGeocode — false

Source

• File — RouteMapWidgetConfig.tsx / RouteMapWidget.tsx / mapTripUtils.ts