Orders, Locations and Stops are basic Technical Concepts for Tour Planning.
In order to be able to use PTV xTour service to calculate tours with a PlanToursRequest general technical concepts need to be understood.
|VisitOrder||A request to visit a site. It involves one task - the visit of a specified customer.|
|TransportOrder||A request to transport some quantities from one site to another. It involves two tasks - a pickup task and a subsequent delivery task of the transported quantities.|
Each task is specified by the site, where it has to be carried out, and the service time it takes. Additionaly, transport orders specify the quantities to be transported.
Every location contains exact map coordinates. We distinguish between locations that are solely meant for locating vehicles The term vehicle describes what is being routed or planned for. Vehicles are used in route calculation, distance matrix calculation and effectively also in tour planning. In route calculation, vehicle properties like overall size, weight and speed are in focus. In tour planning, it is vehicle properties like capacity and availability. Commonly a vehicle is motorized, like a truck - including its trailer or a car. However also a bike or even a pedestrian are included in this definition. - so-called vehicle locations - and locations where tasks of orders may be carried out - so-called sites.
Vehicle locations represent a location, where a vehicle starts or ends its tour. The
Sites represent locations, where tasks can be carried out. Therefore, sites specify the boundary conditions for carrying out tasks at this location. Service is allowed to begin only within the site's set of opening intervals.
In contrast to customer sites, depot sites act as trip delimiters within tours. As such, goods are usually only allowed to be picked up at a depot if the vehicle is empty. And goods are usually only allowed to be delivered at a depot if the vehicle will become empty again. There is only one exception: Consecutive depot stops. So the correct definition reads as follows:
Here, "empty" does not only mean that there is no load on the vehicle but also that there is no open transport order (e.g. without any specified quantities). For more details on trips, see Tours and Trips.
Stops group subsequent tasks of orders within a tour that are carried out at the same site. If there is more than one task at the same customer site, tasks are grouped to one stop and scheduled in order of their type: DELIVERY tasks before VISIT tasks before PICKUP tasks. If there is more than one task at the same depot site, all DELIVERY tasks are grouped to one stop and all PICKUP tasks are grouped to another one. These two stops will be part of two different trips. Please note that a depot site cannot be visited, i.e., there cannot be a visit order which references a depot site.
The sequence of tasks at a stop with multiple transport tasks with same task type will be sorted by Last In - First Out (LIFO). If there is more than one transport task of the same task type at a stop, the order of those tasks is dependent on the position of the corresponding partner task of the transport order within the trip: If a pickup task p1 is in front of another pickup task p2 at the same stop, the corresponding delivery task d2 is scheduled before d1.