A bubble map displays data as bubbles on a map, where bubble size represents data values. Use bubble maps to visualize the magnitude and distribution of key metrics across geographical locations, such as tourist traffic at various attractions or per capita income across regions.
Prerequisites
-
A dashboard has been created. For more information, see Create a dashboard.
-
Make sure the geographical area field that you want to add has been converted to a geographical data type. For more information, see Configure fields.
NoteFor example, if you want to use a field named area for the map, it must first be converted to a geographical data type, indicated by the
icon. For a detailed mapping table of regions, see public-area-info.xlsx. This file is for geographical area matching only and does not represent the political views of Quick BI.
Limitations
If you create a bubble map in area name mode, the map is composed of area name/dimension, bubble size/measure, and bubble color/measure:
-
Area name is determined by a dimension in your data. You can select up to one dimension, and it must be a geographical data type, such as province.
-
Bubble size is determined by measures in your data. You must select at least one measure and can select up to five measures, such as shipping cost and order quantity.
-
Bubble color is determined by a measure in your data. You can select up to one measure, such as order amount.
If you create a bubble map in longitude and latitude mode, the map is composed of longitude and latitude/dimension, location label/dimension, bubble size/measure, and bubble color/measure:
-
Longitude and latitude is determined by dimensions in your data. You can select up to one longitude field and one latitude field.
-
Location label is an optional field determined by a dimension. It supports string and geographical dimension types.
-
Bubble size is determined by measures in your data. You must select at least one measure and can select up to five measures, such as shipping cost and order quantity.
-
Bubble color is determined by a measure in your data. You can select up to one measure, such as order amount.
Overview
Use cases
Bubble maps are ideal for datasets that contain geographical information. They represent summarized data for specific regions by mapping data points as bubbles onto their corresponding geographical locations.
Benefits
-
Provides clear visualization with marker-style point maps.
-
Supports rich interaction, allowing you to lasso-zoom, switch metrics, and apply filters directly on the chart.
Example

Field configuration
-
On the Data tab, select the required dimension and measure fields:
-
For geographical information, you can create the map by using either the area name or longitude and latitude mode.

-
If you select area name, double-click or drag the province field to area name/dimension.
-
If you select longitude and latitude, double-click or drag the longitude and latitude fields to longitude and latitude/dimension. The location label/dimension field is optional.
-
-
In the Measures list, find order amount, then double-click or drag it to bubble size/measure.
-
In the Measures list, find shipping cost, then double-click or drag it to bubble color/measure.
-
-
Click Update to refresh the chart.
NoteIf some area values in your data do not match the standard geographical names supported by the system, a warning icon appears in the lower-right corner of the chart. Click the icon to view the details of the unmapped data to help you identify and fix data issues.

-
In the Unmapped Data Details dialog, you can view the unmapped data and copy it with a single click. You can then paste the copied content into the field configuration page of the dataset to perform batch processing and correct the data more efficiently.

-
After you configure the mappings, the map data is displayed correctly.
-
Chart styles
Configure the styles for the chart. For information about general style settings, see Configure the chart title area.
You can enter a keyword in the Search box at the top of the configuration pane to quickly find a setting. You can also click the
icon to Expand/Collapse All Categories.

Geographical area
In the Geographical area section, configure display range, Outline and fill, and Show basemap.
-
For Display range, you can select Auto or Custom. In this example, China is selected.
Note-
Auto automatically adjusts the map view based on the data range. Custom allows you to set the range manually. During interactive analysis, the map view always adjusts automatically to the data range, regardless of this setting.
-
The custom display range currently supports global continents and countries, as well as regions, provinces, and cities in China.

-
-
Turn on Manual adjustment to automatically generate the current Center point and Zoom level, which you can then modify manually.

-
Under Outline and fill, you can configure the Fill color and Outline color.
NoteOutlines are not supported for some regions.

Basemap
In the Basemap section, configure whether to Show basemap, the Basemap style, and whether to Show global basemap.
-
Show basemap: Click the
switch to show or hide the basemap.
-
Basemap style: Supports multiple styles for the AMAP basemap.

-
Show global basemap: Select this option to display global city information on the basemap.
NoteGlobal basemap usage limit: Each Quick BI organization can preview map charts with overseas basemap information up to 1,000 times per month. This is calculated based on the number of basemap initializations. If the limit is exceeded, the basemap will display information only for China.
Bubble
In the Bubble section, configure bubble color, Extreme value color, Bubble shape, bubble size, and 0 value handling.
-
Bubble color: Configure the theme color, transparency, data mapping range, and number of ranges.

-
Extreme value color: Configure and apply specific colors for maximum, minimum, top three, and bottom three values.

-
Bubble shape: Supports four shapes: circle, triangle, rectangle, and diamond.

-
Bubble size: Drag the slider to change the size of the bubbles.

-
0 value handling: Choose from three options: Do not display, Follow data range, or Fixed bubble size.

Data labels
In the Data labels section, configure Show data labels, Label display mode, and settings for Content, position, and text style.
-
Show data labels:
-
If the map is created using the area name mode, you can display both the area name and the measure.
-
If the map is created using the longitude and latitude mode, you can display both the longitude and latitude and the measure.

-
-
Position: The default is Auto. You can also select Top of bubble, Bottom of bubble, or Center of bubble.

-
Label display mode: Select Full display to show all label content.

-
Text style: Configure the text style for the area name, longitude and latitude, and measure data labels.

Total
In the Total section, you can display an automatic summary of the total value for measures in the chart.
Legend
In the Legend section, click the
icon to enable the chart legend and configure its style.

|
Parameter |
Description |
|
Position |
Set the display position and alignment of the legend.
|
|
Background color |
Set the background fill color for the legend. |
|
Text |
Set the text style for the legend, including font color, size, weight, and whether it is italicized. |
|
Mobile legend settings |
The legend settings for PC and mobile are independent. Switch between PC and mobile views by using the toggle button ( |
Tooltip
In the Tooltip section, click the
icon to enable tooltips and configure their style.

|
Parameter |
Description |
|
Background color |
Set the background fill color for the tooltip box. |
|
Text |
Set the text style for the tooltip box, including font color, size, weight, and whether it is italicized. |
|
Mobile tooltip |
The tooltip settings for PC and mobile are independent. Switch to the mobile view by using the toggle button ( |
Auxiliary display
In the Auxiliary display section, enable the metric filter and then select the metrics you want to display.

Advanced settings
|
Parameter |
Name |
Description |
|
Data interaction |
Drill-down |
After you configure drill-down fields in the data pane, you can set the display style for drill-down levels. For more information, see Drill-down. |
|
Interaction |
To analyze data across multiple charts, you can link them for interactive analysis. For more information, see Interaction. |
|
|
Navigation |
To analyze data across multiple dashboards, you can link them for analysis. Navigation supports two modes: Parameter navigation and External link. For more information, see Navigation. |
|
|
Annotation |
- |
When data in a chart is anomalous or requires special attention, you can use color highlights, icons, comments, or data points to create annotations.
|




switch to show or hide the basemap.











) at the top of the dashboard editor to configure the legend for each device. You can customize the position, background color, and text style for the mobile legend.
