Skip to main content
Category: Display · Reads data: yes (coordinates) · Sends commands: no

Mental model

A Map is a live pin board. It plots markers at coordinates from your data — one device, a few points, a route. For many devices with fleet views, use the Fleet Manager instead.

When to use it

  • Show a device’s or a few points’ location
  • Simple location display

Settings

General / Data

  • Widget Title / ID
  • Latitude / Longitude column — where marker coords come from
  • Description column — popup text

Style

  • Map provider · map shape
  • Marker type / color · path color · arrow color
  • Always show descriptions

Example — push a location from firmware

device.sendTo(targetId, [](JsonObject &p) {
  p["lat"] = 18.92; p["lng"] = 72.83;
});

Script API example

The same interactions from a dashboard script:
// Compact map on small screens
if (context.device.screenWidth < 768) widget.resize('siteMap', 320, 240);

Fleet Manager

For many devices — maps, groups, commands, firmware.