Wintertrace On GitHub →

Feature · GPS tracking

Location data, from the phone to your server

Wintertrace uses the free, open-source OwnTracks app as its GPS source. Location data is sent directly from the driver phone over HTTPS to your Wintertrace installation — there is no third-party cloud in between.

How it works

OwnTracks is a free open-source location app available on iOS and Android. It runs in the background on the driver phone, captures location updates from the platform GPS subsystem, and posts them to a configured endpoint over HTTPS.

In Wintertrace, that endpoint is your installation. The driver phone authenticates with credentials generated by Wintertrace and forwards location data only while an operation is active.

Why this matters: the data path is operator-controlled end to end. There is no third-party cloud holding location data. No per-driver subscription. No proprietary tracking device.

Driver setup in three steps

Setup takes seconds once OwnTracks is installed on the driver phone.

  1. 1

    Admin creates the driver

    Wintertrace auto-generates OwnTracks credentials for the new driver.

  2. 2

    QR code appears

    The driver management page shows a QR code with the connection details.

  3. 3

    Driver scans

    The driver scans the QR code in the OwnTracks app — done. Manual entry also works.

Wintertrace OwnTracks QR code generator for driver Mike S. with a large QR code and short Scan in OwnTracks app instructions.
The QR code page in the admin area. The driver scans it once and OwnTracks connects to your installation.

What is captured per fix

Each GPS point stored with an operation carries the full context — not just coordinates.

Latitude · longitude
7 decimal places of precision per fix.
Unix timestamp
Seconds since epoch — unambiguous across timezones.
Altitude
Metres above mean sea level, as reported by the phone.
Speed
Reported by the GPS subsystem.
GPS accuracy
Per-fix accuracy in metres — useful when assessing density of stops.
Device battery level
Stored alongside each fix to spot devices going flat mid-shift.

Integrity guarantees

GPS points are locked after the operation ends. They cannot be changed or removed retroactively. This protects the integrity of the service proof — a track that could be edited would not be evidence.

Edits to the operation itself (notes, customer assignment) are still possible within a 24-hour window. Every such change is logged in a separate audit trail, visible in the database and in the UI.

The audit table is part of the open-source codebase. Behaviour can be verified directly.

Smoothing for display

Raw GPS data is messy. Wintertrace smooths the display without ever touching the underlying record.

Three smoothing passes run before display and PDF rendering:

  • Stillness clusters — fixes captured while the vehicle is stationary collapse into a single point.
  • Near-neighbour reduction — points within a small radius of each other are thinned out.
  • Douglas–Peucker simplification — straight stretches are reduced to fewer points without visual loss.

The raw points remain in the database untouched — only the rendered view and the PDF map use the smoothed version.

Maps and the PDF track

Live maps in the admin area use OpenStreetMap by default. Start and end points are colour-coded. The PDF service proof embeds the track as a high-quality SVG vector — sharp when printed at any size.

Topic page: GPS tracking for snow removal