Geo Map Widget
Your devices and gateways on a real-world map. Add pins for the hardware you care about, and each pin shows a device's latest reading or state, a gateway's online state, or a shortcut to another dashboard. Viewers can zoom, pan, filter, and click any pin for detail.
What it shows
The widget renders a street or satellite base map with up to 500 pins on it. Three kinds of pin:
- Device pin - bound to a device. Shows a live reading, an icon, or a colored dot, with a ring around it colored by the device's state (see Pin states below).
- Gateway pin - bound to a gateway. Colored by online state: green when the gateway has reported within the last 15 minutes, red when it hasn't.
- Navigation pin - a labeled shortcut that jumps the viewer to another dashboard (optionally a specific tab). Useful for "Site B ->" style drill-downs between maps.
Readings and states refresh on their own roughly once a minute. Clicking a device or gateway pin opens a popover with the primary reading, the device's state and last uplink, and a link to the device or gateway page.
Nearby pins are combined into a numbered cluster until the viewer zooms in. A cluster takes the color of the worst state inside it, so an alerting sensor is visible even when it is folded into a cluster of a hundred healthy ones.
Pin states
Every device pin carries a state ring, worst state first:
- Alerting (red, pulsing): the device has an active alert from a workflow.
- Offline (gray): no uplink within the device's offline threshold (default 30 minutes, set per device on its Configuration tab).
- Rate-limited (amber): the device has used up its daily uplink allowance.
- Online (green): reporting normally.
- Not available (muted): the device is no longer available to this dashboard, for example after it was moved to inventory.
Where pins get their position
A pin's position comes from one of two places:
- Its own position. Pins you drop by hand sit where you put them. You can drag them on the editor map or type coordinates. When you bind a device or gateway that already has a saved location, the pin snaps there once and then keeps its own position.
- The record's saved location. Pins added with Add from fleet (and any pin with Follow device location or Follow gateway location switched on) follow the location saved on the device or gateway record. Correct a device's location on its Location card or a gateway's Location tab and the pin moves within a minute, on every dashboard that shows it. These pins cannot be dragged; switch the follow setting off to detach a pin and place it yourself.
A followed pin keeps its last known position as a fallback, so a device whose location is later cleared, or one that becomes unavailable, stays where it was last seen rather than disappearing.
Configuring a Geo map widget
Basics tab
| Field | What it does |
|---|---|
| Title | Header text (required, max 120 chars). |
| Subtitle | Optional caption. |
| Zoom level | How far the map zooms in when it opens. The view centers itself on your pins. |
| Base layer | Street (follows the viewer's light or dark theme) or Satellite. |
| Cluster nearby pins | Combine overlapping pins into a count badge until the viewer zooms in. On by default. |
| Show filter panel by default | Open the map with the filter side-panel expanded. |
| Show border | Optional border around the map, with color, width, and style. |
Pins tab
There are two ways to put pins on the map.
Add from fleet
- Click Add from fleet.
- Switch between Devices and Gateways, and search by name or EUI if the list is long.
- Tick the rows you want. Only rows with a saved location can be selected; rows already on the map are shown but disabled. The header checkbox selects every eligible row in the current list.
- Click Add N pins. Each new pin follows its record's location and starts as a dot with its name shown. Open any pin in the list below the map to style it.
The counter under the list shows how many of the 500 pins the widget would use, and the picker will not add a selection that goes past the limit.
Drop a pin by hand
Pick a pin type (Drop device pin, Drop gateway pin, or Drop nav pin), then click the map to place it. Drag pins to reposition. Each pin has its own editor panel:
Device pin
| Field | What it does |
|---|---|
| Latitude / Longitude | The pin's position. Read-only while the pin follows its device. |
| Follow device location | On: the pin follows the location saved on the device record. Off: the pin keeps its own position. Available once a device is bound. |
| Device | The bound device (required for live data). Binding a device that has a saved location moves the pin there. |
| Pin style | Value shows the primary reading in a pill; Icon and Dot are color-only. |
| Icon | (Icon and dot styles) glyph from the built-in icon set. |
| Primary field | Drives the value shown on value pins and, for dot pins, the fill color. |
| Threshold rules | (Dot style) color the dot by the primary reading; first matching rule wins. |
| Label override | Text under the pin; defaults to the device name. |
| Pin size | Diameter from 20 to 80 px. Dots render smaller, in proportion. |
| Show label | Always-on text rendered under the pin. |
Gateway pin
| Field | What it does |
|---|---|
| Latitude / Longitude | The pin's position. Read-only while the pin follows its gateway. |
| Follow gateway location | Same as the device setting, reading the gateway's saved location. |
| Gateway | The bound gateway. Binding a gateway that has a saved location moves the pin there. |
| Pin style | Icon or dot. Color always reflects online state. |
| Label override / Pin size / Show label | Same as device pins. |
Navigation pin
| Field | What it does |
|---|---|
| Title | The visible label users tap (required, for example "Site B"). |
| Icon | Glyph shown on the pin. |
| Target dashboard | The dashboard to open, optionally a specific tab. |
Advanced tab
A read-only view of the widget config, useful for debugging or sharing with support.
Filters on the map
Viewers can open Filters on the map to hide gateway pins or navigation pins, and to show only online or only offline devices. Filters are per viewer and reset when the page reloads; the Show filter panel by default setting only controls whether the panel starts open.
Public share links
On a dashboard shared by public link, device and gateway pins render with their live readings and states, updated about once a minute. Pins show the position saved with the dashboard: for pins that follow a device or gateway, that is the location at the time the dashboard was last saved. Navigation pins are removed, and pin popovers never link into the app.
Tips
- Start with Add from fleet, then switch the few pins that matter most to the Value style with a primary field.
- Keep Follow device location on for fixed installs. Detach a pin only when the map needs a deliberate offset, for example to spread out sensors that share one cabinet.
- Turn Cluster nearby pins off for a small site map where every pin should always be visible.
When to use a different widget
- For a moving device's track and history -> the Tracker map widget on the device's profile dashboard.
- For pins on your own building plan or diagram -> the Floor plan map widget.
- For an at-a-glance count of offline or alerting devices -> the Count widget.