Add a map visualisation to your project dashboard. Learn how to create a map card, configure it with your data, and draw polygons to display live data directly on your site plan.
This guide walks you through drawing amap overlay, adding a new card to a dashboard, and creating a map visualisationwith bubble data. Use it alongside the video as a step-by-step reference.
Your Academy Level 2 Site Plan map from Lesson 4 must be saved in your account and your Level 2 Workplace Project from Lesson 5 must be set up
Before adding a map visualisation to adashboard, check that your map is set up correctly.
1. In the sidebar, navigate to Maps under your account.
2. Find your site plan map, click the three dots, and select View details.
Confirm that:
- Property is set to Building
- Background image is your site plan SVG file
The map does not yet have an overlay. You will draw that in the next step.
An overlay defines the buildingpolygons on your map. These polygons connect your spatial image to your data,so spaciv knows which area on the map corresponds to which building.
- On your map, click the three dots and select Edit overlay. This opens the map editor.
- Click the Edit button to reveal the drawing tools.
Map editor tools
- Zoomin / Zoom out: use the zoom buttons to get a clearview of your site plan
- Scale overlay: if you have imported an existing overlay, scale it to fit
- Fit to bounds: fits an imported overlay to theimage boundaries
- Flip vertically: mirrors the overlay if needed
- Draw: the plus button. Use this to draw new polygons
Note: Hover over any button for a moment to see a tooltip explainingwhat it does.
Drawing a polygon
1. Click the Draw (plus) button.
2. Click on each corner of the building you want to outline to place the polygon points.
3. Click to add more points if needed. Double-click a point to remove it.
4. When the polygon is complete, open the dropdown that appears and select the building node it corresponds to, for example Building C.
5. Click Save.
6. Repeat for each additional building. Click the Draw button again and trace the next polygon.
7 .Assign it to its building node, for example Building B, and click Save.
The overlay is now saved. spaciv knowsthat the polygons you drew correspond to Buildings B and C in your dataset.
8. Click Back to maps. Click the three dots and select View details to confirm the overlay has been saved.
With your overlay in place, you can nowadd a map visualisation card to a dashboard.
1. Navigateto your project and open the Headcount dashboard.
2. Hoverover the dashboard to reveal the plus button. Click it to add a newcard.
3. Name the card Map.
4. Hoverover the card name, click the three dots, and select Edit.
5. Setthe size to Medium so the map has enough room to display clearly.
6. Click Save.
The card is now on your dashboard but still empty. You need to add a visualisation inside it.
1. Hover over the empty card and click the plus button that appears inside it.
2. Name the visualisation Munich Site Plan.
Visualisation settings
1. Visualisation type: select Bubble. This will display a circle on each building showing the total number of employees.
2. Unit/ suffix: leave empty.
3. Segment by property: leave empty for now. You will add segmentation later.
4. Scenario: select your baseline scenario variable.
5. Function: enter the function that counts total consumers per building: sumof("Object type" is "Consumer" , "Count")
6. Click Save.
Your map card now shows the site planwith a bubble on each building displaying the total number of employees in thatbuilding.
Note: Functions are covered in more depth in Level 3 of spaciv Academy. For this lesson, copy the function from the lesson description rather than writing it from scratch.
You can break the bubble data down further by segmenting it by a property. For example, to see which teams are in each building rather than just the total count:
1. Hover over the visualisation and click Edit.
2. Findthe Segmentation setting.
3. Select the property Team and set the value to Root so all teams are included.
3. Click Save.
The bubbles on the map now show how employees are distributed across teams within each building. You can zoom in to see the breakdown clearly.
- Reviewed the map setup and confirmed the background image and linked property
- Drew an overlay with polygons for Building B and Building C, each assigned to the correct building node
- Added a new card to the Headcount dashboard and set its size
- Created a bubble visualisation showing total employee count per building
- Added segmentation by Team to show which teams are in each building
This is a first introduction to map visualisations and adding cards in spaciv. In the next levels of spaciv Academy, you will explore more complex visualisation types, advanced map overlays, and richer spatial analysis.