Map Screen Overview

The Map screen is a screen design for visualizing and working with geographic data on an interactive map. It plots data from your Knowledge Nodes as layers, lets users filter and explore it, and supports drawing and custom actions — all rendered on a configurable base map.

Image placeholder — a map screen with data layers.

What You Can Do

• Plot geographic data — add Data Layers from any Knowledge Node that has GeoPoint or GeoJSON columns. Layers can be points, clusters, paths, GeoJSON shapes, or map tiles.
• Choose the base map — pick a default base style and, optionally, let users switch between bases on the fly. The map can run on MapBox or MapLibre GL, and render as a flat Mercator plane or a 3D globe.
• Filter the map — apply date ranges and field filters, including filters that span multiple layers.
• Draw on the map — enable drawing tools to create and edit shapes directly on the map.
• Inspect data — click a point or feature to open a popup showing the fields you choose.
• Add map actions — show optional action buttons on the map.

Use Cases

The Map screen fits any scenario where your data has a location:

• Field service & work orders — plot work orders by site so dispatch and field teams see what's where; click a point to open its details.
• Customer & sales territory — map customers, vendors, and sales by region to spot concentration and coverage gaps; filter by category or date range.
• Inventory & stock locations — show warehouses and stock points on the map, clustering dense areas for clarity.
• Logistics & routes — use Path layers to visualize routes or connections between locations.
• Asset & fleet visibility — plot GPS-tracked assets or vehicles and let the map auto-refresh.
• Territory & coverage planning — use the drawing tools to sketch zones or boundaries for planning.

How It's Configured

The map screen settings are organized into four sections:

• Data Layers — the geographic data drawn on the map.
• Filters — filters applied to the map.
• Map Settings — base map appearance and behavior (type, zoom, pitch, bearing, projection, refresh rate, drawing tools, starting point, custom code).
• Map Actions — optional action buttons.

📘

For step-by-step configuration of each section, see How to Use the Map Screen.