Skip to main content
Field mapping is what makes one widget work for every vertical. You tell the Fleet widget which key in your payload means latitude, which means speed, and so on — once, in the config panel. No code, no redeploy.

Dot-notation paths

Reach into nested objects with dots and into arrays with numeric indices:

Core fields

The Map view needs a device ID and coordinates; everything else is optional.
path
required
Unique identifier — e.g. deviceId, id, node, machine_id.
path
e.g. gps.lat / gps.lng, or location.0 / location.1.
path
Rotates the marker — e.g. heading, telemetry.yaw.
path
Shown in the marker popup.
path
Drives marker/row color (green / amber / red).

Extra display fields

Any payload key can surface in the marker popup and detail panel — add an extra field with a label and a path (Passengers → meta.passengers, Battery → telemetry.battery).

Same widget, four payloads

The same Fleet widget reads all of them — only the mapping differs.

Back to Fleet overview

The six views and the data contract.