# Tracking heatmap

In the widget you can see a **Heatmap**, which shows where a tracker has moved within the building. **Dark red areas** mean that the tracker was often there, 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/LSsbta4rbFQKeDc8R2ih/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>Enlarges the view of the current floor so details can be seen more clearly.</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 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 period is set than the <strong>default period.</strong></td></tr><tr><td><strong>[D1]</strong></td><td>Time from</td><td>Specifies the start time from which the heatmap data should be displayed.</td></tr><tr><td><strong>[D2]</strong></td><td>Time to</td><td>Specifies 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 values</td><td>Resets the time values to those specified in the <a href="#widget-konfigurieren">-> Widget configuration</a> 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 particularly useful for **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** «Tracking heatmap».
4. Optional: **Select in \[H]** a **primary asset** to be used for the title and 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 period for displaying the heatmap data**:

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

   ◈ The period shows the tracker movements between these two times. &#x20;
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: 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/english-v14/documentation/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.