Real-time tech location lets dispatchers see who's where, and lets the customer see 'Mike is 3 minutes out' SMS. Most US states require explicit employee consent for GPS tracking — even when the employer wants it on. Plyrium enforces both gates so tracking only runs when both you AND the tech have actively turned it on.
Gate 1 — owner enables per tech
- 1Go to /portal/settings/gps-tracking
Owner-only. The page lists every tech in the workspace with a per-tech toggle.
- 2Flip the toggle to ON for each tech you want to track
Off by default for every tech, even ones who later consent. Disabling here also clears any existing tech consent — re-enabling means the tech has to consent fresh (privacy hygiene).
- 3Save
The tech's tracking_enabled column flips. Nothing happens yet — gate 2 also has to clear before tracking starts.
Gate 2 — tech consents on their device
When a tech opens the Plyrium tech app (PWA or native iOS/Android) for the first time after Gate 1 is enabled, they see a consent screen describing what's tracked, how long it's retained (30-day rolling), and what they can do with it. The screen has 'I consent' and 'No thanks' buttons. Both gates only clear once they tap 'I consent'.
What's tracked vs. not tracked
| While clocked in | Lat/lng pings every 30s during an active job. Used for dispatcher map + customer arrival SMS. |
| Between jobs | Single ping at appointment end, then nothing until the next clock-in. No idle tracking. |
| Off the clock | Nothing. The phone's location is invisible to Plyrium. |
| Retention | 30-day rolling window. Older pings auto-purged by daily cron. Job route on the customer SMS pin is fixed (not retroactively erasable). |
Native vs PWA
iOS Safari aggressively suspends background JS, so PWA-only tracking pauses the moment Safari backgrounds. The native iOS/Android app uses Capacitor's BackgroundGeolocation plugin — pings continue through phone locks. Same UI, same web codebase, same consent flow.
The two-gate model satisfies most US states' GPS-tracking consent requirements, but state laws vary (CA, IL, NY, CT all have different statutes). Plyrium does not make legal-compliance claims. Consult an employment attorney if you're unsure what your state requires.
When a tech leaves the company, flip /portal/settings/gps-tracking back to OFF for them. Their old location pings stay in the 30-day window then auto-purge — you don't have to manually scrub anything.