Skip to content
Version 2026.25

Map ​

Sites, lift stations, pipelines and zones on a map, with alarm status on each marker.

In Studio ​

In Studio, double-click Map in the Components category of the Components panel. It is added to the open view, where you can drag it into place.

When to use ​

Use Map for a geographic overview of remote sites. Markers show the worst active alarm under a tag folder, so an operator can see which site needs attention and click through to it.

Properties ​

PropertyTypeDefaultDescription
Stylehp-plain, street, satellite, googlehp-plainThe map style: hp-plain (default), street, satellite or google. hp-plain draws no imagery and needs no tile source; only the markers carry color. street and satellite use the tile source configured on the gateway (ConfigHub, Maps) and say so on a plain base if none is set. google draws the Google Maps base with the gateway’s Google key (ConfigHub, Maps, Google base map) and needs internet on every client.
Center LatitudeString(none)Center latitude. Leave the center blank to fit all markers, lines and polygons. Both latitude and longitude must be set for the center to apply.
Center LongitudeString(none)Center longitude. See Center Latitude.
Zoom (with center)Number12The zoom level used when a center is set.
Min ZoomNumber1The lowest zoom the operator can reach. Default 1.
Max ZoomNumber18The highest zoom the operator can reach. Default 18.
Markers (JSON)String[]The markers, as JSON text or bound to a dataset. Each is {id, label, lat, lon, alarmPath, tagPath, priority}. alarmPath is a tag folder: the marker shows the worst active alarm under it. tagPath is a tag whose Bad or Stale quality overrides that status. priority (0 diagnostic to 4 critical) fixes a status when there is no alarm path.
Lines (JSON)String[]Pipelines or routes, as JSON text or a dataset. Each is {id, label, points: [[lat, lon], ...], alarmPath, priority} and takes the same status as a marker.
Polygons (JSON)String[]Zones, as JSON text or a dataset, in the same form as Lines.
GeoJSON (text or asset file)String(none)GeoJSON text, or the file name of a project asset, drawn as neutral outlines (boundaries, roads, pipelines).
Marker Lookpill, pin, dotpillpill (default, a label with the status shape), pin or dot.
Cluster Markerstrue, falsetrueWhen true (default), markers that overlap merge into a badge showing the worst status among them.
Cluster Radius (px)Number44The merge distance in pixels when clustering is on. Default 44; values are kept between 16 and 120. To turn clustering off, set Cluster Markers to false.
Pan / Zoomtrue, falsetrueWhen true (default), the operator can pan and zoom by drag, wheel, pinch, double-tap or keys. False fixes the view.
Zoom Buttonstrue, falsetrueShows the zoom buttons. They appear only when Pan / Zoom is on.
Scale Bartrue, falsetrueShows the scale bar.
Alarm Refresh (s)Number10How often, in seconds, alarm status is re-read. The map clamps this to at least 3 seconds.
Online Layers (JSON)String[]Online tile layers, as JSON text or bound to a dataset. A list of layers drawn under the markers in order (first = bottom). Each is {url, attribution, opacity (0-1), minZoom, maxZoom, tms, subdomains}. url is an XYZ tile template with {z}/{x}/{y} (and {s} for subdomains). The browser fetches these tiles directly from the provider; the layer host must be approved under ConfigHub, Maps, Online tile layers, or the layer stays blank and the map names the fix. On the Studio canvas the layers do not load.
Google Baseroadmap, satellite, hybrid, terrainroadmapGoogle style only: the Maps base flavor, roadmap (default), satellite, hybrid or terrain. Needs the gateway’s Google key; without one the map shows a plain base and says so. The key is sent to every runtime client, signed in or anonymous, so use a publishable key restricted by HTTP referrer to the Maps JavaScript API. On the Studio canvas no Google base loads.
Quality Markstandard, dimstandardHow a lost link is marked when a value this component shows has Stale or Bad quality. standard (the default) draws the quality outline and glyph over the value. dim keeps the last good value on screen, faded, with nothing drawn over it: it suits a dense panel where one lost link turns a whole column Bad. The value still reads as not live, and a binding that fails to evaluate keeps its outline either way.

Binding ​

This component has no single value binding.

Bind markers, lines, polygons or tileLayers to a dataset to build the map from data. Clicking a marker fires the On Action Performed event with that marker, which is usually wired to open a popup, and publishes selectedId, selectedLabel, selectedLat and selectedLon as live values.