Start Free Trial

Maps

The Map page lets you pin your devices onto a picture of the real space they live in: a floor plan, a site layout, a rack diagram, a piece of equipment. Each pin shows a live reading and turns color when an alert fires, so you can see at a glance where something is wrong and exactly where it is.

What a Map is (and is not): a NEQTO.ai Map is an image overlay. You upload a picture and drop device pins on top of it at the positions you choose. It is not a geographic latitude/longitude map. Pin positions are stored as percentages of the image, so the layout holds up at any zoom or screen size.
Diagram: a floor-plan image is uploaded as the map background. Each device attribute (for example a temperature reading) is added as a pin placed at an X/Y position on the image. Live values arrive over the websocket and update each pin in real time, and active alerts recolor the matching pins.
How a Map works: an uploaded image, plus device pins, plus live readings on top.

Quick Start

If you already know NEQTO.ai, here is the short version.

  • 1
    Open an application and go to Map. In the left sidebar click Add map, give it a title, and upload a floor-plan image (PNG, JPEG, or WebP).
  • 2
    Click Add device, then click a spot on the image to choose where the pin goes.
  • 3
    In the dialog, pick a device, the attribute to show, and a category icon. Optionally add a text label and one or more click-charts. Save.
  • 4
    The pin appears with its live value. Click any pin to open its details in the right-hand panel. Use Edit position to fine-tune placement later.
Naming note: a map pin shows one Attribute of one Device. As elsewhere in NEQTO.ai, the UI says “Attribute” while the API calls it a data type, and “Endpoint” maps to data source. You will only see the UI names on this screen.

The Map Page Layout

The Map page lives inside an application (its title is simply “Map”, described as “Real-time device monitoring and floor plan visualization.”). On desktop it is a three-panel view.

The Map page in a three-panel desktop layout. Left: a filter sidebar with a Map Selection dropdown, an Add map button, Categories checkboxes, a Status Filter, and a Status Legend. Center: the floor-plan image with device pins overlaid, plus zoom and full-screen controls. Right: a device panel showing the selected pin's current reading and history charts.
Desktop layout: filter sidebar, the floor plan with pins, and the device panel.
PanelWhat’s there
Filter sidebar (left)The Map Selection dropdown to switch maps, the Add map button, category filters, a status filter, and the status legend.
Map (center)The floor-plan image with pins on top. Zoom in, zoom out, and full screen. Click a pin to select it.
Device (right)The selected pin’s current reading and any click-charts. Empty until you select a pin.

On a phone the same three panels become tabs: Filters, Map, and Device. Tapping a pin opens a sheet with “Show device info” plus edit and delete actions.

Creating and Organizing Maps

An application can hold several maps, for example one per floor or one per area. You switch between them with the Map Selection dropdown.

The Create Map dialog. It has a Map title field and a Map setting section with an Upload image button, a 'Map image is required.' warning when none is set, and a preview thumbnail with a Clear button once an image is chosen. Cancel and Save buttons sit at the bottom.
Creating a map: a title and a floor-plan image. Devices are added later, on the map itself.

Create a map

  • 1
    Click Add map in the sidebar to open the Create Map dialog.
  • 2
    Enter a Map title (up to 255 characters).
  • 3
    Upload image for the background. Accepted types are PNG, JPEG, and WebP. Save.
The image is the map. The create/edit dialog only handles the title and the floor image. You do not add devices here; you add them by clicking on the map after it is created. An image is effectively required: the dialog shows a “Map image is required.” warning until you pick one, and Save is blocked without it.
The filter sidebar's top section showing a Map Selection dropdown listing the application's maps in alphabetical order, with an Add map button beside the heading.
Switch maps with the Map Selection dropdown. Maps are listed alphabetically by title.

Switching, editing, and deleting

  • Switch maps with the Map Selection dropdown. The page remembers your choice in the URL (a mapId query parameter), so a map link is shareable.
  • Edit a map with the pencil (Edit floor map) button on the map toolbar to change its title or swap the floor image.
  • Delete a map from inside that edit dialog (the trash button), after a confirmation. Its stored floor image is removed too.
Limit: an application can hold at most 15 maps. Trying to create a sixteenth returns “The map has reached its maximum number.”

Placing Devices on the Map

Each pin links one attribute of one device to a spot on the image. You place pins by clicking the map, then filling in a short form.

The map in placement mode after clicking Add device: a hint reads 'Click the map to choose where to place the device. Right-click or Esc to cancel,' and a ghost pin icon follows the cursor over the floor-plan image.
Click Add device, then click the image to choose where the pin lands.
  • 1
    Click Add device. The cursor shows a ghost pin. Click the spot on the image where the device sits. (Right-click or press Esc to cancel.)
  • 2
    In the dialog, choose the Device (a searchable list), then the Attribute to display. Devices already pinned on this map are hidden from the list to avoid duplicates.
  • 3
    Pick a Category, which sets the pin’s icon shape, add an optional label, configure any click-charts, and Save.
The Add device dialog. Fields: a searchable Device select, an Attribute (data point) select that fills in after a device is chosen, a Category select with an icon preview, a 'View label' toggle that reveals a label text field, a 'Place value' toggle, and a label-position select with a live label preview. For numeric attributes a 'Charts when clicking this device' section lets you enable one or more history charts with a preview.
The Add device dialog: device, attribute, category icon, optional label, and optional click-charts.
One pin per device, per map. Each pin shows one attribute of one device. Once a device is pinned to this map it is hidden from the Device list, so you cannot add the same device to the same map twice (even for a different attribute). To track that device on another floor, add it to a different map.

Category icons

The Category you pick decides the pin’s icon. It is a visual choice and does not change the data. The available categories are:

