Skip to main content
Map charts visualize geographic data in two modes:
  • Point map — plot rows at their latitude/longitude coordinates, optionally sized and colored by additional fields.
  • Region map — paint polygons (countries, US states, or any custom GeoJSON) as a choropleth driven by a measure.

​
When to use

  • Point map — locations with known coordinates (stores, shipments, sign-ups), geographic clusters and outliers.
  • Region map — measures aggregated by country, state, postcode, sales territory, or any user-defined polygon set.

​
Chart type

Pick Point or Region in the chart settings panel’s Type row. The default is Point.

​
Projection

Both modes support either projection.

​
Point map

A point map requires:
  • Latitude — numeric field containing decimal latitude.
  • Longitude — numeric field containing decimal longitude.
Optional:
  • Size — numeric measure that scales point radius proportionally.
  • Color — dimension or measure that colors points by category or value.

​
Point color

When no Color field is assigned, all points render in the configurable Default color. When a dimension is assigned, each unique value gets a distinct color from the active palette — pick from the built-in palettes or supply a custom one, see Color and stacking.

​
Point size

Assign a numeric measure to the Size channel to scale point radius by value. The size range (minimum and maximum radius in pixels) is configurable in the settings panel.

​
Clustering

Clustering groups nearby points into a single circle that expands on zoom. It is off by default and can be enabled in the settings panel.

​
Region map

A region map requires:
  • Source — the GeoJSON to render: World countries, US states, or Custom.
  • Property — which property in each GeoJSON feature acts as the join key (e.g. name, ISO3166-1-Alpha-2, state_code).
  • Dimension — which column from your query joins to Property.
  • Measure — the numeric measure that drives the choropleth fill.
Built-in sources expose a fixed list of allowed properties. Custom lets you point at any public GeoJSON URL; the property dropdown then enumerates every key present in the feature collection. When the chart enters Region mode, the join dimension and measure are auto-picked when an unambiguous match exists in your query.

​
Country name matching

With World countries, country names do not have to be spelled the way the boundary data spells them. Long forms, endonyms, and common abbreviations all resolve to the same country, so United States, United States of America, USA, and US are interchangeable, as are Brasil and Brazil, or Deutschland and Germany. The same applies to the 2- and 3-letter ISO code properties, and it works in either direction — a name in your data still matches when Property is set to a code. Matching is exact, never approximate: United States resolves to the United States and never to United States Minor Outlying Islands. Bare 2-letter codes are only treated as country codes when Property is set to one of the ISO code properties, so a column of US state codes joined against country names stays unmatched rather than colouring DE as Germany. This applies to World countries only. With US states or Custom, values must match the chosen Property exactly (ignoring case and surrounding whitespace). The choropleth gradient comes from the active palette — pick from the built-in palettes or supply a custom one, see Color and stacking.

​
Custom GeoJSON

When Source is set to Custom, paste a URL serving a GeoJSON FeatureCollection. Requirements:
  • Served over HTTPS with CORS enabled.
  • Polygons or multipolygons (not points or lines).
  • Each feature must have a properties object containing the join key.
The fetched GeoJSON is cached for the session.

​
Unmatched regions

Regions in the GeoJSON with no matching data row are hidden by default. Toggle Fill unmatched in the settings panel to render them with the Default color at reduced opacity instead.

​
Tooltip fields

The Tooltips section controls which fields appear when a user hovers over a point or region. See Tooltips.

​
Map interaction

The map is interactive — users can pan and zoom. Viewport changes persist while you edit other settings; switching the data source or projection re-fits the camera to the new bounds.