Garage Door OS Docs
Jobs & Scheduling

Live GPS Tracking

See technician locations on a live map.
4 min read

Live GPS Tracking

See technician locations on a live map in the office—know who is available, on a job, on break, or offline.

Overview

Live Tracking (/tracking) connects to the real-time websocket feed and plots technicians on an interactive map (OpenStreetMap tiles). Markers show:
  • Status color: available, busy, on break, or offline/stale
  • Avatar or initials per technician
  • Tooltip/popup with name, status, current job, and last update
Filters let you focus on active statuses, auto-follow the fleet bounds, and recenter the map manually.
This feature is available today—not a “coming soon” preview.

How to access

  1. Sign in to ServiceFlow.
  2. Open Tracking from the main navigation (/tracking).
  3. Use sub-nav links for related tools:
    • Time Clock → /tracking/time-clock
    • Time Management → /tracking/management
    • Compliance Reports → /tracking/reports

What you can do today

  • View live technician positions when the mobile app or field client sends location updates.
  • Distinguish live vs stale locations (stale markers appear muted).
  • Filter map markers by status: available, busy, break.
  • Toggle Auto-follow to keep all visible technicians in view.
  • Recenter the map on the current fleet.
  • See connection status and last update timestamp.
  • Navigate to time and compliance tools via Tracking sub-navigation.

Prerequisites

  • Technicians must share location from the mobile app or approved field client while clocked in or on active jobs (per your mobile configuration).
  • Websocket connectivity between browser and API (WS URL configured in your environment).
  • Valid login token—expired sessions show an authentication error on the map.
  • Dispatchers need permission to open Tracking (typically managers, dispatch, admins).

Step-by-step

Monitor the field fleet

  1. Go to Tracking (/tracking).
  2. Wait for Connected status in the UI.
  3. Review markers—green (available), amber (busy), blue (break), gray (offline/stale).
  4. Hover or tap a marker for technician name and current job.

Focus on available techs

  1. Open the status filter control.
  2. Enable only Available (and optionally Busy if rerouting).
  3. Use Recenter to zoom to visible technicians.

Troubleshoot missing locations

  1. Confirm the technician is logged in on mobile and location permissions are granted.
  2. Check stale vs live counts—stale means no recent ping.
  3. If the page shows connection failed, verify websocket URL and network/firewall rules.
  4. Re-login if you see invalid or expired token.

Current limitations

  • Map shows last known point, not turn-by-turn navigation or historical trails on this screen.
  • Technicians without recent location updates appear stale or hidden depending on filters.
  • Requires continuous connectivity; brief disconnects may pause updates until reconnect.
  • Location accuracy depends on device GPS and permission settings.

Related features