> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/platform/live-cockpit/widgets/predefined-widgets/tracking-heatmap.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
