How to use the Map Screen?

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.