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.

What it is

A Site is a location on the map — a pit, plant, jobsite, or yard. A geofence (a virtual fence around a Site) tells Tread when a truck arrives, leaves, and how long it stayed. Together they turn GPS into ticket data.

Why it matters

Sites and geofences power load counts, cycle times, on-site minutes, and auto-completion of jobs. Without them, Tread cannot tell a working truck from a passing one. With them, dispatch and approvals run on real events instead of phone calls.

How Tread models it

  • Site — name, address, lat/long. Reverse-geocoded from the address if you do not have coordinates.
  • Geofence — the shape around the Site. Two flavors:
    • Circle — radius in meters. Default. Fast to draw, fine for pits and plants.
    • Polygon — custom shape. Required for irregular sites, paving lanes, or anywhere a circle would overlap a neighbor.
  • Geofence Timer — minimum minutes inside the fence before Tread counts it as a real arrival. Filters out drive-throughs.
  • Auto-geofence — Tread can draw a default circle when a Site is created.
FieldRequiredNotes
Lat / longYesNo coordinates, no detection
Geofence shapeYesCircle is the default
Geofence TimerNoDefaults to your platform setting

Auto-end behavior

When a load or shift ends depends on the order type. Geofence exit auto-ends some orders; others wait for a manual end or a different trigger. Knowing which is which prevents loads from staying open all night.
Order typeWhat auto-ends a load or shiftManual end available?
Hourly orderDriver clocks out at end of shift, or geofence exit on the last load of the dayYes — driver or foreman can end early
Load-based orderGeofence exit at the destination (load complete)Yes — manual completion overrides geofence
Shift orderShift end time, regardless of geofenceYes — driver can end shift early
Digital-ticket-mode jobManual end only — geofence does not auto-completeYes — required, no auto-end
  • Geofence exit — the truck crosses the fence boundary on the way out. Tread closes the load and starts the cycle-time clock for the next one.
  • Digital-ticket mode — the foreman or driver controls completion because tickets are entered as the work happens. Auto-end would close loads before the ticket is captured.
  • Geofence Timer still applies. A truck that crosses the fence for less than the timer window does not trigger auto-end.

Common pitfalls

Geofence type changes affect historical data, not just future loads. Switching a Site from circle to polygon recalculates past arrivals and on-site times. Cycle times can shift, and approved tickets may not match the new fence. Settle and lock the period before changing geofence shape — see Settlements.
For paving and other work that moves down a road, use a moving geofence rather than redrawing a polygon every shift.