Geo Area Charts
Geo area charts visualize data across geographic areas using choropleth mapping. They display values aggregated by regions such as countries or administrative areas and color each region based on a metric or attribute value.
Geo area charts are built on a modern geospatial foundation and are suitable for analyzing regional performance, distribution, and comparisons.
Geo area charts have the following sections:
- Area
- Metric (Color)
- Segment by
- Configuration
For information about common characteristics and settings of all visualizations, see the Visualization Types section.
Access Tokens
GoodData Cloud users are automatically provided with a Mapbox access token to enable geo area charts, however, as an administrator you can choose to use your own access tokens as well. See the Upload Access Tokens for Geo Charts section for details.
Prepare Your Data
To use geo area charts, your data must include geographic identifiers that GoodData can map to predefined areas.
Geographic Identifiers
Your dataset must contain a column with supported geographic codes based on ISO 3166 standards:
- Countries: ISO 3166-1 alpha-2 (for example,
US,DE,FR) - Regions: ISO 3166-2 (for example,
US-CA,US-NY,FR-IDF)
Logical Data Model (LDM)
In the Logical Data Model, map the column containing geographic codes as a Geo area label. This mapping enables GoodData to correctly associate your data with geographic shapes in the map.

