How to Use the Map Screen

A map screen is a screen design to visualize and work with geographic data. You configure it from Settings for the screen MAP, which is organized into four sections:

Data Layers — the geographic data drawn on the map
Filters — filters applied to the map
Map Settings — how the base map looks and behaves
Map Actions — optional action buttons on the map

Image placeholder — Settings for the screen MAP (the four sections).

Data Layers

Add layers with geographic data from your Knowledge Nodes. Click Add Layer to create one.

Each layer opens the Add Data Layer dialog with:

Layer Id — generated automatically.
Layer Name — a name for the layer.
Visible on initial load — show the layer when the map first loads.

The dialog has three tabs: Layer Configuration, Element Actions, and Other Settings.

Layer Configuration

Choose the layer type: Objects, Link, Path, GeoJSON, or MapBox Tile. The Objects type uses the following fields:

Data Icon Type — the icon/style used to draw the points (e.g., disabled to use GeoJSON).
Enable Cluster — group nearby points into clusters.
Select Knowledge Node — the data source. Only Knowledge Nodes with GeoPoint or GeoJSON columns are shown.
Column with GPS (Lat,Long) — the column holding the coordinates.
Data Field in Popup — the fields shown in the point's popup. Leave empty to disable the popup for this layer.
Qty. of columns to show — number of columns shown in the popup. 0 = disabled, max 4.
Show popup only for clicked feature — unchecked shows all popups on click.
Show all popups automatically when layer loads.
Primary / Relation Key — used when link-to-screen is enabled.
Variant to Apply — apply a saved filter template. Filter templates are saved in Insights first.

Image placeholder — Add Data Layer › Layer Configuration › Objects.

The other layer types — Link, Path, GeoJSON, and MapBox Tile — each have their own configuration fields.

Element Actions

Click Add Action to attach actions to the layer's elements.

Other Settings

Layer Realtime Reload Configuration — enable Enable realtime reload effect to refresh the layer in real time.

Click Save to keep the layer, or Close to discard.

Filters

Add filters to your map.

Add Date Range — filter the map by a date range.
Add Filter — add a field filter.

To relate filters across multiple Data Layers, add data points between the data layers loaded on your map.

Map Settings

Controls how the base map looks and behaves:

Map Type (Default) — the initial base map loaded for the user (e.g., Gui Light/Dark). This is where you choose the base style, including MapBox and MapLibre GL options.
Map Types Allowed (User Toggle) — let the user switch the base map. If you select two or more, a toggle appears on the map. (Custom Style uses the Style URL field.)
Map Zoom — initial zoom, 0 to 20.
Map Pitch — camera pitch in degrees, 0 to 85.
Map Bearing — compass direction the map faces, in degrees, 0 to 360.
Map Projection — render the map as a flat Mercator plane or as a 3D globe sphere.
MapBox Access Style Token — leave empty to use the Arpia Platform Token.
Data Layer Refresh Rate — seconds between auto-refreshes. 0 = disabled, max 300.
Enabled Drawing tools — turn on the drawing tools on the map.
Load with map tools opened — open the map tools by default.
Set Map Starting Point — click Open Map to set the map's starting position.
Map Custom Code — custom code appended to map.on('load', function(){ ... }).

Image placeholder — Map Settings.

Map Actions

Show Map Actions — set to Yes to display action buttons on the map.
Map Action Buttons — define each button's Label and Type. Click Add Button to add one.

Notes

The base map can run on either MapBox or MapLibre GL — selectable in Map Type (Default); it was not a full replacement of one by the other.
Drawing tools (enabled in Map Settings) let you draw and edit shapes directly on the map.