Interactive Map View

Who this is for: Dispatchers, office staff, and business owners managing field technicians
Time to learn: 10 minutes
What you'll master: View customer locations, track technicians, plan efficient routes, identify service coverage gaps, optimize territory management

Why Map View Matters

A visual map makes dispatching faster and smarter:

• See where jobs are: Cluster nearby jobs for same technician
• Track technicians in real-time: Know exactly where your team is
• Optimize routes: Reduce drive time by 30-40%
• Identify coverage gaps: Spot underserved areas for marketing
• Handle emergency calls: Find nearest available technician instantly

Real example: 2 PM Friday, emergency call from Oak Street. Map shows Mike is 8 minutes away finishing a job, Sarah is 35 minutes away across town. Dispatch Mike for faster response. Customer happy, Mike gets extra job before end of day.

Business impact:

• 3-4 more jobs per technician per week (less driving)
• Faster emergency response
• Better territory planning
• Lower fuel costs

Accessing the Map

Desktop View

1. Navigate to Dashboard → Click Map tab
2. Full-screen map appears showing:
   • Customer locations (pins)
   • Scheduled job locations (colored pins)
   • Technician current positions (moving icons)
   • Your company location (blue star)

Mobile View

1. Tap Map icon in bottom navigation
2. Map fills entire screen
3. Pinch to zoom, drag to pan
4. Tap any pin for details

Understanding Map Elements

Customer Pins

Different colors indicate status:

• 🔵 Blue: Active customers (scheduled jobs)
• 🟢 Green: Completed today
• 🔴 Red: Overdue/late jobs
• ⚫ Gray: Past customers (no current jobs)
• 🟡 Yellow: Unassigned service requests

Click any pin to see:

• Customer name and address
• Next scheduled job
• Last service date
• Phone number (click to call)
• Quick actions: Schedule, Create Invoice, View History

Technician Location Icons

Real-time tracking:

• 🚗 Moving vehicle icon: Technician en route
• 🔧 Wrench icon: Technician at job site (stationary 5+ min)
• 🏠 House icon: Technician starting job (checked in)
• ✅ Check icon: Just completed job
• ⏸️ Pause icon: On break

Click technician icon to see:

• Name and photo
• Current status
• Jobs completed today (3 of 5)
• Next scheduled job
• Estimated arrival time at next location

Job Route Lines

Visual route planning:

• Dotted lines connect technician to upcoming jobs
• Color matches technician (e.g., Mike = blue line)
• Shows planned order (1st, 2nd, 3rd job)
• Highlights when route is inefficient (zigzag pattern)

Map Views and Filters

View Options (Toggle Buttons Top Right)

1. Today's Jobs (Default)

• Shows only today's scheduled jobs
• Useful for daily dispatch

2. This Week

• Shows all jobs scheduled this week
• Color-coded by day (Monday = blue, Tuesday = green, etc.)
• Good for weekly planning

3. All Customers

• Shows every customer location
• Gray pins (no scheduled jobs)
• Good for territory analysis

4. Service Requests

• Shows only unassigned requests
• Yellow pins
• Helps prioritize incoming work

Filter by Technician

To isolate one technician's schedule:

1. Click Technician dropdown (top left)
2. Select name (e.g., "Mike Johnson")
3. Map highlights only Mike's jobs and route
4. Other technicians' jobs fade to gray

Use case: Planning Mike's day, optimizing his route, checking his coverage area.

Filter by Job Type

To see specific services:

1. Click Job Type dropdown
2. Check boxes:
   • AC Repair
   • Furnace Maintenance
   • Plumbing
   • Electrical
   • Other
3. Map shows only selected types

Use case: Identify clusters of AC repair jobs (maybe AC units failing due to heat wave), send AC-specialized technician.

Filter by Status

To focus on specific job states:

• ☐ Scheduled
• ☐ In Progress
• ☐ Completed
• ☐ Overdue
• ☐ Unassigned

Example: Check "Overdue" to see late jobs highlighted in red, prioritize them.

Route Optimization

Automatic Route Suggestions

