Map cards

The Map card plots table rows that have coordinates as markers. It can draw on a geographic map or on an image such as a floor plan, colour each marker by a status or a value, outline zones and draw routes that can be replayed. The ready solutions use it for sites, weather stations and personnel tracking.

Data

Slot	Holds	Required
Points	A row per marker with latitude and longitude columns	Yes
Zones	A row per zone with an outline: a list of [latitude, longitude] corners	No
Routes	A row per route with a path: a list of [latitude, longitude] points in order, optionally a third value (a time)	No
Floor plan address	The image of an image map, from a value	No

Good sources for Points: Status under an asset (sites in their status colour), Latest values of many devices with lat and lng keys, or Devices (live connection state) when your devices carry coordinates. A row without valid coordinates is skipped; with none at all the card says “No rows with valid coordinates.”

Set Latitude column (default lat), Longitude column (lng) and Label column (label). The Row id column identifies the marker in click actions.

Map kind

Map	Draws
Geographic (default)	Map tiles. Map style: Follow the theme, Light, Light, no labels, Dark, Streets (colour), Satellite.
Image (floor plan)	A picture instead of tiles. The latitude and longitude columns then hold y and x in the picture’s pixels, from its top-left corner. Set Image (an internal path or an https address), Image width (px) and Image height (px).

Markers and colours

Setting	Values and defaults
Marker	Pin (default), Dot, Circle, Icon; Marker size (px) 8 to 64 (24)
Group nearby markers	Off. On: overlapping markers become one bubble with a count; a click zooms in. Grouping distance 10 to 200 px (40).
Colour from	One colour, A status column (default), Ranges on a value
Status column	Default status. Its value picks the colour: a value named in Status colours, a status word (Online, Warning, Offline…), a colour name (success, warning, error, info, neutral, primary) or a CSS colour.
Status colours	Up to 20 rows: Value, Colour, Shown as, Glyph (an icon instead of the marker), Picture (an image, wins over the glyph)
Value column	With Ranges on a value: the column whose value picks a colour range
Show a legend	On, bottom left. It counts the markers per status and hides with one colour.

Names and tooltips

Setting	Values and defaults
Show names	Always, Alerts only (the markers whose status says warning or worse), Never (default)
Open tooltips on	Hover (default), Click (the tooltip stays open so its link can be used), Never
Tooltip fields	Up to 6 columns shown as label and value rows
Marker link, Link text	An internal path such as /admin/devices/{id}; {column} takes the clicked row’s value

Privacy mode

For maps of people, turn on Privacy mode. “Names stay out of the page: a marker is labelled with its role, and the label column and the columns below are left out of tooltips, links and clicks.” Set the Role column (a worker, a visitor) and the Columns that identify (a badge number, a company, a phone; up to 8). The Alert column names the column that says a marker is in trouble (warning, critical, alarm, SOS, fall).

View and controls

Setting	Values and defaults
Fit the view to the markers	On, with 32 px around them
Centre latitude, Centre longitude, Zoom	Where the map looks when it does not fit (zoom 1 to 18, default 4); minimum and maximum zoom
Zoom buttons	On, top left
Layer switch	On. Lets viewers show or hide markers, zones and routes when there is more than one.
Zoom with the mouse wheel	Off: the wheel scrolls the board past the map; use the buttons or a pinch

Zones

Bind Zones to a table whose rows carry an outline column (default positions) of at least three corners. Set Zone name column, Zone colour (primary, info, success, warning, error, neutral, or a Zone colour column) and Zone fill opacity (0.2).

Routes and replay

Bind Routes to rows with a path column (default positions). Route width (px) 1 to 12 (3), Dashed routes off. Turn on Replay controls to play, pause and scrub the routes: a moving point follows each, with its start and end marked, at 1×, 2×, 5× or 10×. When each point carries a time, the replay follows the clock.

Example: replay where a tracker went today. The personnel tracking solution builds its route like this:

1. Bind Points to the tracker’s latest lat and lng.
2. Bind Routes to Device readings over time (live) with the keys lat,lng.
3. Add a compute script that pairs the two series by time into one route row, [lat, lng, time] per point, oldest first, keeping at most 256 points. See Compute scripts.
4. Turn on Replay controls.

Install the solution to get this board ready-made: Personnel tracking.

Clicks and dragging markers

A marker click can run actions (When a map marker is clicked): set the board’s device or site parameter, open a detail page, open another board. On an image map, Markers can be dragged lets a viewer drop a marker where it belongs; the card’s command (When a marker is dropped) receives { id, x, y } in whole pixels. Without a command the markers stay put.

Troubleshooting

What you see	Cause
“Bind a table with latitude and longitude columns in this widget’s settings.”	The points slot is empty.
“No rows with valid coordinates.”	The latitude and longitude columns are missing, empty or out of range. Check the column names.
All markers have the same colour	The status column holds values the card does not know, so they take the card’s one colour. Add them to Status colours.
The map scrolls the page instead of zooming	Zoom with the mouse wheel is off. Use the buttons or turn it on.