How to consider commuting times for tour period restrictions

Restrictions for the overall tour period can be set either globally or separately for each vehicle. Separate settings for each vehicle provide the possibility to consider commuting times for the tour period restriction. Driver specific tour restrictions may be relevant for drivers, such as field representatives, who can start and end their tour at home instead of company headquarters.

Benefits

You can set tour period restrictions for single drivers, considering their individual commuting times.

Prerequisites

You need PTV xTour Server and a license entry for planBasicTours or planSequence.

Concept

Usually drivers commute to and from company headquarters and start their tours there. If a driver starts his tour directly from home, the home of the driver becomes the "depot", the overall tour period can be reduced by a representative commuting period to simulate a tour start at company headquarters.

There are four kinds of periods involved:

tour period

period of the complete tour which starts and ends at the depot, in this case the home of the employee. EU regulations for break and rest apply.

allowable tour period

the part of the tour period that can be considered as non-working period by the employer. Usually it represents the employee's driving time to and from the company location. If the total driving time to the first customer and from the last customer is shorter than the driving time to and from the company location, the allowable tour period is the total driving time to the first customer and from the last customer.

working period

the period in which the employee works. This period is without breaks. EU regulations for break and rest apply.

net tour period

the tour period reduced by the allowable tour period.

The following figure illustrates this scenario:

On the left side a regular tour starts at the company headquarters as depot and ends there. The driver commutes to and from the depot. On the right side the tour starts and ends at the drivers' home.

Programming Guide

The overall tour period can be restricted by setting maxPeriod in TourRestrictions. For the scenario described above, the commuting time has to be taken into account when restricting the overall tour period. To accomplish that, the tour period can be restricted by setting the MaximumTourPeriodRestrictions at the BaseVehicle.

Example

A field representative might have a travel time to and from company headquarters of 1:15 hours. For the concrete tour, let the driving time from the depot (home) to customer1 be 0:30 hours, and from customerN to the depot (home) 1 hour.

The allowable tour period is defined as the minimum of the total driving time to the first customer and from the last (1:30 hours) and the travel time to and from work (1:15 hours). That means the maximumAllowableTourPeriod has to be set to 1:15 hours (4500 seconds).

If the maximumNetTourPeriod is set to 4:00 hours (14400 seconds) for this tour, the period of the resulting tour would be restricted to a maximum of 5:15 hours (4:00 hours net tour period + 1:15 hours allowable tour period).

JSON sample Request: planBasicTours() with MaximumTourPeriodRestrictions

{
  "transportOrders": [
    {
      "$type": "TransportDepot",
      "id": 101,
      "trailerLoadingForbidden": false,
      "transportPoint": {
        "id": 1010,
        "location": {
          "point": {
            "x": 675000,
            "y": 6380000
          }
        },
        "tourSection": 0,
        "servicePeriod": 0,
        "useServicePeriodForRecreation": false,
        "allowServiceSplit": true,
        "openingIntervalConstraint": "START_OF_SERVICE",
        "coDriverRequired": false
      }
    },
    {
      "$type": "TransportDepot",
      "id": 102,
      "trailerLoadingForbidden": false,
      "transportPoint": {
        "id": 1020,
        "location": {
          "point": {
            "x": 671006,
            "y": 6382294
          }
        },
        "tourSection": 0,
        "servicePeriod": 0,
        "useServicePeriodForRecreation": false,
        "allowServiceSplit": true,
        "openingIntervalConstraint": "START_OF_SERVICE",
        "coDriverRequired": false
      }
    }
  ],
  "depots": [
    {
      "id": 201,
      "location": {
        "point": {
          "x": 681812,
          "y": 6375071
        }
      }
    }
  ],
  "fleet": {
    "vehicles": [
      {
        "id": 301,
        "depotIdStart": 201,
        "depotIdEnd": 201,
        "isPreloaded": false,
        "dimaId": 1,
        "ignoreTransportPointServicePeriod": false,
        "coDriverStatus": "NEVER",
        "toursMustFitIntoSingleOperatingInterval": false,
        "driverSettings": {
          "regulationsId": 1,
          "maximumTourPeriodRestriction": {
            "maximumNetTourPeriod": 14400,
            "maximumAllowableTourPeriod": 4500
          }
        }
      }
    ]
  },
  "planningParams": {
    "$type": "StandardParams",
    "coDriverTransportPointsInSeparateTours": false,
    "distanceMatrixCalculation": [
      {
        "$type": "DistanceMatrixByRoad",
        "dimaId": 1,
        "deleteBeforeUsage": true,
        "deleteAfterUsage": true,
        "profileName": "dimaCar"
      }
    ],
    "regulations": [
      {
        "$type": "DriverRegulations",
        "id": 1
      }
    ]
  },
  "callerContext": {
    "properties": [
      {
        "key": "TransactionId",
        "value": "Test-Request"
      }
    ]
  }
}

Copyright © 2024 PTV Logistics GmbH All rights reserved. | Imprint