Crew Map
The Crew Map gives dispatchers and owners a live bird's-eye view of every field technician and job site on a single map. At any moment you can see exactly where each tech is, what job they're assigned to, and how they're progressing through their day — without calling anyone. This is the situational awareness layer that dispatchers use to make real-time decisions: reassign a nearby tech to a new emergency call, check whether a crew is actually on site, or estimate when someone will be free for the next job.
The map is live. Positions update continuously from the Mobile App GPS while a technician is clocked in. The update frequency is configurable — every 30 seconds by default, increasing to every 10 seconds when a tech is en route. When a tech clocks out or the mobile app goes into background mode, their position pin shows their last known location with a timestamp.
For businesses with large crews, the map clusters nearby pins at higher zoom levels to avoid visual clutter. Zoom in and the cluster expands into individual technician markers. Each marker shows the tech's name, photo thumbnail, and current job status at a glance.
Map Elements
Technician Pins
Each clocked-in technician appears as a named pin with a color-coded status indicator:
| Pin Color | Status |
|---|---|
| Green | On site / actively clocked in to a job |
| Blue | En route to a job |
| Yellow | Clocked in but not at a job site (e.g., supply run) |
| Gray | Clocked out / last known position |
Clicking a pin opens a side panel with the tech's name, current job, address, time on site, and a link to their full crew record.
Job Site Pins
Every scheduled job for the day appears as a location pin on the map, color-coded by status:
| Pin Color | Status |
|---|---|
| Orange | Scheduled — no tech on site yet |
| Green | Tech on site |
| Blue | Complete |
| Red | Overdue / late start |
Clicking a job pin opens the project record directly.
Route Visualization
When a technician is en route to a job, their route line is drawn on the map from their current position to the job site. Estimated arrival time is calculated from current traffic conditions and displayed on the tech's side panel. Dispatchers can share the ETA directly to the customer via the side panel with one click.
Cluster View
At zoom levels that cover a large geographic area, nearby pins group into numbered cluster bubbles. The cluster number shows how many techs or jobs are within that area. Clicking a cluster zooms in and expands it.
Filtering the Map
The map can be filtered to show:
- All technicians / specific technicians only
- All jobs / jobs of a specific type or status
- Jobs assigned to a specific crew lead
- A specific date (defaults to today; change to view historical positions)
CRUD Operations
| Operation | Available | Notes |
|---|---|---|
| View | Yes | Map loads current day by default; all clocked-in technicians and today's scheduled jobs are shown automatically |
| Create | No | New jobs and crew records are created in their respective modules, not from the map |
| Update | Yes | Job assignments and dispatch status can be updated from the job pin's side panel without leaving the map |
| Delete | No | Deletion is handled in the project and crew modules |
Historical Playback
The map supports a historical playback mode. Select a past date and the map shows a replay of technician movements throughout that day — useful for reviewing how a day actually played out, verifying a tech was on site, or investigating a disputed timesheet.
GPS tracking requires the Mobile App to be active on the technician's device. Positions do not update if the app is closed or if the device has no cellular or Wi-Fi connectivity. The last known position is always stored and shown with its timestamp.