Map View

Path: /d4d/map
Access Level: All D4D Users

Overview

The Map View provides an interactive, visual representation of all your captured leads plotted on a map. This powerful tool helps you understand lead distribution, identify target areas, and plan efficient routes through neighborhoods.

Key Features

• 🗺️ Interactive Map - Pan, zoom, and explore your leads
• 📍 Smart Clustering - Groups nearby leads for better visualization
• 🔍 Click for Details - Instant lead information on map markers
• 🎨 Color-Coded Markers - Visual indicators for status and priority
• 📊 Filters - Show/hide leads by various criteria
• 🧭 Directions - Get directions to any lead
• 📱 Mobile Optimized - Touch-friendly controls

Map Interface

Main Components

1. Map Canvas

• Provider: Mapbox GL (interactive, modern mapping)
• Default View: Centers on your leads with optimal zoom
• Controls: Pan (drag), Zoom (scroll/pinch), Rotate (right-click drag)

2. Control Panel (Top Right)

• Zoom In/Out - Buttons for zoom control
• Fit to Bounds - Auto-zoom to show all leads
• My Location - Center map on your current position
• Map Style - Switch between map styles

3. Filter Panel (Left Sidebar)

• Status filters
• Priority filters
• Property type filters
• Date range filters
• Quick filter presets

4. Lead Counter (Top Left)

• Shows number of visible leads
• Updates with filters
• Click to view list

Using the Map

Navigation

Pan (Move Around)

• Desktop: Click and drag
• Mobile: Touch and drag with one finger
• Keyboard: Arrow keys

Zoom

• Desktop: Mouse wheel or +/- buttons
• Mobile: Pinch to zoom or tap +/- buttons
• Keyboard: + and - keys
• Double-Click: Zoom in on that location

Rotate (3D View)

• Desktop: Right-click and drag
• Mobile: Two-finger rotation gesture
• Reset: Click compass icon

Finding Your Position

Enable Location:

1. Click "My Location" button (target icon)
2. Grant location permission (if prompted)
3. Blue dot shows your position
4. Map centers on you

Update Position:

• Position updates automatically as you move
• Manual refresh: Click "My Location" again
• Accuracy indicator shows GPS precision

Lead Markers

Marker Appearance

Clustering

When zoomed out, nearby leads group into clusters:

Cluster Display:

• Circle with number (e.g., "15")
• Size indicates number of leads
• Color based on average distress/priority

Cluster Colors:

• 🟢 Green: Mostly low priority (1-5 leads)
• 🟡 Yellow: Mixed priority (6-20 leads)
• 🔴 Red: Many leads or high priority (21+ leads)

Expanding Clusters:

• Click cluster: Zoom in to expand
• Hover: See lead count (desktop)
• Clusters break apart as you zoom in

Individual Markers

When zoomed in, see individual lead markers:

Pin Icon: 📍
Color Coding:

• 🟢 Green - New, low priority
• 🟡 Yellow - Researching, medium priority
• 🟠 Orange - Qualified, high priority
• 🔵 Blue - Contacted
• 🟣 Purple - Offer made
• ✅ Green (checkmark) - Deal closed
• 🔴 Red - Dead lead
• ⚫ Gray - Archived

Size Variations:

• Standard: Normal lead
• Large: High priority
• Small: Low priority

Marker Interactions

Hover (Desktop)

• Tooltip appears with basic info
• Property address
• Distress score
• Capture date

Click

Opens popup with lead details:

• Header: Property address
• Photo: Primary property photo (if available)
• Details:
  • Property type
  • Distress score (visual gauge)
  • Status badge
  • Priority indicator
  • Capture date
  • Notes preview

Popup Actions:

• View Full Details - Opens lead detail page
• Get Directions - Opens navigation
• Edit Lead - Quick edit
• Add to Route - Add to route planner
• Share - Share with team

Filtering Leads on Map

Filter Panel

Access: Click filter icon or open left sidebar

Status Filter

• Checkboxes for each status
• "Active Only" quick filter
• "Select All" / "Deselect All"
• Real-time map updates

Priority Filter

• High Priority
• Medium Priority
• Low Priority
• Show All