CategoryIcon
Air FlowWind
TemperatureThermometer
HumidityDroplet
CO2Tree
Acceleration3D move
DoorOpen door
BrightnessSun
MotionCustom motion artwork
OccupancyPerson
OtherCircle

The default category for a new pin is Temperature.

Pin labels

Turn on View label to show text next to the pin. You can type a fixed label, switch on Place value to show the live reading, or both. A label position control places the text center, top, bottom, left, or right of the pin, with a live preview as you edit.

Click-charts (numeric attributes only)

For numeric attributes you can attach one or more history charts under “Charts when clicking this device.” Each chart you enable appears in the right-hand device panel when the pin is selected. You choose the chart type, color, time window (live relative window or a daily rotation), and Y-axis bounds, with a live preview in the dialog.

Reading the Map

Once pins are placed, the map updates itself. Values stream in live and pins recolor when alerts fire.

A floor-plan map with several device pins. Each pin is a category icon in a circular badge. One pin shows a value label beneath it; another pin is colored red to indicate a critical alert, while normal pins stay in their default state.
Pins update live. Their color reflects alert status.

Status colors

A pin’s color reflects the most severe active alert on its device or attribute. The sidebar’s Status Legend spells it out:

StatePin color
Normal (no active alert)Default / info blue
WarningYellow
Alert / CriticalRed

Completed (resolved) alerts are ignored, so a pin returns to normal once its alert clears.

The device panel

The right-hand device panel for a selected pin. It shows the device name, the current reading with its unit and a timestamp, and below it any configured click-charts rendered as history graphs, each able to be double-clicked to enlarge.
Selecting a pin opens its current reading and click-charts here.

Click a pin to select it; the device panel shows its current reading (value, unit, and the time it arrived in your timezone) plus any click-charts. With no pin selected, the panel prompts you to click a device on the map. On a map with pins, the first pin is selected by default.

Temperature unit conversion is automatic. If an attribute is configured to convert between Celsius and Fahrenheit, the pin value, its unit, and its chart all show the converted reading, with a “(converted to °F)” or “(converted to °C)” note on the label.

Filtering what you see

The filter sidebar showing a Categories section with a checkbox per category present on the map, a Status Filter section with a 'Show Alerts Only' toggle, and a Status Legend listing Normal, Warning, and Alert / Critical.
Filter by category, or show only pins that currently have an alert.
  • Categories lists each category present on the map; uncheck one to hide those pins.
  • Show Alerts Only hides every pin except those with an active alert, useful for triage on a busy map.

Zoom and full screen

The map has Zoom in, Zoom out, and Full screen controls. Because pin positions are stored as percentages of the image, they stay put as you zoom or change screen size.

Editing Pins

After placing a pin you can move it, change its settings, or remove it. These actions need edit permission for the application.

A pin in Edit position mode: the hint reads 'Drag the pin to move it. Press Esc to cancel,' the selected pin is being dragged to a new spot, and a small toolbar offers Save and Cancel.
Edit position: drag the pin, then Save to commit just that pin’s new spot.
ActionWhat it does
Edit positionDrag the pin to a new spot, then Save. Only that pin’s coordinates change. Press Esc or Cancel to discard.
EditReopen the device dialog to change the attribute, category, label, or click-charts for that pin.
DeleteRemove the pin after a confirmation (“Remove device from map?”). The device itself is untouched; you can add it back later.

On desktop these appear in a small menu on the selected pin; on mobile they appear in the pin’s bottom sheet.

Maps on Dashboards

A map you build here can also appear as a widget on a dashboard. The two stay related: the dashboard widget mirrors the map you created on the Map page.

The dashboard widget editor's Import map panel. It has an Application map dropdown that lists the application's maps, and a Map setting block with a Window section holding Information and Filter toggles to show or hide the map's info and filter windows. When no maps exist it shows a 'Create a map' button that links to the Map page.
On a dashboard, Import map mirrors an existing map as a widget.
The Map page is where maps are made; dashboards only mirror them. When editing a dashboard you use Import map to “Add a map widget that mirrors a map from the Map page. Pins and layout come from the selected map.” Pick the map from the Application map dropdown. If the application has no maps yet, the panel shows “No maps in this application yet. Create one on the Map page, then return here to import it.” with a Create a map button.
  • Under Map setting the widget has a Window section with Information and Filter toggles to show or hide the map’s built-in info and filter windows on the dashboard.
  • A widget created as a map widget cannot be changed into another widget type afterward.
  • The Map page itself only appears in an application’s navigation when its route is enabled in the application sidebar.

Limits and Good to Know

A few details that are not obvious from the screens.

LimitValue
Maps per application15
Floor image typesPNG, JPEG, WebP
Map title length255 characters
Categories (pin icons)10 (Air Flow, Temperature, Humidity, CO2, Acceleration, Door, Brightness, Motion, Occupancy, Other)
Pins per device, per map1 (a pinned device is hidden from the picker)
  • Maps are image overlays, not geographic maps. There is no latitude/longitude. You position pins by hand on a picture you provide.
  • Pin positions are percentages. They survive zoom and resizing without drifting.
  • Pin color follows alerts. Yellow for warning, red for alert/critical; resolved alerts clear back to normal.
  • Editing needs permission. Adding, moving, editing, and deleting pins all require application edit rights. Without them the map is view-only.
  • Click-charts are for numbers. The history-chart options only show for numeric attributes, not for text or state values.

Leave a Reply

Your email address will not be published. Required fields are marked *

Start Free Trial

Open external link

You’re leaving Claude to visit an external link:
https://stg-app.env-neqtoai-staging.kinsta.cloud/en/dashboards
Cancel
Open link