All Products
Search
Document Center

Quick BI:Building Heatmap

Last Updated:Jun 23, 2026

A building heatmap visualizes foot traffic density in physical locations, helping you optimize venue design, booth and product layouts, and traffic distribution analysis across exhibition halls, trade shows, business parks, and shopping malls.

Important

In V6.1, the display logic for the basemap in the building heatmap was updated. The basemap display area now defaults to the dimensions of the uploaded image. You can no longer customize the geographical display range.

Prerequisites

  • You have created a custom image basemap and mapped it to a dataset. For more information, see custom image basemap.

  • You have created a dashboard. For more information, see Create a dashboard.

Overview

Use Cases

Analyze foot traffic density in physical venues to optimize venue design, booth and product layouts, and traffic distribution across exhibition halls, trade shows, business parks, and shopping malls.

Key Features

Visualize heat data across multiple floors or venues, switch between them, and toggle between point-in-time data and cumulative daily data.

Example

image

Create the Chart

  1. In the dashboard editor, select building heatmap.

    image

  2. Select a dataset that is mapped to a custom image basemap. For more information about how to create a custom image, see custom image basemap.

    image.png

Configure Chart Fields

  1. On the Fields tab to the right of the chart, select the required dimension and measure fields.

    • In the coordinate data/dimension list, find the x and y fields. Double-click or drag them to the coordinate data/dimension area.

      Note

      This chart supports only geographic fields of the custom image type.

    • In the Dimensions list, find the floor field. Double-click or drag it to the floor/dimension area.

      Note

      Ensure that the floor names in your data exactly match the floor names in the custom image basemap. Otherwise, the chart will not render the data.

    • (Optional) You can drag a dimension field to the area location tag/dimension area to specify the location data for area nodes.

    • In the Measures list, find the foot traffic field. Double-click or drag it to the heat depth/measure area.

    • Find the time range (minute) field. Double-click or drag it to the time period/time area.

      Note

      This field supports only date fields with minute-level granularity.

    • (Optional) To add a tooltip, drag the desired fields to the tooltip/measure area. You can add up to five fields.

  2. (Optional) You can set a filter to display only the data you need.

  3. Click Update. The system automatically updates the chart. The updated chart appears as follows.

    image

Configure Chart Styles

Configure the style settings below. For general style settings, see Configure the chart title area.

  • In the Heat section, configure Data mapping, Color, Transparency, and heat radius.

    111

    Parameter

    Description

    Data mapping

    Supports continuous intervals, equal intervals, and custom intervals.

    Color

    Supports sequential gradient, diverging gradient, and custom color schemes.

    Transparency

    Range: 0% to 100%.

    Heat radius

    Range: 5px to 100px.

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

    Note

    The tooltip settings for PC and mobile views are independent. To configure the tooltip for the mobile view, switch to the mobile editor by clicking the PC/Mobile toggle button (image) at the top of the dashboard editor.

    image

  • In the Feature configuration section, configure the following settings.

    image

    Parameter

    Description

    ① Enable floor switch

    Allows switching between floors.

    • You can set the Position to top left, bottom left, top right, or bottom right.

    • You can also choose whether to Expand by default.

    ② Enable timeline and Auto play on page load

    • Enable timeline: Shows the timeline on the chart.

      Note

      This option appears after you configure a time field. It is enabled by default.

    • Auto play on page load: Configures the playback interval for autoplay.

      Note
      • You can configure this option only after you select Enable timeline.

      • The playback interval ranges from 1 to 60 minutes.

    ③ Calculation method

    Select Enable current time/total today switch to display a toggle in the upper-right corner of the chart. You can choose which view to display by default.

    image.png

    • Current time: Shows data from the latest point on the timeline.

    • Total today: Shows the aggregated data for the current day.

Analysis Configuration

Category

Name

Description

Data interaction

Linkage

Connect multiple charts for interactive analysis using linkage. For more information, see Linkage.

Jump

Connect multiple dashboards for cross-dashboard analysis using the jump feature. For more information, see Jump.