Property Type Filter

• Residential (all types)
• Commercial (all types)
• Land
• Custom selection

Distress Score Range

• Slider: 1-10
• Min/Max inputs
• Only show leads in range

Date Range

• Captured today
• This week
• This month
• Custom date range

Active Filters Display

Filter Chips (Top of Map):

• Shows active filters
• Click X to remove filter
• "Clear All" button
• Lead count updates

Quick Filter Presets

Saved Filters:

• Hot Leads (high priority + high distress)
• New This Week
• Needs Follow-up
• Under Contract
• Custom saved filters

Map Styles

Available Styles

Streets (Default)

• Standard street map
• Clear labels
• Best for navigation

Satellite

• Aerial imagery
• Property details visible
• Useful for property assessment

Hybrid

• Satellite with street labels
• Best of both worlds

Dark Mode

• Easy on eyes
• Automatic in dark theme
• Reduces screen glare

Switch Styles:

• Click map style button (top right)
• Select from dropdown
• Preference saved automatically

Getting Directions

To a Single Lead

D4D doesn't give turn-by-turn directions itself.

1. Click lead marker on map to see its address
2. Enter the address in Google Maps, Apple Maps, or Waze
3. Follow that app's directions

To Multiple Leads (Route)

See Route Planning Guide for:

• Creating optimized routes
• Multi-stop directions
• Route saving and sharing

Map Tools & Actions

Measurement Tools

Distance Measurement:

1. Click ruler icon
2. Click start point
3. Click waypoints
4. Double-click to finish
5. See total distance

Area Measurement:

1. Click area icon
2. Click to draw polygon
3. Close polygon
4. See area in sq ft/mi

Drawing Tools

Draw Neighborhood:

1. Click polygon tool
2. Draw boundary on map
3. Name neighborhood
4. Save for tracking

Mark Areas:

• Highlight target zones
• Avoid areas
• Competition territories

Search on Map

Location Search:

1. Type address in search box
2. Map centers on location
3. See nearby leads

Lead Search:

• Search your leads
• Map highlights matches
• Filter results

Mobile Map Features

Touch Gestures

• Pan: One-finger drag
• Zoom: Pinch or double-tap
• Rotate: Two-finger rotation
• Tilt: Two-finger drag up/down

Mobile-Specific Tools

Quick Capture:

• Floating "+" button
• Capture lead at map center
• GPS auto-fills from your location

Nearby Leads:

• Shows leads within radius
• Distance from current position
• Navigate to closest

Offline:

• The map needs a connection; map areas can't be downloaded
• For navigation without signal, open your route in Google Maps and download a Google Maps offline area
• See Offline Mode

Map Best Practices

🎯 For Lead Generation

Before Driving:

1. Review map to see captured leads
2. Identify gaps in coverage
3. Plan route through uncovered areas
4. Low signal ahead? Download a Google Maps offline area for the drive

While Driving:

1. Use passenger to operate map
2. Quick capture when you spot property
3. Check nearby leads to avoid duplicates
4. Follow optimized route

After Driving:

1. Review new captures on map
2. Check coverage of target area
3. Plan next session based on gaps

📊 For Analysis

Identify Patterns:

• Lead concentration areas
• High distress neighborhoods
• Active vs dead lead locations
• Conversion hot spots

Track Progress:

• Coverage over time
• Neighborhood completion
• Lead density trends

Competitive Analysis:

• Compare to competition
• Find overlooked areas
• Identify opportunities

🗺️ For Planning

Territory Management:

• Define your farm areas
• Track neighborhood progress
• Set coverage goals
• Avoid overlap with team

Route Efficiency:

• Group leads by proximity
• Plan logical driving routes
• Minimize backtracking
• Maximize daily captures

Troubleshooting

Map Not Loading

Symptoms: Blank map or spinner

Solutions:

1. Check internet connection

   • The map needs internet every time it loads
   • It isn't available offline

2. Verify Mapbox token

   • Admin: Check environment variables
   • Token must be valid and active

3. Clear browser cache

   • Ctrl+Shift+Delete (Windows)
   • Cmd+Shift+Delete (Mac)
   • Clear cached images

