# Map Store Locator

Store locator with search, distance sort and an open now filter beside a map.

- id: `map-store-locator`
- Page: https://agentic-ui-kit.com/components/map-store-locator
- Live preview: https://agentic-ui-kit.com/live/component/map-store-locator?piece=map-store-locator

## Install

```bash
agentic-ui add map-store-locator
npx shadcn@4.17.0 add @agentic-ui/map-store-locator
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** store-locator, search-filter, distance-sort, open-now-filter, list-map-sync, numbered-pins, opening-hours-model, overnight-and-split-hours, use-my-location, offline-svg-map, store-detail-panel, dark-mode
- **Intents:** explore-detail, navigate
- **Suits domains:** ecommerce, travel, maps-ops, logistics, healthcare, marketing
- **Interaction:** search, filter, sort, list-map-sync, keyboard-navigation
- **Screen role:** overview
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** store locator with search, distance sort and an open now filter beside a map, find the nearest branch, pharmacy or clinic with opening hours, pickup point finder where the list and map stay in sync, dealer or restaurant finder with phone and directions
- **Avoid when:** a full interactive basemap with pan and zoom tiles (use travel-map-explorer), routes and moving vehicles (use map-route-animation or a live fleet map), a handful of addresses that a plain list serves
- **Preserve when adapting:** hours-model, list-map-sync, distance-sort
- **Replace when adapting:** stores, origins, map-backdrop, copy, units
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 8/10, accessibility 9/10, code 9/10
- **Uses primitives:** button, input
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives