# Chart Geo Choropleth

Choropleth world map of customers or revenue by country with legend and hover.

- id: `chart-geo-choropleth`
- Page: https://agentic-ui-kit.com/components/chart-geo-choropleth
- Live preview: https://agentic-ui-kit.com/live/component/chart-geo-choropleth?piece=chart-geo-choropleth

## Install

```bash
agentic-ui add chart-geo-choropleth
npx shadcn@4.17.0 add @agentic-ui/chart-geo-choropleth
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** choropleth-map, world-map, us-states-map, bundled-offline-geometry, binned-color-scale, region-hover-readout, ranked-table-alternative, name-or-code-matching, dark-mode
- **Intents:** show-composition, explore-detail
- **Suits domains:** analytics, ecommerce, marketing, finance, logistics, healthcare
- **Interaction:** hover-readout, table-selection, legend
- **Screen role:** overview
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** choropleth world map of customers or revenue by country with legend and hover, US states map shaded by store density, sales or incidents, regional heat map with a ranked table of countries for screen readers, offline map that needs no tile server or API key
- **Avoid when:** individual points or routes on a map (use map-route-animation or map-store-locator), regions finer than countries or US states (counties, postcodes) which need other geometry, values that must be compared precisely (use a sorted bar chart beside it)
- **Preserve when adapting:** binned-ramp, ranked-table, bundled-geometry
- **Replace when adapting:** data, value-label, formatter, map-choice
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 8/10, accessibility 8/10, code 9/10
- **npm dependencies:** d3-geo, topojson-client
- **npm dependencies (registry):** d3-geo@^3.1.1, topojson-client@^3.1.0
- **Registry dependencies:** lib-primitives