Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tread.ai/llms.txt

Use this file to discover all available pages before exploring further.

Tread pulls live paver telemetry from your paving machines to drive paving stats and moving geofences (a geofence — a virtual fence around a site — that follows the paver as it works). Use this for linear paving jobs where a static geofence does not cover the work.

Prerequisites

  • A paver fitted with a supported tracker that exposes a position feed.
  • A Tread admin user with the Integrations permission.
  • An equipment record in Tread for the paver.
  • A paving project in Tread with moving geofences enabled.

How it works

  1. Connect the tracker — Tread reads paver position from the tracker’s API.
  2. Match paver to equipment — The tracker’s vehicle ID maps to a Tread paver equipment record.
  3. Stream position — Tread receives the paver’s GPS position on a recurring poll.
  4. Move the geofence — The job’s geofence follows the paver as the paving line advances.
  5. Calculate paving stats — Tons placed, lane-miles covered, and idle time roll up into project reporting.

What flows where

DataDirectionFrequency
Paver GPS positionPaver Tracker → TreadRecurring poll
Paver active/idle statePaver Tracker → TreadReal time
Tons placed (where supported)Paver Tracker → TreadTODO: confirm with engineering
Vehicle metadataPaver Tracker → TreadOn connect

Setup

1

Open Integrations settings

Go to Settings → Integrations → Paver Tracker.
2

Enter tracker credentials

Paste the API key or token from your paver tracker provider.
3

Match paver to equipment

Tread lists pavers from the tracker feed. Map each to a Tread equipment record.
4

Enable moving geofences on the project

Open the paving project, turn on moving geofences, and pick the paver to follow.
5

Confirm position updates

Watch the project map as the paver moves. The geofence should follow within the polling interval.

Limitations

  • One paver tracker provider per Tread company.
  • Moving geofences need a clean GPS signal. Tunnels and overpasses can pause updates.
  • Tons-placed data depends on what the paver tracker exposes — not every tracker reports volume.
  • Pavers swapped mid-project must be re-mapped before the geofence follows the new machine.
  • Long-term historical position lives in the tracker provider, not Tread.

Troubleshooting

Geofence not moving with the paver
  1. Confirm moving geofences are enabled on the project.
  2. Confirm the right paver equipment is mapped.
  3. Check the tracker for a recent position fix on the paver.
Paver not appearing in the equipment list
  1. Confirm the paver is active in the tracker provider.
  2. Refresh the vehicle list in Settings → Integrations → Paver Tracker.
  3. If still missing, confirm the tracker credentials are valid.
Paving stats look wrong
  1. Confirm the tracker actually reports the field Tread is reading. Some trackers only report position, not tons.
  2. For projects without volume telemetry, capture tons through standard tickets instead.