# Geo Cluster Layer

EV charging network overview where clusters reveal how many stations are available, charging or faulted before zooming in.

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

## Install

```bash
agentic-ui add geo-cluster-layer
npx shadcn@4.17.0 add @agentic-ui/geo-cluster-layer
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** point-clustering, zoom-dependent-grouping, hover-preview, focus-preview, category-breakdown, zoom-to-cluster, zoom-controls, drag-pan, category-filter, point-selection, empty-state, filtered-empty-state, error-state-retry, loading-skeleton, keyboard-navigation, live-announcements
- **Intents:** explore-detail, track-status, navigate
- **Suits domains:** maps-ops, operations, travel, aviation, ecommerce, analytics
- **Interaction:** hover-preview, zoom-to-cluster, zoom, pan, filter, select, keyboard-navigation
- **Screen role:** overview
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** EV charging network overview where clusters reveal how many stations are available, charging or faulted before zooming in, field service or fleet depots grouped by region with a status mix preview, store or pickup point coverage map for an e-commerce operations console, hotel or listing density map in a travel marketplace search page
- **Avoid when:** fewer than about 20 locations, where plain markers are clearer, precise street-level cartography with tiles, routing or geocoding (use travel-map-explorer or flightops-live-map-console), comparing aggregated metrics per administrative area (use a choropleth such as geo-area-comparison)
- **Preserve when adapting:** deterministic-clustering, preview-on-hover-and-focus, zoom-to-extent-on-activate, roving-keyboard-model, live-announcements
- **Replace when adapting:** point-fixtures, categories-and-colors, outline-geometry, item-noun-and-copy, cluster-radius-and-max-zoom
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 8.85/10
- **Quality breakdown:** visual 9/10, responsive 8/10, accessibility 8/10, code 9/10
- **Uses primitives:** card, button, badge, alert, skeleton
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives, lib-tokens