The Maps component renders geospatial project data on a configurable basemap. Use it to show site and asset locations, activity concentration by area, resource distribution across a geographic region, or project footprint. Maps can display point, cluster, heatmap, and boundary layer types.
Presets
| Preset | Description |
|---|
| Site locations | Point markers for project site addresses or coordinates. |
| Activity clusters | Clustered point density by activity or work area location. |
| Resource distribution | Point or heatmap showing resource concentration by location. |
| Risk map | Points colored by risk level at each location. |
| Progress by area | Areas (polygons) colored by completion % or status. |
| Asset register | Points for physical assets with status icons. |
Data binding
| Property | Description |
|---|
| Latitude field | Numeric field containing the latitude coordinate. |
| Longitude field | Numeric field containing the longitude coordinate. |
| Label field | Field shown as the point or cluster label. |
| Color / status field | Optional field for conditional point coloring. |
| Size field | Optional numeric field for proportional point size (bubble map). |
| Geometry field | For polygon or line layers: a GeoJSON geometry field. |
Location sources
When your data does not contain coordinate fields, the component can geocode using:
- Address field — resolves a text address to coordinates (uses the configured geocoding service).
- Named zone field — matches against pre-loaded zone or region boundaries.
Geocoding results are cached per report to avoid repeated API calls.
Layer types
| Layer type | Description |
|---|
| Point markers | Individual pin or icon per record. |
| Clustered points | Points merge into cluster circles when zoomed out; expand on zoom in. |
| Heatmap | Density heatmap showing concentration of records in an area. |
| Bubble | Point markers with radius proportional to a size field. |
| Choropleth (polygon fill) | Areas (polygons) filled by a value or status field. |
| Line | Polylines connecting locations in sequence (e.g., route or corridor). |
| WMS tile layer | Overlay from an external Web Map Service (WMS) URL. |
| GeoJSON overlay | Custom boundary file uploaded to the blueprint. |
| Label layer | Text labels at specified coordinates. |
Multiple layers can be stacked in the layer panel; toggle each independently.
Basemap styles
| Style | Description |
|---|
| Road | Standard street map with road names and labels. |
| Light | Muted light gray basemap for data-heavy overlays. |
| Dark | Dark background for vivid data overlays in presentations. |
| Minimal | Stripped-down basemap with minimal label noise. |
| Satellite | Aerial imagery basemap. |
| None | No basemap. For diagrammatic layouts using custom GeoJSON boundaries only. |
Clustering options
| Property | Description |
|---|
| Cluster radius | Distance in pixels within which points are merged into a cluster. |
| Cluster color | Background color of the cluster circle. |
| Cluster label | Count of points in the cluster. |
| Expand on zoom | Clusters break apart as the user zooms in. |
| Max zoom to cluster | Clusters are not shown beyond a configured zoom level. |
Heatmap configuration
| Property | Description |
|---|
| Intensity field | Numeric field controlling the heat intensity per point (leave blank for equal weight). |
| Radius | Influence radius per point in pixels. |
| Color gradient | From cool (low density) to hot (high density). Custom gradient colors configurable. |
| Opacity | Transparency of the heatmap layer over the basemap. |
Configure what appears when a user clicks or hovers a point:
| Property | Description |
|---|
| Popup fields | Fields shown in the click popup. |
| Tooltip fields | Fields shown in the hover tooltip. |
| Popup layout | Label-value list or card style. |
Export behavior
Maps export as static images in PDF and as interactive JavaScript maps in web outputs. For PDF export, the current viewport (zoom and center) at export time is used. Set the default zoom and center in Properties → Default view before exporting.
Good practice
- For formal project status reports, use the Site Locations or Progress by Area preset and lock the map extent to the project area before export.
- Avoid using satellite basemap in black-and-white PDF exports — use Light or Minimal instead.
- Add a north arrow and scale bar annotation for engineering and construction deliverables.
- Geocode-heavy reports should test geocoding coverage before final export.