Building heatmaps visualize foot traffic in physical venues. Use them to guide venue design, plan booth and product layouts, and analyze traffic distribution. Common scenarios include large exhibition halls, trade shows, industrial parks, and supermarkets. This topic describes how to add data and configure styles for a building heatmap.
Prerequisites
You have created a dashboard. For more information, see Create a Dashboard.
- Important
You have created a custom image base map and matched it with a dataset. For more information, see Custom Image Base Map.
Chart Overview
Scenarios
Analyze foot traffic in physical venues. Guide venue design and the layout of booths and products. Analyze traffic distribution in large exhibition halls, trade shows, industrial parks, and supermarkets.
Benefits
Visualization: Displays heat data across multiple floors and venues. You can switch between floors. You can also switch between viewing data for a single point in time or cumulative data for the day.
Example rendering

Create a Chart
In the dashboard editor, select Building Heatmap.

Select a dataset that is matched with a Custom Image Base Map. For more information about how to create a custom image, see Custom Image Base Map.

Configure Chart Fields
On the Fields tab to the right of the chart, select the dimension and measure fields you need.
In the Coordinate Data/Dimensions list, locate the x and y fields. Double-click them or drag them to the Coordinate Data/Dimensions area.
NoteOnly geographic fields of the custom image type are supported.
In the Dimensions list, locate the Floor field. Double-click it or drag it to the Floor/Dimension area.
NoteEnsure that the floor names in your data match the floor names in the custom image base map. If they do not match, the chart cannot display the data.
(Optional) Drag a dimension field to the Area Location Label/Dimension area to place area node location data.
In the Measures list, locate the Foot Traffic field. Double-click it or drag it to the Heat Depth/Measure area.
Locate the Time Range (minute) field. Double-click it or drag it to the Period/Time area.
NoteYou can only drag date fields of the minute type.
(Optional) To configure tooltips, drag the corresponding fields to the Tooltip/Measure area. You can drag a maximum of five fields.
(Optional) Set filters to screen for the data you need.
Click Update. The system automatically updates the chart. The updated chart appears as shown in the following figure.

Configure Chart Styles
The following section describes how to configure chart styles. For information about common style settings, see Configure the Chart Title.
In the Geographic Area section, set Display Range to Auto or Custom.

In the Heat section, configure Data Mapping Range, Color Settings, Opacity, and Heat Radius.

Configuration Item
Description
Data Mapping Range
You can set a continuous range, an equal-division range, or a custom range.
Color Settings
You can set a sequential gradient, a diverging gradient, or a custom color scheme.
Transparency
Set a value from 0% to 100%.
Heat Radius
Set a value from 5 px to 100 px.
In the Legend section, select Show Legend and configure the legend Position, Background Color, Text style, and whether it is Expanded by Default.

In the Tooltip section, select Enable Tooltip and configure the tooltip background color and text format.
NoteThe tooltip settings for PC and mobile devices are separate. To edit the tooltip for mobile devices, click the PC/Mobile switch button (
) at the top of the dashboard editor to enter the mobile editing view.
In the Feature Configuration section, perform the following configurations.

Configuration Item
Description
① Enable Floor Switching
Check this box to enable floor switching.
Set Position to Top Left, Bottom Left, Top Right, or Bottom Right.
Set whether it is Expanded by Default.
② Enable Timeline and Autoplay on Page Load
Enable Timeline: Check this box to display the timeline.
NoteThis configuration item appears when a time field is configured. It is enabled by default.
Autoplay on Page Load: Check this box to configure the playback interval for autoplay.
NoteYou can configure autoplay on page load after you check Enable Timeline.
The playback interval is in minutes. The minimum value is 1 minute and the maximum value is 60 minutes.
③ Calculation Method
After you check Enable Current Time/Daily Total Switching, Current Time and Daily Total appear in the upper-right corner. You can select one to display by default.

Current Time: Retrieves data from the latest node on the timeline.
Daily Total: Retrieves the summary of all values currently returned.
Chart Analysis Configuration
Configuration Item | Name | Description |
Data Interaction | Filter Interaction | If the data you need to analyze exists in different charts, you can use filter interactions to associate multiple charts for data analysis. For more information about the settings, see Filter Interaction. |
Jump | If the data you need to analyze exists in multiple dashboards, you can use dashboard jumps to associate multiple dashboards for data analysis. For more information about the settings, see Jump. |