How it works:

1. Map analyzes technician schedule (5 jobs today)
2. Calculates shortest total drive time
3. Suggests optimal order
4. Shows before/after comparison:
   • Current route: 47 minutes drive time
   • Optimized route: 32 minutes drive time
   • Savings: 15 minutes

To apply suggestion:

1. Click Optimize Route button (appears when inefficient route detected)
2. Review suggested order
3. Click Apply Optimization
4. Jobs reordered automatically
5. Technician receives updated schedule on mobile app

Manual Route Adjustment

To reorder jobs yourself:

1. Click and hold job pin
2. Drag to new position in route
3. Number updates (1st → 3rd)
4. Release to confirm
5. Save changes

When to do this: Customer requests specific time, VIP customer priority, parts delivery timing.

Multi-Stop Planning

Planning day for multiple technicians:

1. Click Multi-Technician View
2. See all technicians' routes simultaneously
3. Drag job from one technician to another (reassign)
4. System recalculates both routes
5. Both technicians notified of changes

Use case: Mike has 6 jobs (overloaded), Sarah has 3 jobs (light day). Drag 2 of Mike's jobs to Sarah, balance workload, both finish on time.

Dispatching from Map

Assigning Unscheduled Job

Yellow pin = unassigned service request:

1. Click yellow pin for details
2. See request description and customer info
3. Click Assign to Technician
4. Modal shows technicians sorted by:
   • Distance from job location
   • Current workload
   • Specialization match (e.g., AC repair expert for AC job)
5. Select technician
6. Choose time slot (shows available windows)
7. Click Assign & Notify

Result:

• Job added to technician schedule
• Pin turns blue (scheduled)
• Technician receives notification
• Route line updates

Finding Nearest Technician for Emergency

Customer calls with urgent issue:

1. Enter customer address in search bar
2. Pin appears on map (red for emergency)
3. Click Find Nearest Technician
4. System calculates drive times:
   • Mike: 8 min (currently at job 2 miles away)
   • Sarah: 22 min (on break, 10 miles away)
   • Tom: 45 min (across town)
5. Select Mike
6. Click Assign Emergency Job
7. Mike's current job gets "Will finish soon" flag
8. Emergency job inserted next in his route
9. Mike receives urgent notification

Coverage Area Analysis

Viewing Service Territory

To see where you operate:

1. Click Coverage Areas tab
2. Map shows shaded regions:
   • 🟢 Green: High-density service area (many customers)
   • 🟡 Yellow: Medium-density (some customers)
   • 🔴 Red: Low-density (few customers)
   • ⚪ White: No coverage (no customers)

Insights:

• Clusters indicate strong market presence
• Gaps show expansion opportunities
• Outliers reveal distant customers (charge travel fee?)

Identifying Growth Opportunities

To find underserved areas:

1. Enable Service Request Heatmap
2. Map shows where service requests originate
3. Dark red = many requests, light yellow = few requests
4. Compare to current customer density

Analysis example:

• West side has 50 service requests (heatmap: dark red)
• But only 10 customers there (low density)
• Opportunity: Target west side with marketing (many people need service, not enough customers yet)

Travel Time Analysis

To understand drive time impact:

1. Click Travel Time Zones
2. Concentric circles around office/shop:
   • 0-15 min (green): Best profitability
   • 15-30 min (yellow): Acceptable
   • 30-45 min (orange): Charge travel fee
   • 45+ min (red): Consider not servicing
3. See where customers fall in each zone

Decision-making:

• Customer 50 minutes away requests service → Charge $50 travel fee or decline
• Clustering: 5 customers in 45-min zone → Schedule same day to justify drive

Mobile Map Features

On-the-Go Dispatching

Mobile-specific map features:

1. Tap-to-Call:

   • Tap customer pin
   • Phone number appears
   • Tap to call directly (no copying/pasting)

2. Directions Integration:

   • Tap job pin
   • Click Get Directions
   • Opens Google Maps/Apple Maps
   • Navigation starts immediately

