World Map¶
Used to display data distribution across different countries or regions worldwide, with colors representing data magnitude. Region labels can be country identifiers, or city names in Chinese or English.
Use Cases¶
- Display data distribution across different regions
- Show data magnitude rankings across different regions
Chart Query¶
Prerequisites
The query result must include a region label that represents countries or cities, and be grouped by that label; otherwise the chart cannot correctly match and display regional data.
Four query methods are supported:
- Simple Query
- Expression Query
- PromQL Query
- Data Source Query
You can add multiple queries, but the by (group) Tag must be consistent. Changing one will automatically synchronize the changes to the others.
For more details on chart query conditions, see Chart Query.
The chart query matches countries or regions by the region label, and determines the area color by the metric value:
| Option | Description |
|---|---|
| Country Label | Select the region label that has been grouped in the query. The label name does not need to be fixed as "country"; the value can be a country name, compatible alias, ISO alpha-2, alpha-3, numeric code, or city name in Chinese or English. |
| Metric | When multiple metric queries are added, you can set the primary metric to display. The "primary display metric" determines the color gradient of the areas. |
Region Matching Rules¶
- When using a country or region identifier, the metric value is directly aggregated to the corresponding area.
- When using a city name, the system first matches the city to its country or region, then colors the corresponding country or region area.
- When multiple cities belong to the same region, their metric values are summed for display.
- Cities with duplicate names that cannot be definitively assigned to a country, or unrecognized regions, will not participate in area coloring. Other recognizable regions will still display normally.
The map supports dragging, zooming, and hovering to view data. When clicking an area, variable linking still uses the original region label value returned by the query, not the display name converted by the map.