Overview
A Geo Chart renders dataset values on a geographic map. Measure values are represented through two complementary rendering modes: heat-range region shading (color-shaded regions) and on-map data symbols (proportional bubbles or points sized by Measure). The chart supports country-level and state-level geography. Geo Charts are the standard Lens visualization for location-based analysis — regional sales, customer distribution, branch network performance where the geographic dimension of the data is the analytical narrative.
Geo Charts are authored from Lens → Design → Chart Designer → Visualization → Geo Chart. The Geo Chart property group exposes the chart-specific configuration: Country, State, labels, heat range, on-map symbols, and map styling. Other Properties and Columns inherit from Table Chart and Bar Chart. A per-column Label toggle on the Columns tab is Geo Chart–specific.
When to use it
- Regional analysis — sales by region, customer count by country, performance by state.
- Geographic concentration visualization — where is activity concentrated, where are gaps.
- Point-based distribution — branch locations, customer addresses, event locations rendered as on-map symbols.
Geo Chart property group
The Geo Chart group exposes the chart-specific configuration.
Country and State
| Country | Selects the country-level geography for the map. |
| State | Selects the state-level geography. |
Labels
| Enable labels (chart-level) | Controls whether labels render on the map. |
Heat range (region shading)
| Heat Range | Color gradient applied to map regions based on Measure values. |
On-map data symbols
| Show Data on Map Area (toggle) | When on, proportional symbols render on the map at geographic positions of the Dimension values. Symbol size and color reflect the Measure value. |
| Max Range Color | Color of the symbol representing the highest Measure value. |
| Min Range Color | Color of the symbol representing the lowest Measure value. |
| Min Radius | Smallest symbol size in pixels, corresponding to the lowest Measure value. |
| Max Radius | Largest symbol size in pixels, corresponding to the highest Measure value. |
Map styling
| Background Color | Color of the map background (the area outside drawn regions). |
| Stroke Color | Color of region boundary lines. |
Columns tab — Geo Chart–specific
| Label (toggle, per-column) | Per-column toggle that controls whether the column’s labels appear on the map. |
Properties and Columns — inherited
All other Properties and Columns customization inherits from Table Chart and Bar Chart.
| Table Chart Properties | Properties documented on Table Chart that apply to Geo Chart. | Table Chart PD → Properties tab |
| Bar Chart Properties | Properties documented on Bar Chart that apply to Geo Chart. Axis-related properties (X-Axis, Y-Axis, Multi-Axis) have no Geo Chart equivalent. | Bar Chart PD → Properties tab |
| Columns tab — inherited settings | Per-column settings (Content Properties, Column Settings, Data Format, Category, Drilldown & Groups). | Bar Chart PD → Columns tab; Table Chart PD → Columns tab |
Key behaviors
Geographic Dimension matching. Geo Chart matches Dimension column values against Lens’s built-in country and state geography. For Dimension values to render, they need to match the geography’s expected naming.
Two rendering modes. Heat range shades whole regions by Measure value. On-map symbols overlay sized points at geographic positions (proportional symbol map style). Both can render on the same chart.
Color range maps two endpoints. Min Range Color and Max Range Color define the gradient endpoints for on-map data symbols. The lowest Measure value renders in the Min Range Color, the highest in the Max Range Color, and intermediate values interpolate between them. The same two-endpoint pattern applies to Heat Range.Use Geo Chart for geographic concentration; Bar Chart for value comparison. Both Geo Chart and Bar Chart can render the same data (a Measure across geographic groups). Geo Chart emphasizes the geographic relationship. Bar Chart emphasizes the value comparison. Pick by whether the analytical narrative is “where” (Geo) or “how much” (Bar).