All Products
Search
Document Center

Quick BI:Building Heatmap

Last Updated:Feb 09, 2026

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

image

Create a Chart

  1. In the dashboard editor, select Building Heatmap.

    image

  2. 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.

    image.png

Configure Chart Fields

  1. 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.

      Note

      Only 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.

      Note

      Ensure 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.

      Note

      You 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.

  2. (Optional) Set filters to screen for the data you need.

  3. Click Update. The system automatically updates the chart. The updated chart appears as shown in the following figure.

    image

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.image.png

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

    Untitled.gif

    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.

    Untitled.gif

  • In the Tooltip section, select Enable Tooltip and configure the tooltip background color and text format.

    Note

    The tooltip settings for PC and mobile devices are separate. To edit the tooltip for mobile devices, click the PC/Mobile switch button (image) at the top of the dashboard editor to enter the mobile editing view.

    image

  • In the Feature Configuration section, perform the following configurations.

    image

    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.

      Note

      This 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.

      Note
      • You 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.

    image.png

    • 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.