Driver App: Geofence Enter / Exit Timestamps

Overview

The TCMS Driver App now records the precise time a driver enters and exits the geofence zone around each task location. These two timestamps — Geofence Arrival Time and Geofence Departure Time — are stored separately from the driver's manually tapped Arrival Time, giving operations teams a more accurate picture of how long drivers actually spend at each site.

The fields are available in the Order Items report and the Driver Activity report, and form the foundation for dwell time, time-on-site, and ETA analytics — with further reports building on this data in the months ahead.

What Is a Geofence?

A geofence is a virtual boundary drawn around a task location (pickup or delivery address). When a driver's device crosses this boundary — either entering or exiting — the Driver App registers a geofence event and records the time.

The Two New Fields

Geofence Arrival Time

What it captures: The time the driver's device last entered the task's geofence zone before the task was completed.

Why "last" entry? Drivers sometimes pass close to a location before their actual arrival — for example, while completing a nearby task or taking a route past the site. Using the most recent geofence entry before completion filters out these false triggers and captures the driver's genuine arrival at the location.

Example:

Geofence Departure Time

What it captures: The time the driver's device first exited the task's geofence zone after the task was completed.

Why "first" exit after completion? Once a task is done, the first time the driver leaves the geofence represents when they actually departed the site. Any subsequent re-entries (e.g. returning to collect something) are not relevant to the completed task.

Example:

How These Differ from Arrival Time

It is important to understand how Geofence Arrival Time relates to — but is distinct from — the task's Arrival Time field.

Geofence Arrival Time will typically be earlier than Arrival Time, since it captures proximity to the location before any manual interaction. The difference between the two can indicate queue wait time or pre-task preparation time.

Where to Find the Fields

Order Items Report

The geofence fields are available in the Order Items report but must be added via the column picker — they are not shown by default.

Adding the Geofence Columns

1. Navigate to Reports and select the Order Items tab.
2. Click the column picker icon (grid icon, top-right of the report) next to the export button.
3. In the Columns panel, type geofence into the search field.
4. Both columns will appear under Available columns:
   • Geofence Arrival Time
   • Geofence Departure Time
5. Tick both checkboxes. The columns will appear at the far right of the report table.

Tip: Once selected, click Save selection as preset at the bottom of the Columns panel to lock in your layout for future visits.

How Geofence Times Relate to Other Timing Fields

The report includes several task-level time columns. Here is how the geofence fields fit in:

Exporting the Data

Both geofence fields are included in the CSV and Excel export:

1. Apply your filters and ensure the geofence columns are ticked in the column picker.
2. Click the export icon (top-right corner).
3. In the exported file, Geofence Arrival Time and Geofence Departure Time appear.

Driver Activity Report

The same fields are also available in the Driver Activity report:

• Navigate to Reports → Driver Activity
• Use the column picker (same steps as above) to search for and add Geofence Arrival Time and Geofence Departure Time
• Use these columns alongside Arrival Time and Completion Time for a full per-task timeline

📸 [Screenshot placeholder: Driver Activity report with geofence columns added via the column picker]

Calculating Dwell Time

With both timestamps available, you can calculate how long a driver spent at each location:

Dwell Time = Geofence Departure Time − Geofence Arrival Time

This is more accurate than using Arrival Time alone, since geofence-based times are captured automatically and do not depend on the driver completing manual steps in the app.

Use cases for dwell time data:

• Identifying locations with consistently long wait times
• Measuring warehouse or depot efficiency
• Validating driver activity for invoicing or payroll
• Informing ETA predictions for subsequent tasks

When the Fields Are Blank

Geofence Arrival Time and Geofence Departure Time will be empty in the following situations:

Note: Geofence timestamps are enabled on a per-account (slug) basis. If these columns appear blank across all orders, the feature may not yet be active for your account.

Frequently Asked Questions

Does Geofence Arrival Time replace Arrival Time? No. They are separate fields that capture different things. Arrival Time is set by the driver tapping "Arrived" during task completion. Geofence Arrival Time is set automatically when the driver's device enters the geofence zone, independent of any driver action.

What is the geofence radius? The geofence radius is configured per task or address in TCMS. If you need to adjust the radius for a particular location, contact your Yojee Customer Success Manager.

Can I use these fields in external dashboards? Yes. Both fields are available in the CSV/Excel export from the Order Items and Driver Activity reports, and can be used in any BI tool or dashboard connected to your report data.

What if the driver passes the same location multiple times before completing the task? TCMS stores only the most relevant timestamp — the last geofence entry before task completion — so multiple passes do not create duplicate or misleading data.

Are these fields available for all task types? Yes — the timestamps apply to both pickup and delivery tasks wherever a geofence is configured for the task location.