# Geo Area Comparison

Regional sales scorecard: net sales, orders, order value and return rate by state.

- id: `geo-area-comparison`
- Page: https://agentic-ui-kit.com/components/geo-area-comparison
- Live preview: https://agentic-ui-kit.com/live/component/geo-area-comparison

## Install

```bash
agentic-ui add geo-area-comparison
npx shadcn@4.17.0 add @agentic-ui/geo-area-comparison
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** choropleth-map, metric-switch, absolute-or-benchmark-shading, diverging-benchmark-scale, fixed-or-mean-benchmark, direction-aware-deltas, side-by-side-area-comparison, best-value-highlight, ranked-area-list, area-filter, hover-tooltip, custom-geometry, unmatched-region-notice, keyboard-roving-focus, live-announcements, controlled-or-uncontrolled, loading-state, error-state, empty-state
- **Intents:** explore-detail, track-status
- **Suits domains:** analytics, ecommerce, operations, maps-ops, marketing, saas
- **Interaction:** hover-tooltip, click-select, keyboard-navigation, toggle, filter
- **Screen role:** overview
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** Regional sales scorecard: net sales, orders, order value and return rate by state, Country engagement against a fixed target, shaded by how far each country is above or below it, Side-by-side comparison of two or three sales territories on every KPI, Service-level metrics by district with a custom outline set
- **Avoid when:** A single metric with no comparison need (use chart-geo-choropleth), Point locations such as stores or vehicles (use map-store-locator or a live map), Trends over time for one area (use a timeseries chart)
- **Preserve when adapting:** benchmark-delta-semantics, list-as-keyboard-route, compare-cap-and-refusal-message, state-triad-loading-error-empty
- **Replace when adapting:** domain-copy, metrics-and-formats, outline-set, benchmark-values-and-label, area-noun
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 8.9/10
- **Quality breakdown:** visual 8/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** button, input, skeleton
- **npm dependencies:** chart-geo-choropleth, lucide-react
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Used in:** IoT Energy Monitoring (blueprint)
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-charts-maps-2, lib-primitives
