Overview
The full-screen interactive map at /map is the core feature of the HURE platform, allowing users to explore all 3,222 US counties and find their ideal relocation destination.
Key Features
Geographic Visualization
- Complete Coverage: All 3,222 US counties rendered as interactive polygons
- Color Coding:
- Green = Partner brokerage available
- Blue = Available for partnership
- Hover effects for interactivity
Natural Language Search
The search bar supports natural language queries like:
- “Where should I move if I like skiing?”
- “Find counties near the ocean”
- “Show me affordable places with good schools”
The tooltip clearly indicates this capability to users.
Interactive Controls
- Pan & Zoom: Standard map navigation
- County Click: View detailed information about each county
- Search Bar: Text-based search with autocomplete
- Filter Options: Filter by availability status, state, or region
Technical Architecture
- Frontend: Leaflet.js with React components
- Backend: FastAPI with geospatial queries
- Data: GeoJSON county boundaries from US Census Bureau
- Search: Vector similarity search using sqlite-vec and Ollama embeddings
- Performance: Client-side caching of county polygons
User Workflows
Military Family Relocating
- Enter PCS orders location or natural language query
- View available counties near base or matching preferences
- Click county to see partner broker details
- Contact broker directly for relocation assistance
Broker Exploring Territories
- View map to identify open counties
- Filter by state or region of interest
- Check competition and demand metrics
- Apply for exclusive county partnership
Testing Results
- ✅ All 3,222 counties load and render correctly
- ✅ Natural language search tooltip displays
- ✅ Color coding accurately reflects broker availability
- ✅ Map controls (pan, zoom) work smoothly
- ✅ County polygons are clickable and responsive
- ✅ Search bar is prominently displayed
- ✅ Console shows “Loaded 3222 counties” confirmation