Viewing average facility dwell times

First available in TMW Back Office 2023.2

Dwell time is the total amount of time that a driver is at a facility. It includes time spent loading and unloading, as well as any slack or detention time.

With Trimble Places, you can view average dwell times for a particular facility.

There are two types of dwell time information available:

  • Global: Calculated across all transportation companies that collect dwell time data

  • Fleet: Calculated across a single transportation company’s fleet of trucks

To use this feature, you must determine how and when the system receives dwell time information. You do this in the Trimble Places Configuration window.

You can then view dwell times in:

  • The profile of an eligible company (an active company that is linked to Trimble Places)

  • The Trip Folder Stops grid in TMWSuite and TMW Operations when you load an eligible trip (a trip that has not yet started and contains one or more stops at eligible companies)

As of TMW Back Office 2023.3, if you have telemetry enabled, you can view related telemetry data and logs. For assistance, contact Trimble Transportation Support.

Configuring feature options

You set configuration options in the Trimble Places Configuration window.

  1. Go to Tools > Setup > Trimble Places > Configuration.
    The Trimble Places Configuration window opens.

  2. If you are using TMW Back Office version 2023.3 or later, the window is automatically editable. If you are using an earlier version, go to File > Open.

    tpconfig20232

  3. Enable the feature.

  4. Enable the feature and set other options if they have not already been set.

  5. Set options in the Average Facility Dwell Time section.

    Field Definition

    Dwell Time Source

    Type of dwell time data that appears for a stop company in the Trip Folder in TMW Operations and TMWSuite. Options are:

    • Global
      Average dwell time data calculated across all transportation companies that collect it

    • Fleet
      Average dwell time data calculated across a single transportation company’s fleet of trucks

    Update Eligible Trip Stops Average Dwell Time

    When selected, the system updates dwell time data on eligible companies' stops in the Trip Folder according to a schedule that you must specify.

    Update Eligible Companies Average Dwell Time

    When selected, the system updates dwell time data on the profiles of eligible companies according to a schedule that you must specify.

    Dwell Time Endpoints

    Token, global endpoint, and fleet endpoint information used to retrieve dwell time data from Trimble Maps. You can get this information from your implementation specialist or from Trimble Transportation Support.

  6. Click image10 Close.

Retrieving dwell time information in the Company Profile window

For eligible companies, an Average Dwell Times section appears in the Stop Info/Routing tab of the Company Profile window.

Each time you open the company’s profile, the system collects and displays available average dwell time data for a 24-hour day as well as for each 60-minute period of the day. This information is read-only.

dwelltimes

As of TMW Back Office version 2023.3, a warning icon appears if the system is unable to retrieve dwell times. Move your mouse over the icon to see the warning message.

warningicon

Scheduling dwell time updates

Trimble recommends scheduling automatic dwell time updates for all eligible companies and/or trips. It lets you avoid having to open the company profile to retrieve new data.

Polling interval scheduling and dwell time scheduling are separate and independent processes.
  1. In the Trimble Places Configuration window, do one or both of the following:

    • To enable scheduled updates for eligible trips, select Update Eligible Trip Stops Average Dwell Time.

    • To enable scheduled updates for eligible companies, select Update Eligible Companies Average Dwell Time.

    afdtupdates

    Note: If you select one or both checkboxes without specifying a schedule, a validation error occurs when the system attempts to retrieve data.

  2. Click the link to the right of the selected checkbox.
    The Select Schedule window opens.

    afdtsched

  3. Make changes in the fields as indicated.

    Field Definition

    Run Every

    Update frequency. Choose one of these:

    • 1 to 7 days (companies and trips)

    • 1 to 12 hours (trips only)

    Beginning on

    Date the update begins

    Run on These Days

    Day(s) the update runs. Choose one of these:

    • Every day

    • One or more days of the week

  4. Click OK.
    The link text changes, displaying the schedule you selected.

Viewing dwell time information in the Trip Folder

For information on how the Trip Folder uses dwell times, see: