Map Search

Find properties by exploring neighborhoods visually with our interactive map interface.

Overview

The Map Search (/map) provides a visual property discovery experience using an interactive Leaflet map with real-time filtering, clustering, and draw-to-search capabilities.

Map Controls

Map Styles

Toggle between three map views using the buttons in the top-right corner:

Style	Description
Street	OpenStreetMap road map (default)
Satellite	Aerial imagery from ESRI
Hybrid	Satellite with road labels overlay

Zoom & Navigation

• Scroll to zoom in/out
• Click and drag to pan the map
• Zoom buttons in bottom-left corner
• Double-click to zoom in on a location

Property Markers

Markers automatically adapt based on zoom level and property density:

Marker Types

Density	Marker Style	Description
Low (< 12 properties)	Rich Marker	Property photo + price bubble
Medium (12-50)	Medium	Smaller photo + price
High (50+)	Compact	Price pill only

Marker Interactions

• Hover — Highlights marker and corresponding card in sidebar
• Click — Opens property detail page
• Favorites — Red border indicates saved properties

Marker Clustering

When many properties are in view, markers cluster together:

• Blue cluster — Small group (< 20)
• Orange cluster — Medium group (20-50)
• Red cluster — Large group (50+)

Click a cluster to zoom in and expand it. Toggle clustering on/off with the “Clusters” button.

Draw-to-Search

Create custom search areas by drawing a polygon:

1. Click the Draw button (pencil icon)
2. Click on the map to place polygon vertices
3. Double-click to complete the polygon
4. Properties within your shape appear in the sidebar

To clear the polygon, click Clear on the “Custom area active” indicator.

Filters

Quick filters update results in real-time:

Price Range

• Under $300K
• $300K - $500K
• $500K - $750K
• $750K - $1M
• $1M+

Bedrooms

• 1+ through 5+ beds

Property Type

• Single Family
• Condo
• Townhouse
• Manufactured
• Land

Auto-Search Toggle

• Enabled (default) — Results update as you pan the map
• Disabled — Click “Search This Area” to update manually

Sidebar

The sidebar displays properties visible in the current map view:

Property Cards

Each card shows:

• Property photo with hover zoom
• Price prominently displayed
• Street address and city
• Bed/bath/sqft summary
• Editorial “hook” (e.g., “New Construction”, “Great Value”)
• Street View link (opens Google Street View)

Card Interactions

• Hover on a card to highlight its map marker
• Click to view property details

Mobile Experience

On mobile devices, the sidebar becomes a bottom sheet:

• Swipe up to expand and see property list
• Swipe down to minimize and focus on map
• Tap handle to toggle expanded/collapsed
• Property count bubble shows at bottom when minimized

URL State

The map preserves your location and filters in the URL, making it easy to:

• Share specific map views with others
• Bookmark your favorite neighborhoods
• Use browser back/forward to navigate history

URL parameters include:

• lat, lng — Map center coordinates
• z — Zoom level
• minPrice, maxPrice — Price filter
• beds — Minimum bedrooms
• type — Property type filter

Tips for Best Results

1. Zoom in for detailed neighborhood exploration
2. Use Draw to search irregular areas (e.g., along a river)
3. Disable auto-search when browsing slowly to reduce API calls
4. Toggle clusters off at high zoom for individual marker visibility
5. Street View helps assess neighborhood character before visiting