Crew Map
Mobile App Feature
The Crew Map is a live map view available on the mobile app (and in a read-only form in the web CRM). It shows every technician's current location, their status, and all active job site locations — updated in real time.
Live Map
The map displays:
- Colored pins for each technician — indicating their current status
- Diamond markers for each active job site
- ETA indicators for technicians currently en route
- A crew list panel on the left showing each tech's name, status, and time at current location
Pin Color Coding
| Color | Animation | Status Meaning |
|---|---|---|
| Blue (pulsing) | Pulse | On Site — currently at a job location |
| Green (pulsing) | Pulse | On Site — at a different confirmed job site |
| Yellow | Static | En Route — driving to a job site |
| Grey | Static | Off Clock — location tracking paused |
Diamond-shaped pins indicate job sites (not tech locations).
Crew List
Sample crew list panel:
| Technician | Status | Duration |
|---|---|---|
| Jake Torres | On Site | 2h 14m |
| Sarah Kim | On Site | 45m |
| Carlos Reyes | En Route | ~8 min ETA |
| Mike Alvarez | Off Clock | — |
Tapping a crew member's name centers the map on their pin and shows their today's timeline.
What the Crew Map Shows
Six data layers visible on the map:
- Current location — Each tech's GPS position, updated every 60 seconds (15 seconds when on-site)
- Status — On Site / En Route / Available / Off Clock
- Current job — Which project the tech is working on
- ETA to next job — For techs marked as En Route
- Time on site — How long the tech has been at their current location
- Today's route — Optional breadcrumb trail of where a tech has been today
Who Can See the Crew Map
| Role | Can See |
|---|---|
| Owner | All technicians, all locations |
| Team Lead | Their crew members only |
| Technician | Own pin only (can see job site pins) |
| Estimator | Job site pins only — no tech locations |
Privacy note: Technicians are notified during onboarding that location tracking is active during work hours. Tracking pauses automatically outside configured work hours. Technicians can see that they are being tracked — the app displays a visible indicator when location sharing is active.
How Location Data Is Used
Four operational uses of crew map data:
- Dispatch optimization — Assign the nearest available tech to a new incoming job
- Customer notifications — "Your technician is on the way" with live ETA
- Time entry verification — Confirm a tech was on-site when they logged hours
- Automatic clock-in/out — GPS geofence entry/exit triggers time tracking
Technical Specs
| Parameter | Value |
|---|---|
| GPS update interval (default) | Every 60 seconds |
| GPS update interval (on-site) | Every 15 seconds |
| Geofence radius | 300 feet (default) |
| En Route trigger distance | 5 miles from job site |
| En Route trigger speed | 5+ mph toward job site |
| ETA notification window | ≤20 minutes from arrival |
| Clock-out grace period | 10 minutes after geofence exit |
| Low-battery mode | GPS interval extended to 10 minutes |
Privacy & Consent
- Location tracking is opt-in at the business level — owners enable it during setup
- All technicians are informed during app onboarding that tracking is active
- Tracking is only active during configured work hours — off-hours tracking is off by default
- Technicians can see their own location history in the app
- Off-hours location is never stored or visible to management
- Technicians can trigger manual clock-out from the app at any time to stop tracking for the session
- GPS data is retained for 90 days, then deleted automatically
- Geofence events (entry/exit) are stored permanently as part of the project timeline; raw continuous GPS tracks are deleted after 90 days
Crew Map vs. GPS & Time Tracking
The Crew Map is a visual display tool. GPS & Time Tracking is the data capture system. They share the same underlying location signal — but serve different purposes:
| Feature | Crew Map | GPS & Time Tracking |
|---|---|---|
| Purpose | See where your crew is right now | Automatically log time and trigger actions |
| Audience | Dispatcher, Owner, Lead Tech | System automation, Payroll, Job costing |
| Data used | Live GPS position | Geofence entry/exit events |
| Retention | Visual only, not stored | Events stored permanently on project timeline |
Related Pages
- GPS & Time Tracking — How geofencing drives automatic clock-in/out
- Crew Management — How crews are organized and dispatched
- Zero Data Entry — How GPS signals eliminate manual field data entry
- Dashboard — Crew On-Site count shown on the KPI strip