4. Try different browser

   • Chrome recommended
   • Update to latest version

Leads Not Appearing

Symptoms: Map loads but no markers

Solutions:

1. Check filters

   • Active filters may hide leads
   • Click "Clear All Filters"
   • Verify date range

2. Verify GPS coordinates

   • Leads need lat/long to display
   • Check lead details
   • Recapture with GPS enabled

3. Zoom out

   • May be zoomed too far in
   • Click "Fit to Bounds"
   • Check lead counter

4. Refresh page

   • Data may not have loaded
   • F5 or Ctrl+R
   • Check console for errors

Slow Performance

Symptoms: Laggy map, slow rendering

Solutions:

1. Too many leads visible

   • Use filters to reduce count
   • Zoom in (enables clustering)
   • Archive old leads

2. Device performance

   • Close other apps/tabs
   • Restart browser
   • Use desktop for large datasets

3. Map style

   • Switch to "Streets" (fastest)
   • Disable 3D buildings
   • Reduce animation

GPS/Location Issues

Symptoms: "Location unavailable" or inaccurate position

Solutions:

1. Grant permissions

   • Browser needs location access
   • Check browser settings
   • Allow when prompted

2. Improve accuracy

   • Move to open area
   • Away from tall buildings
   • Wait for GPS lock (30-60 sec)

3. Device settings

   • Enable location services
   • High accuracy mode
   • Check airplane mode off

Clustering Problems

Symptoms: Clusters not breaking apart or odd grouping

Solutions:

1. Zoom in more

   • Clusters expand at higher zoom
   • Double-click to zoom

2. Refresh map

   • Click "Fit to Bounds"
   • Reload page

3. Check lead coordinates

   • Duplicate coordinates cause stacking
   • Verify GPS accuracy

Advanced Features

Heatmap View

What it shows: Density of leads by area

How to enable:

1. Click "View Options"
2. Select "Heatmap"
3. Adjust intensity slider

Use cases:

• Identify hot zones
• See neighborhood coverage
• Find overlooked areas

Colors:

• Blue: Low density
• Green: Medium density
• Yellow: High density
• Red: Very high density

Custom Map Layers

Property Boundaries:

• Toggle property lines
• See lot sizes
• Identify vacant land

Demographics:

• Income levels (if available)
• Owner occupancy rates
• Property values

Competition:

• Mark competitor territories
• Track their activity
• Find opportunities

Batch Actions from Map

Select Multiple Leads:

1. Click "Select Mode"
2. Draw box around leads
3. Or Shift+Click individual markers

Bulk Actions:

• Update status
• Change priority
• Add to route
• Export selection
• Assign to team member

Integration with Other Features

Route Planning

• Add leads to route from map
• See planned routes on map
• Optimize route visually

Neighborhoods

• Draw neighborhoods on map
• Track coverage by neighborhood
• See neighborhood stats

Analytics

• Heat maps of performance
• Conversion by area
• Time-to-contact by distance

Team Features

• See team member leads (if permitted)
• Territory assignments
• Real-time updates

Keyboard Shortcuts

Tips & Tricks

🎯 Efficiency Tips

1. Use clustering - Don't zoom in until needed
2. Save filter presets - Quick access to common views
3. Open the capture page before field work - It saves leads without signal
4. Batch actions - Update multiple leads at once
5. Keyboard shortcuts - Faster navigation

📱 Mobile Tips

1. Landscape mode - Easier for driving passenger
2. High brightness - Easier to see in sunlight
3. Car mount - Hands-free viewing
4. Voice navigation - Works with directions
5. Offline driving - Download a Google Maps offline area in advance

🗺️ Planning Tips

1. Review weekly - Understand your coverage
2. Color code priorities - Visual route planning
3. Track patterns - Learn from successful areas
4. Avoid duplicates - Check map before driving
5. Team coordination - Share maps with team

Related Guides

• Lead Capture - Capture leads with GPS
• Route Planning - Optimize your routes
• Neighborhoods - Track neighborhood coverage
• Offline Mode - Work without internet

← Back to Lead Management | Next: Route Planning →