> 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/english-v14/documentation/widgets/vordefinierte-widgets/tracking-heatmap.md).

# Tracking heatmap

The widget shows a **Heatmap**, which shows where a tracker moved within 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 period.

<div data-full-width="false"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/CPVMDGazGtGnx8pvtHoH/Tracking%20heatmap.png" 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://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/k77MKf7Z4SbQQmOHweFw/Tracking%20heatmap%20(1).png" alt=""><figcaption></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="106"></th><th width="185"></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>Zooms in on the current floor to see details better.</td></tr><tr><td><strong>[B2]</strong></td><td>Zoom out</td><td>Zooms out of the current floor to view a larger area.</td></tr><tr><td><strong>[C]</strong></td><td>Open calendar</td><td>Opens a calendar to select the time period displayed in the heatmap. The calendar has a blue dot <img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/uRUp9r84j6QFKndJhXP9/image.png" alt="" data-size="line"> when a different time period is set than the <strong>default time period.</strong></td></tr><tr><td><strong>[D1]</strong></td><td>Time from</td><td>Sets the start time from when the heatmap data should be displayed.</td></tr><tr><td><strong>[D2]</strong></td><td>Time to</td><td>Sets the end time until when 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 values</td><td>Resets the time settings to those in the <a href="#widget-konfigurieren">-> Widget configuration</a> preset default values.</td></tr></tbody></table>

## When should this widget be used?

This widget should be used to **movements in a building** or **a specific floor** visualize over a defined period of time. It is especially useful to **heatmap data** analyze and **understand**how people or objects move within a building.

## Configure widget

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/uyXwRPiJ6h13vhKamJwd/Tracking%20heatmap%20config%20(1).png" alt=""><figcaption></figcaption></figure>

1. **Make sure**, that you are in the menu **Dashboard** menu.
2. **Click on** “Add widget”.
3. **Select** select “Tracking heatmap”.
4. Optional: **Select in \[H]** in **primary asset** that will be used for the title and the alarms.
5. **Set in \[I]** how much **space the widget** should take up on the dashboard (1 cell, 2 cells, or full width).
6. **Select in \[J]** the **floor**, which should be displayed in the widget.
7. **Select in \[K] the default time period for displaying the heatmap data**:

   * **From time**: From when the movements are displayed.
   * **To time**: Until when the movements are displayed.

   ◈ The time period shows the tracker movements between these two times.
8. **Select in \[L]** the **Tracker**, whose movements should be visualized in the heatmap.
9. **Click on \[M]** “Add widget”.\
   ▷ The widget will be 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/english-v14/documentation/widgets/vordefinierte-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.