# Tracking heatmap

In the widget, you see a **heatmap** that shows where a tracker has moved in the building. **Dark red areas** mean that the tracker was there often, while **yellow areas** show that the tracker spent less time there. You can also adjust the time period to see the movement for a specific time frame.

<div data-full-width="false"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F94KBWpdKoYJufcSdPFvi%2FTracking%20heatmap.png?alt=media&#x26;token=d8a68c81-3517-4bc4-98b3-76f5adefc62c" alt="" width="375"><figcaption></figcaption></figure></div>

## Operation

To use the **Tracking Heatmap Widget** efficiently, follow the steps below to configure the view and select the desired time period.

<div data-full-width="false"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FJZlg3WcNMmuGCcieWrKb%2FTracking%20heatmap%20(1).png?alt=media&#x26;token=e56ba24b-d20c-4fc5-8540-d8eee50481ea" alt=""><figcaption></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="70.80001831054688"></th><th width="159.4000244140625"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>More Options</td><td>Opens a menu with additional settings.</td></tr><tr><td><strong>[B1]</strong></td><td>Zoom In</td><td>Enlarges the view of the current floor to see details better.</td></tr><tr><td><strong>[B2]</strong></td><td>Zoom Out</td><td>Reduces the view of the current floor to get an overview of a larger area.</td></tr><tr><td><strong>[C]</strong></td><td>Open Calendar</td><td>Opens a calendar to select the time period that is displayed in the heatmap. The calendar has a blue dot <img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FjPEwNPw2ftSQvT6MlM0V%2Fimage.png?alt=media&#x26;token=4d309920-586e-4bfe-97d9-c82bdc1caa91" alt="" data-size="line"> if a different time period is set than the <strong>standard time period.</strong></td></tr><tr><td><strong>[D1]</strong></td><td>Time From</td><td>Determines the start time from which the heatmap data should be displayed.</td></tr><tr><td><strong>[D2]</strong></td><td>Time To</td><td>Determines the end time until which the heatmap data should be displayed.</td></tr><tr><td><strong>[E]</strong></td><td>Apply</td><td>Saves the changed times and updates the <strong>heatmap</strong> accordingly.</td></tr><tr><td><strong>[F]</strong></td><td>Cancel</td><td>Cancels the changes and keeps the previous settings.</td></tr><tr><td><strong>[G]</strong></td><td>Reset to Default</td><td>Resets the time information to the default values preset in the -> Widget Configuration.</td></tr></tbody></table>

## When to use this widget

This widget should be used to visualize **movements in a building** or **a specific floor** over a defined period. It is particularly useful for analyzing **heatmap data** and **understanding** how people or objects move within a building.

## Configure widget

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FOHLC0V6Rh2AGZQfUyhQg%2FTracking%20heatmap%20config%20(1).png?alt=media&#x26;token=787fae3b-dcae-4622-97c0-d22df0363fb9" alt=""><figcaption></figcaption></figure>

1. **Ensure** that you are in the **Dashboard** menu.
2. **Click** «Add widget».
3. **Select** «Tracking heatmap».
4. Optional: **In \[H], select** a **primary asset** that is used for the title and the alarms.
5. **In \[I], set** how much **space the widget** should occupy on the dashboard (1 cell, 2 cells, or full width).
6. **In \[J], select** the **floor** that is to be displayed in the widget.
7. **In \[K], select the default period for displaying the heatmap data**:
   * **From time**: From when the movements are to be displayed.
   * **To time**: Until when the movements are to be displayed.

     ◈ The period shows the tracker movements between these two times.
8. **In \[L], select** the **trackers** whose movements are to be visualized in the heatmap.
9. **Click on \[M]** «Add widget».

   ▷ The widget is displayed on the dashboard.
10. **Click on \[N]** to exit the configuration without saving changes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buildings.ability.abb/collection/platform/live-cockpit/widgets/predefined-widgets/tracking-heatmap.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.