Map Widget

Overview

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

Configuration Fields

• Alias
• Devices
• Selected Device Ids
• Title
• Show Title
• Location Mode
• Latitude Key
• Longitude Key
• GPS Key
• State Key
• Status Key
• Heading Key
• Speed Key
• Timestamp Key
• Popup Keys
• Marker Shape — pin, circle, square, triangle, diamond, arrow, fleet (vehicle). Legacy simple / asset still work.
• Default Zoom
• Default Lat
• Default Lon
• Auto Fit
• Allow Zero Coordinates
• Basemap (tenant default / OpenStreetMap / Google Maps / custom style URL)
• Map Style Url (when basemap is custom style URL)
• Items
• Global Keys
• Loading Devices
• Loading Keys
• Device Ids

Defaults

• Alias — null
• Selected Device Ids — []
• Title — ""
• Show Title — true
• Location Mode — "separate"
• Latitude Key — "lat". If that key is empty, the map also reads latitude.
• Longitude Key — "lon". If that key is empty, the map also reads longitude and lng.
• GPS Key — "gps"
• State Key — ""
• Status Key — ""
• Heading Key — ""
• Speed Key — ""
• Timestamp Key — ""
• Popup Keys — []
• Marker Shape — "asset" (compat circle; prefer pin / circle / square / triangle / diamond / arrow / fleet)
• Default Zoom — 4
• Default Lat — 20.5937
• Default Lon — 78.9629
• Auto Fit — true
• Basemap — inherit (Tenant Settings → Maps)
• Map Style Url — ""

Header chips Stale/offline and N without location only appear when the count is greater than zero. Stale/offline uses the same device status ACTIVE rule as the Active tile (not telemetry age). Without-location waits until coordinates have been loaded from attributes / latest telemetry.

Tenant Google Maps setup: Maps.

Source

• File — MapWidgetConfig.tsx