--- title: "Deadhead Calculator" slug: "deadhead-calculator" tags: ["Fleet Management"] updated: 2026-06-02T13:39:15Z published: 2026-06-02T13:39:15Z canonical: "documents.revenova.com/deadhead-calculator" --- > ## Documentation Index > Fetch the complete documentation index at: https://documents.revenova.com/llms.txt > Use this file to discover all available pages before exploring further. # Deadhead Calculator The Deadhead Calculator is a feature within the Fleet Management Console that assists in trip planning by calculating the distance a truck must travel without a load. Use this tool to optimize routes and reduce unnecessary mileage. ### Enable the Deadhead Calculator To use the Deadhead Calculator for Trip Planning, it must first be enabled in the TMS Admin Configuration settings for [Fleet Management](/v1/docs/fleet-management-3): 1. Navigate to **TMS Admin → Configuration**. 2. In the Fleet Management section, *check* the **Show Deadhead Calculator** field to enable the feature. ### Using the Deadhead Calculator Once enabled, the **Deadhead Calculator** button can be accessed in the Trip Planning section of the Fleet Management Console only for Fleet Load Views with the header expanded. Ensure you have the [Fleet Load View](/v1/docs/fleet-management-console-views#load-views) set up as intended, as this is necessary for the Deadhead Calculator to function properly. These header filters cannot be changed when the Deadhead Calculator section is visible. > [!TIP] > **Tip**: Use the header filters in the Fleet Load view to display less than 100 records for improved performance when calculating the deadhead distance. ![Fleet Management Console interface displaying the Fleet Load View in the Trip Planning section highlighting the Deadhead Calculator feature.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Fleet Management Console Trip Planning Deadhead Calculator Button(1).png) #### Configure the Calculator Select the **Deadhead Calculator** button to open the Deadhead Calculator LWC. ![Interface for calculating deadhead distance based on asset location and parameters.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Deadhead Calculator Configuration.png) In the LWC, configure the following settings: | Field | Values/Behavior | Description/Use | | --- | --- | --- | | Calculate Deadhead From | The available values are the following: - Asset - Driver - Load **Default Value**: Asset | The type of record to use for calculating the deadhead distance. Use *Asset* or *Driver* to calculate the deadhead distance from a Fleet Asset or Driver to a pickup location. Use *Load* to find backhaul opportunities by calculating the distance between loads. | | Based On | When the **Calculate Deadhead From** field is set to *Asset* or *Driver*, the following values are available: - Asset Final Planned Location - Asset Current Location - Asset Last Stop Location - Driver Domicile When the **Calculate Deadhead From** field is set to *Load*, this value is set to *Load Destination* and cannot be changed. **Default Value**: Asset Final Planned Location | The Asset, Driver, or Load location to use when calculating the deadhead distance. Use *Asset Final Planned Location* to use the **end location of the latest planned trip** for a Driver or a Fleet Asset. Use *Asset Current Location* to use the **latest geolocation** of either a Driver or a Fleet Asset on an active Trip Plan. > [!NOTE] > **Note**: For calculating deadhead from a *Driver*, the selected Driver must have an active Driver Assignment record. Use *Asset Last Stop Location* to use the **end location** of the **last Trip Plan Leg** of the **dispatched Trip Plan Segment**. Use *Driver Domicile* to use the **Driver’s assigned home location**. > [!NOTE] > **Note**: For calculating deadhead from an *Asset*, the selected Fleet Asset must have an active Driver Assignment record. Use *Load Destination* to use the Load’s **last stop location**. | | Using Asset/Driver/Load | If the **Link to View** field is *unchecked*, this field is a **lookup field** to a Power Unit (Fleet Asset), Driver, or Load record based on the **Calculate Deadhead From** value. If the **Link to View** field is *checked*, this field is a **picklist field** to a Fleet Asset, Driver, or Load record based on the value of the **From View** field. **Default Behavior**: Using Asset lookup field | The selected Asset, Driver, or Load record to use for the deadhead calculation. > [!NOTE] > **Note**: If this field is a lookup, it will only lookup Power Units instead of all Fleet Assets. To calculate the deadhead distance for any Fleet Asset, *check* the **Link to View** field to turn this field to a picklist. | | Link to View | *Check* to change the **Using Asset/Driver/Load** field from a **lookup** to a **picklist** field type and show the **From View** picklist field to select a different Fleet View. **Default Value**: *Unchecked* > [!CAUTION] > **Warning**: Clear the value in the **Using Asset/Driver/Load** field before *checking* this field. Otherwise, the **From View** field cannot be changed from *None*. | *Check* this field to use an Asset, Driver, or Load record based on a visible Fleet Management Console view. | | From View | This field only shows when the **Link to View** field is *checked*. The values for this field depend on the **Calculate Deadhead From** value selected and which views are actively shown in the Fleet Management Console LWC: - **Asset**: Fleet Asset View Type - **Driver**: Fleet Driver View Type - **Load**: Fleet Load View Type The **Using Asset/Driver/Load** field displays records that respect the filters saved on the selected view. **Default Behavior**: Hidden | The Fleet Management Console view to use when selecting which Asset, Driver, or Load record to use. Select the **View Manager** to choose a view. > [!NOTE] > **Note**: The current Fleet Load view that is using the Deadhead Calculator **cannot** be selected in this list. | | Showing Results In | The available values are the following: - Miles - Kilometers **Default Value**: Miles | Calculate and display the unit of measurement of the deadhead calculation. | #### Calculate Distance The **Calculate Distance** button becomes available when an Account or location information is found based on the configuration. Click the button to compute the deadhead distance. The distance is measured from the Asset/Driver/Load’s location to the Load record's **origin** location in the list. > [!NOTE] > **Note**: A location must be identified in the Deadhead Calculator under the **Based On** field. Otherwise, “No Location Found” displays in red text and the **Calculate Distance** button is greyed out. The calculations appear next to the Load in the list of Load records when the grid is expanded, and are sorted from shortest to longest in deadhead distance. Click the **Deadhead Calculator** button again to hide the LWC. When the Deadhead Calculator is hidden, the Deadhead Miles/Kilometers column is removed from the list. ![Fleet Management Console displaying deadhead calculations and Load record details.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Deadhead Calculation Results(1).png) #### **Based On** Location Flowcharts Expand the appropriate **Calculate Deadhead From** option for the **Based On** field to display the flowchart in determining the location that is used in the Deadhead Calculator LWC. > [!CAUTION] > **Warning**: If the **Shipping Address** field is blank on the Account for a location in the LWC, and then the **Calculate Distance** button is clicked, an error will populate stating that the origin location is invalid or missing. The **Shipping Address** field on the Account must have at least the following values: > > - **Shipping Country** > - **Shipping City** and **Shipping State/Province** *OR* **Shipping Zip/Postal Code** **Asset Final Planned Location** Use this option to find the **latest** planned end location of a Fleet Asset or Driver across **ALL** active Trip Plans. > [!WARNING] > **Caution**: If the **Appointment Date** on the **last** Trip Plan Leg is blank, the **Due Out** date is used instead. If both fields are blank, then “No Location Found” is displayed under the **Based On** field in the Deadhead Calculator LWC. The following flowcharts assumes the the last Trip Plan Leg records have a value in the **End Date/Time** field. The actual value used for comparison is the **Calculated Fallback Datetime** field. ****Calculate Deadhead From**: Asset** > [!NOTE] > **Power Unit vs. Fleet Asset Note**: If the Fleet Asset record selected in the **Using Asset** field is a Power Unit, it uses the latest Trip Plan Leg of the last planned Trip Plan Segment. If the Fleet Asset record is **not** a Power Unit (such as a Trailer), it uses the latest planned Trip Plan Leg where the Trip Plan Leg Asset is the record selected in the **Using Asset** field. ![Flowchart detailing steps to find the latest Trip Plan Leg for Fleet Asset.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Fleet Asset - Asset Final Planned Location Flowchart(1).png) ****Calculate Deadhead From**: Driver** ![Flowchart illustrating steps to find the latest Trip Plan Leg for a Driver.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Driver - Asset FInal Planned Location Flowchart.png) **Asset Current Location** Use this option to use the current location of a Fleet Asset or Driver (with a Driver Assignment). ****Calculate Deadhead From**: Asset** ![Flowchart illustrating steps to retrieve Fleet Asset geolocation data for the current location](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Fleet Asset - Asset Current Location Flowchart.png) ****Calculate Deadhead From**: Driver** > [!CAUTION] > **Warning**: This option requires the **Driver** to have an active Driver Assignment, where the **Start Date** is any time before *now*, and if there is an **End Date**, it hasn’t surpased that date and time. ![Flowchart illustrating driver assignment and geolocation process with decision points.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Driver - Asset Current Location Flowchart(1).png) **Asset Last Stop Location** Use this option to find the end location of a Power Unit or Driver in a **Dispatched** Trip Plan Segment. ****Calculate Deadhead From**: Asset** > [!NOTE] > **Power Unit vs. Fleet Asset Note**: If the Fleet Asset record selected in the **Using Asset** field is a Power Unit, it uses the **latest** Trip Plan Leg of the **dispatched** Trip Plan Segment with that Tractor or Box Truck. If the Fleet Asset record is **not** a Power Unit **or** the Trip Plan Segment is **not** **dispatched**, then **No Location Found** is displayed. ![Flowchart illustrating steps to find last dispatched trip plan leg for the power unit.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Fleet Asset - Last Stop Location.png) ****Calculate Deadhead From**: Driver** ![Flowchart illustrating steps to find the last dispatched trip plan leg for a driver.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Driver - Last Stop Location Flowchart.png) **Driver Domicile** Use this option to use the driver domicile location of a Fleet Asset (with a Driver Assignment) or Driver. ****Calculate Deadhead From**: Asset** > [!CAUTION] > **Warning**: This option requires the **Fleet Asset** to have an active Driver Assignment, where the **Start Date** is any time before *now*, and if there is an **End Date**, it hasn’t surpased that date and time. ![Flowchart illustrating driver assignment process and location lookup steps.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Fleet Asset - Driver Domicile Location Flowchart.png) ****Calculate Deadhead From**: Driver** ![Flowchart illustrating driver record retrieval and address lookup process steps.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Driver - Driver Domicile Location Flowchart.png) ### Search for Backhaul Opportunities The Deadhead Calculator can also be used to find backhaul opportunities by searching lanes for specific routes. Enter the **Origin** and/or **Destination Address** along with a **Radius** and its **Units** to find potential loads for the return trip. Set the **Calculate Deadhead From** field to *Load* and select a Load record in the **Using Load** field to search for these opportunities. Then, click the **Calculate Distance** button in the Deadhead Calculator LWC. > [!WARNING] > **Caution**: If the Load Destination has changed after selecting the Load record, you must close the calculator and refresh the Fleet Load View to have the updated location displayed under the **Based On** field and have the correct calculated distance in the grid/list of Load records. The list of Load records is sorted from shortest to longest in deadhead distance. ![Fleet Management Console displaying Deadhead Calculator and load details for backhaul opportunities.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Backhaul Opportunities using Deadhead Calculator.png) #### Load Destination Logic Use the following flowchart to determine the **Load Destination** location of a Load record in the Deadhead Calculator LWC: ![Flowchart detailing steps for verifying location and geolocation fields in records.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Load - Load Destination Location Flowchart(1).png) If the **Location** field has a value, the location displays in the LWC with the format {Account Name}: City, State Abbreviation. ![Deadhead calculator interface showing location name for Denver Deli Meats in Denver, Colorado.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Load Destination Location Format for Matching Stop Account.png) **Geolocation Stops** If the **Location** field for the Last Stop is blank, the location is determined from the **Geolocation** field's latitude and longitude, and the coordinates are **reverse-geolocated**. The location displays in the LWC with the format City, State Abbreviation. ![Deadhead calculator interface showing Chicago, IL as the load destination option.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Load Destination Location Format for Matching Geolocation(1).png) If the Stop does not have either a Location Account or Geolocation coordinates, then the **City** and **State/Province** *or* **Postal Code** fields are used for the location. **City/State/Postal Code Stops** If the **City** and **State/Province** field combination is used, then the location displays in the LWC with the format City, State Abbreviation, just like the **Gelocation** match. If the Stop only uses the **Postal Code** field, then the location displays in the format Latitude, Longitude. ![Deadhead calculator displaying load destination coordinates for route planning.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Load Destination Location Format for Matching Postal Code(1).png) **Missing Stop Information** If the Last Stop does not contain any location information, then an error message displays stating that the selected Load record needs values in the **City** and **State/Province** *or* **Postal Code** fields. ![Error message indicating missing city and state information for the Deadhead Calculator.](https://cdn.document360.io/b89abf73-101a-4754-a781-084aef8f68dd/Images/Documentation/Deadhead Calculator Error Missing City-State or Postal Code.png) Any Trip Plan with one of these statuses: - Pending - Load Changed - Configured - Pending Final - Dispatched A Fleet Asset that is used to power the movement of a Load. The types are **Tractor** or **Box Truck**. An equipment or vehicle used in Fleet Management operations. Types include: - Tractor - Trailer - Box Truck - Chassis - Container - Tanker A Fleet Asset that is part of a Trip Plan Leg. The types are: - Trailer - Chassis - Container - Tanker