Maps are charts divided by continent, country, province, and city, used to display geographic information and related data. On a map, the magnitude of indicators can be distinguished by color intensity. The product currently supports world maps and China maps. The world map supports continent-level and country-level views, while the China map supports province-level and city-level views.
In the visualization query editing interface, you can see the following map icon in the chart:

2.1 Common usage scenarios #

The map visualization format is suitable for analysis projects that require spatial data or datasets containing geographic location information, which can greatly enhance readers' spatial awareness. For example, the average temperature in January across different administrative divisions.
Map example

2.2 Usage process example #

Step 1: Set the geographic role
1. Overview of dimension field configuration

• When editing, set the geographic role for the region field in Dimensions. For example, for the country field below, click the ⋮ next to the field and select the geographic role as Country/Region. Similarly, set the geographic role for the province field in the figure below to match Province/Autonomous Region.

• Generally, geographic roles have hierarchical relationships. You can set a hierarchy for country and province. For example, click the right side of Country, select Create Hierarchy "Country-Hierarchy," and then add Province to the newly created "Country-Hierarchy."

Step 2: Select the chart panel - Map
Select Filled Map here, or choose from other map types. The following sections will introduce operations for multiple map types separately.

Step 3: Drag dimension and metric fields

• Drag or click the Country field in the hierarchy you just set to Dimensions.
• Drag or click the Member Count field to Metrics.
• The effect shown below will appear.

• Click the China map in the chart to drill down into detailed data for each province in China.

Step 4: Modify the chart color scheme as needed For example, use the registration channel to differentiate members from different provinces by their registration channels.

3.1 Edit geographic roles #

3.1.1 Filled map/marked map #

• When using a map, the dimension field must be a geographic role field. If it is not a geographic role field, the visualization chart area will display "The dimension field used by this chart must be set as a geographic role."

• In the field list area, you can set the geographic role for a field and match the field values with the geographic roles. You can optionally match "Country/Region" or "Province/Autonomous Region" (for filled map/marked map) or latitude and longitude/longitude/latitude (for LBS map). This method also allows for custom matching of geographic roles, overcoming the limitations of automatic parsing. The currently available geographic roles include: continent, country/region, province/autonomous region, city, county/district, street, dimension, longitude, latitude, latitude and longitude, and location matching.
• Operation: Click the ⋮ next to the corresponding field, select geographic role, and after selecting the geographic role type, configure the matching relationship between the field values and the geographic roles in the pop-up window.

• To modify the matching relationship, click the ⋮ next to the corresponding field and reselect as needed.
• You can also select geographic role - location matching to enable automatic location matching, and click to modify any part of the automatic matching as needed.

Note: Only one geographic role can be set for a field; it cannot be set as both "Country/Region" and "Province/Autonomous Region" at the same time.

3.2 Filled map/marked map #

3.2.1 Color/edit color #

• If there is no dimension in the color (as in the following case), the color attribute applies to the metric.
  

  • There are six default color schemes. By default, the larger the value, the darker the color. Click to reverse the colors, and the relationship between the color gradient and the value size will be reversed.

    

  • You can also Custom Color Schemes
    

• If there is a dimension in the color (as in the following case), the color attribute applies to the dimension.

  • The system provides default color schemes that can be used directly. After applying a scheme, you can also click an individual dimension field to modify its color scheme.
  
  • You can also select Custom Color Schemes.

3.2.2 Legend #

• You can choose whether to enable the legend. After enabling the legend, you can drag the legend's range to display data for different ranges on the chart.
• You can configure the legend's display position, alignment, maximum number of rows, label font, and font color.
  

3.2.3 Labels #

• You can choose whether to enable labels. After enabling labels, the dimension or metric values will be displayed at the corresponding positions on the map.
• You can select the default style or a custom style. Custom styles allow you to choose the display method, label font, and displayed content.

Caution: In the display method, only one of "Sparse display" or "Allow overlap" can be selected. If one is selected, the other will be grayed out, with a prompt stating "Allow overlap and sparse display cannot be selected at the same time." When the default label display is crowded, it is recommended to select "Sparse display."

3.2.4 Tooltips #

• You can choose whether to enable tooltips. After enabling, when the mouse hovers over a position on the chart, the data corresponding to that location will be displayed. By default, the current dimension and metric values are shown.
• You can add fields to single-point data. The added fields are displayed only as tooltip information and are not involved in chart calculations.

• In advanced settings, you can customize the tooltip content, configure font styles, and insert charts.

3.2.5 Add custom map #

DataWind supports adding custom geographic maps that you create. After adding a custom map in system settings, you can use it in fill maps or marker maps. For instructions on adding a custom map, see Map configuration.
On the Chart tab, click the Fill Map or Marker Map icon. The Custom Map feature toggle will appear below. Click to enable Custom Map, and select your custom map from the dropdown list to use it.

3.3 Map drill-down #

When geographic data contains hierarchical relationships of locations (such as continent-country-province-city), the drill-down feature is supported.

This feature must be used in conjunction with Drill Up and Drill Down.

(1) Taking province/city drill-down as an example, after setting the geographic roles for the province and city fields, move the mouse to the province field, click ┇, select Create hierarchy, and complete the hierarchy creation.

This step requires dataset editing permissions.

(2) You will see that a hierarchical structure appears in the field list. Move the mouse to the city field, click ┇, select Add to hierarchy, and add the city field to the hierarchy created in the previous step.

(3) After completing this step, the hierarchy will be displayed as shown below, and you can then perform drill-down operations. Use the province field as the map dimension to draw a map of China, as shown in the figure.

(4) Click the province you want to view on the map to drill down.

The process for drilling down from the continent level to the country level on the world map is similar; you also need to create and configure the hierarchy, after which drill-down is available.

3.4 Additional notes #

(1) Notification messages
See 3.9 Tooltips information.
(2) Geographic information in the English environment
To meet overseas usage requirements, when the product is switched to the English language, the geographic roles (including country/region, province/autonomous region, and city) and their location matching are automatically set to English.
(3) In-chart control style settings
In-chart controls include in-chart filters, dynamic dimensions/metrics, and in-chart parameters. After displaying them in the chart, you can adjust the layout of the title and filter content, as well as formatting settings.

• Restore default settings: Click Restore Default Settings to restore all the above chart configurations to default.
  (4) Special reminder
• Street-level analysis does not support Hong Kong, Macao, or Taiwan.
• Currently, due to data compliance requirements and related factors, the world map (covering both continent and country levels) is not supported in the SaaS version. We are actively planning related product features and expect to support the world map in future product versions to provide a more complete user experience.