3. Photo Upload at Location:

   • Tap "Add Photo" at job pin
   • Camera opens
   • Take photo of site
   • Auto-tagged with GPS coordinates
   • Visible on desktop map

4. Quick Status Updates:

   • Tap your technician icon (self)
   • Change status: En Route, At Job, On Break, Completed
   • Updates for office staff in real-time

Offline Mode

When connection drops:

• Map freezes at last known state
• Cached data still visible (may be outdated)
• Yellow banner: "Offline - Map data may be stale"
• Actions queued, sync when connection restored

Limitations offline:

• Can't see real-time technician positions
• Can't reorder routes
• Can't assign new jobs

Best practice: Check map while in good signal area, screenshot route for reference.

Advanced Map Features

Geofencing for Automatic Check-In

Set up geofence:

1. Click customer pin
2. Select Set Geofence
3. Choose radius: 100 ft (small), 300 ft (medium), 500 ft (large)
4. Save

What happens:

• When technician enters geofence (within radius), app auto-prompts: "Check in to [Customer Name] job?"
• Tap "Yes"
• Job status → "In Progress"
• Customer receives "Technician arrived" notification

Benefits:

• No manual check-in (fewer missed check-ins)
• Accurate arrival times
• Better customer communication

Historical Route Playback

Review past days:

1. Click Playback button (top right)
2. Select date (e.g., "Last Thursday")
3. Choose technician
4. Press Play
5. Map animates technician's route throughout day
   • Speed: 1x, 2x, 5x, 10x
   • Shows stops, drive times, job durations

Use cases:

• Verify technician went to all scheduled jobs
• Analyze drive time accuracy
• Investigate customer complaint ("Technician never showed")
• Improve route planning ("This route took 90 min instead of 45 min")

Custom Map Markers

Pin notes on map:

1. Right-click anywhere on map
2. Select Add Marker
3. Choose icon:
   • 📍 Parts supplier location
   • 🏪 Frequent coffee stop (team meeting spot)
   • 🚧 Construction zone (avoid this area)
   • 🏠 Owner's home (reference point)
4. Add label and notes
5. Save

Visible to all team members.

Example uses:

• Mark parts supplier: "Smith Supply - open 7 AM-5 PM, ask for Dave"
• Mark traffic bottleneck: "Main St bridge - avoid 3-6 PM rush hour"

Troubleshooting Common Issues

Technician Location Not Updating

Problem: Technician icon stuck, not moving

Solutions:

1. Check technician clocked in (location tracking only when clocked in)
2. Verify mobile app has location permission:
   • iOS: Settings → Crewdex → Location → While Using App
   • Android: Settings → Apps → Crewdex → Permissions → Location → Allow all the time
3. Ensure mobile data enabled (WiFi alone may not provide GPS)
4. Ask technician to force-close app, reopen
5. Check last update time (if 30+ min ago, connection issue)

Map Not Loading

Problem: Blank screen or "Map unavailable"

Check:

1. Internet connection active?
2. Browser up-to-date? (Update Chrome/Firefox/Safari)
3. Clear browser cache (Ctrl+Shift+Delete → Cached images/files)
4. Disable browser extensions (ad blockers sometimes block maps)
5. Try different browser (Edge, Firefox if using Chrome)

Pins in Wrong Location

Problem: Customer pin shows wrong address

Cause: Address geocoding error (e.g., "123 Main St" exists in multiple cities)

Fix:

1. Click pin → Edit Customer
2. Verify address complete:
   • Street number + street name
   • City, State, ZIP (all fields required)
3. Add apartment/unit number if missing
4. Click Verify Address
5. System re-geocodes
6. Pin moves to correct location

Pro tip: Always include ZIP code for accurate pins.

Route Optimization Not Working

Problem: "Unable to optimize" error

Common causes:

1. Jobs too far apart (3+ hours drive) - system can't optimize meaningfully
2. Time constraints impossible (job at 9 AM is 2 hours away, can't get there on time)
3. Only 1-2 jobs scheduled (need 3+ for optimization)
4. Jobs locked with specific times (can't reorder)

Solution: Manually adjust schedule, increase time windows, or split into multiple days.

Best Practices for Map Usage

1. Review Map Every Morning (5 Minutes)

Daily routine:

• 8:00 AM: Open map
• Check all technicians' routes
• Look for:
  • Red "inefficient" route warnings
  • Zigzag patterns (optimize those)
  • Clusters of jobs in same area (assign to one tech)
• Apply optimizations before technicians start driving

Result: 20-30 min saved per technician per day.

2. Use Map for Customer Calls

When customer calls requesting service:

1. Enter their address in map search
2. See nearby jobs scheduled this week
3. Offer appointment: "I have a technician in your area Thursday afternoon. Does 2-4 PM work?"
4. Customer more likely to accept (convenient for them)
5. You cluster jobs efficiently

Instead of: "First available is next Tuesday." (5 days away, technician driving from across town)

3. Monitor Map During Day for Delays

Real-time adjustments:

• 10:30 AM: Mike's 10 AM job still shows "In Progress"
• Expected duration: 1 hour, actual: 1.5 hours (so far)
• His 12 PM job will be late
• Action: Call 12 PM customer, reschedule to 1 PM or assign to Sarah
• Proactive communication prevents angry customer

4. Use Heatmap for Marketing Decisions

Quarterly analysis:

1. Generate service request heatmap (last 90 days)
2. Identify high-request, low-customer areas
3. Target those zip codes with:
   • Direct mail postcards
   • Facebook ads (geo-targeted)
   • Door hangers (if residential)
4. Track new customers from those areas

Measure ROI: Did marketing in that area generate more customers?

Common Mistakes to Avoid

❌ Not Updating Customer Addresses

Problem: Customer moved, address outdated, pin shows old location, technician drives to wrong house.

Solution: When customer calls, verify: "Still at 123 Oak Street?" Update immediately if changed.

❌ Ignoring Route Optimization Suggestions

Problem: System suggests better route, you ignore it, technician wastes 45 min driving.

Why: "I already made the schedule, don't want to change it."

Better: Review suggestions, apply when logical. Route optimization saves hours per week.

❌ Overloading One Technician's Area

Problem: All jobs in north side go to Mike (lives there), none to Sarah (lives south side), Mike overwhelmed, Sarah underutilized.

Solution: Balance by jobs per day, not just distance. Sometimes send Sarah north even if 15 min farther drive.

❌ Not Training Technicians on Mobile Map

Problem: Technicians don't know how to use map on phone, call office for every address.

Solution: 10-minute training session:

• How to view today's route
• How to get directions
• How to check in/out
• How to update status

A: No. Technicians can disable it. But route optimization and real-time dispatching require location access. Most technicians agree when they understand benefits (shorter drive times for them too).

Q: Can customers see technician locations?
A: Only approximate. Customer portal shows "Technician 15 minutes away" (not exact position on map). Privacy-protected.

Q: Does map work internationally?
A: Yes, but route optimization best in US/Canada. Other countries may have less accurate travel time estimates.

Q: Can I export map data?
A: Yes. Reports → Map Analytics → Export to CSV. Includes customer locations, job counts, drive times.

Q: How accurate is "drive time" estimate?
A: Based on Google Maps traffic data. Typically ±5 minutes. Factors in current traffic, time of day, road conditions.

Q: Can I create territories (e.g., north/south split)?
A: Yes. Coming in future update. Current workaround: Use technician filter to isolate areas.

Q: What if technician has no smartphone?
A: They won't appear on map (no GPS tracking). Can still assign jobs via office dispatch, but can't see real-time location.

Q: Does map drain technician phone battery?
A: Minimal impact (1-2% per hour with location tracking). Recommend car charger for all technicians.

What's Next?

Now that you're using the map effectively:

1. Route Optimization Strategies - Advanced techniques for maximum efficiency
2. Parts Inventory Management - Track what parts each technician has on truck
3. Customer Portal - Let customers see real-time technician arrival estimates

Need more help? Search using ⌘/ (Mac) or Ctrl+/ (Windows).