Jobs Map — Usage & Best Practices

The Jobs Map provides a visual, map-based interface for viewing and managing field jobs. This article explains key interactions, filters, and operational guidance.

Key features

• Interactive Map with clustering — Jobs are shown as clustered markers when zoomed out. Click a cluster to expand and view individual job markers.
• Status-based filtering — Toggle job statuses (New, Scheduled, In Progress, Completed, Overdue) to narrow visible jobs. Jobs are color-coded by status using the CJH palette (New: Blue #2D7FF9, Scheduled: Yellow #FFC23A, In Progress: Orange #FF7A00, Completed: Green #3CCB7F, Overdue: Red #E5484D). :contentReference[oaicite:8]{index=8}
• Date range & technician filter — Filter jobs by date range and by assigned technician to focus on relevant routes or work windows. :contentReference[oaicite:9]{index=9}

Job Details Drawer

• Click any job marker or table row to open the Job Details Drawer. The drawer includes quick actions to:
• Open the full job details page.
• Navigate to the customer using a maps app.
• Call or text the customer directly.

Use the drawer for fast dispatch decisions without leaving the map. :contentReference[oaicite:10]{index=10}

Technician tracking & refresh cadence

• Live technician locations appear as blue markers and update frequently to support real-time dispatching. Technician locations update approximately every 15 seconds, while jobs refresh approximately every 30 seconds. This cadence balances responsiveness and performance. :contentReference[oaicite:11]{index=11}

Integration with scheduling (Plan My Day)

• The Jobs Map shares its data source with scheduling features (Plan My Day) so both views reflect the same job queries and filters. This ensures consistent data for dispatch and routing across the app. (See Plan My Day Integration for routing-related notes.) :contentReference[oaicite:12]{index=12}

Interactions & tips

• Zoom & pan to focus on service areas. Click clusters to drill in.
• Use status badges to visually filter urgent or overdue work.
• Filter by technician to prepare driver itineraries or to confirm assignments.
• For routing: expand clusters and use the drawer’s navigation action to open a device maps app for turn-by-turn directions.

Troubleshooting — common map issues

• Map not loading: Verify tenant Mapbox token and check browser console for token or authentication errors. Demo tokens are rate-limited — use per-tenant tokens for production. :contentReference[oaicite:13]{index=13}
• No jobs showing: Confirm date range and status filters include the job(s) you expect. Also check that jobs have valid lat/lng or geocodable addresses. :contentReference[oaicite:14]{index=14}
• Technician not appearing: Confirm technician is clocked in and location permissions are granted on their device. :contentReference[oaicite:15]{index=15}

Advanced: For large fleets or high-frequency location updates, consider monitoring Mapbox usage and rate limits and ensure each tenant has its own Mapbox token to isolate costs. :contentReference[oaicite:16]{index=16}

Updated on: 10/01/2026