Geographic Charts

Dashboard supports four types of geographic visualizations for mapping data across regions, countries, and the globe. Geographic charts require GeoJSON map assets and are powered by ECharts (lazy-loaded on first use).

Map Types

Choropleth Map

Fills geographic regions with colors based on data values. Best for showing how a metric varies across regions (e.g., revenue by country, customer count by state).

  • Regions are colored on a gradient scale from low to high values

  • Hover to see the exact value for each region

  • Requires a Region Field that matches the GeoJSON property codes

Scatter Map

Places data points on a map using latitude and longitude coordinates. Best for showing the location and relative magnitude of data points (e.g., customer locations, warehouse positions).

  • Point size can represent data magnitude

  • Requires Latitude and Longitude fields in your data model

Flow Map

Draws connection lines between locations to show movement or relationships. Best for visualizing shipping routes, migration patterns, or communication flows.

  • Lines connect origin and destination points

  • Line thickness or animation can represent volume

3D Globe

Renders data on an interactive 3D globe with rotation and zoom. Best for impressive presentations and global-scale data.

  • Supports WebGL rendering

  • Interactive rotation, zoom, and tilt

  • Can overlay data as colored regions, points, or bars on the globe surface

Warning

3D Globe requires WebGL support in the browser. Performance depends on hardware capabilities and data volume.

Creating a Geographic Chart

Step 1: Select a Geographic Chart Type

  1. Navigate to Dashboard ‣ Chart Library

  2. Click New

  3. Set the Chart Type to one of the geographic options: Choropleth Map, Scatter Map, Flow Map, or 3D Globe

Step 2: Configure the Data Source

  1. Select the Data Model containing your geographic data

  2. Define Measures for the values to display on the map

  3. Optionally add Filters to narrow the data

Step 3: Configure Geographic Settings

When you select a geographic chart type, a Geographic tab appears:

For Choropleth Maps:

  • Map Asset - Select the GeoJSON map to use (World, USA, Europe, or a custom map)

  • Region Field - The field in your data model that contains region codes matching the GeoJSON regions (e.g., country_id.code for ISO country codes)

  • Value Field - The field containing the numeric values to display

For Scatter Maps:

  • Map Asset - Select the base map

  • Latitude Field - The field containing latitude values

  • Longitude Field - The field containing longitude values

For Flow Maps and 3D Globe:

  • Map Asset - Select the map or globe base layer

  • Configure origin and destination coordinate fields

Built-in Map Assets

Dashboard includes three built-in GeoJSON map assets:

Map

Description

Regions

Region Property

World Countries

All world countries

~180

ISO_A3 (3-letter country codes)

United States

US states

50 + territories

STUSPS (2-letter state codes)

Europe

European countries

~45

ISO_A3

Note

Built-in maps cannot be modified or deleted. Their region property and GeoJSON data are protected.

Custom Map Assets

Administrators can upload custom GeoJSON maps for specialized geographic visualizations:

  1. Navigate to Dashboard ‣ Configuration ‣ Chart Data Sources

    Note

    GeoJSON asset management is available to System Administrators only.

  2. Upload a GeoJSON file as an attachment

  3. Configure the asset:

    • Name - Display name for the map

    • Code - Unique identifier (alphanumeric, underscores, hyphens)

    • Region Property - The GeoJSON feature property used for region identification

    • Name Property - The GeoJSON feature property used for display names

    • Bounds - Optional JSON bounding box for the initial view

Map Drill-Down

GeoJSON assets support parent-child relationships for drill-down navigation:

  • A World map can drill down to a USA map when the user clicks on the United States region

  • Configure the Parent Map and Child Region Filter fields on the child asset

Tip

When creating custom maps, ensure your GeoJSON file follows the standard GeoJSON format with a features array. Each feature should have a properties object containing the region identifier and display name.

See also