Vega-Lite US States Choropleth

A US-states choropleth coloured by a numeric attribute — the canonical American election / census / sales / unemployment map. Vega-Lite loads the official US Atlas TopoJSON from CDN, projects with `albersUsa` (which folds Alaska and Hawaii into the lower-48 frame), joins your dat

Template details

  • chart
  • map
  • choropleth
  • us-states
  • vega
  • vega-lite

When to use this template

This visualization effectively reveals the geographic distribution and spatial patterns of a single quantitative metric across the United States. Analysts use it to quickly identify states or regions with high or low values, compare magnitudes between states, and uncover potential regional trends or disparities. It is ideal for understanding how a specific attribute varies across the American landscape.

  • Data aggregated to the US state or territory level.
  • Datasets containing a unique identifier for each US state (e.g., FIPS code, state name).
  • Includes one primary quantitative variable for visual encoding.
  • Measures that are directly comparable across different states.
  • Data representing a single point in time or a time-aggregated value.
  • Relatively low cardinality (50 states + DC/territories).

Browse all Koan templates