# Geo Store Locator

Retail or brand storefront locators helping customers find nearby branches with opening hours and services.

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

## Install

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

## Metadata

- **Level:** feature
- **Category:** feature
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** store-search, diacritic-insensitive-search, distance-calculation, radius-filter, open-now-filter, service-chips, unit-toggle, sorting, synchronized-map, custom-origin-selection, pan-and-zoom, pin-drop-origin, search-this-area, seven-day-schedule, holiday-exceptions, store-contact-actions, roving-keyboard-navigation, empty-state, error-state-retry, loading-skeleton, live-announcements, responsive-view-toggle
- **Intents:** navigate, explore-detail, manage-collection
- **Suits domains:** ecommerce, travel, maps-ops, logistics, culinary, operations
- **Interaction:** search, filter, sort, click, drag, zoom, keyboard-navigation
- **Screen role:** flow
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** retail or brand storefront locators helping customers find nearby branches with opening hours and services, travel or rental pickup point finders showing vehicle or equipment depots within driving distance, hospitality or restaurant chains listing locations with dining hours and special amenities, logistics or parcel locker drop-off points with service capabilities and operating hours
- **Avoid when:** picking a single delivery or pickup coordinate from scratch (use geo-location-picker), defining geographic boundaries or zones (use geo-geofence-editor), exploring dense regional cluster distributions without store details (use geo-cluster-layer)
- **Preserve when adapting:** haversine-distance-model, weekly-hours-evaluation-and-exceptions, list-map-selection-synchronization, roving-keyboard-tab-model, live-announcements
- **Replace when adapting:** store-dataset, service-filter-definitions, basemap-features, origin-presets, domain-copy
- **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, alert, skeleton, input
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives, lib-tokens