Heavy long distance

A heavy long-distance operation runs multi-day corridors between distribution points, mixing scheduled warehouse pickups, loop tours that consolidate full loads without a fixed endpoint, and a real overnight rest built into the schedule rather than assumed. Fuel and CO2 costs scale with the actual load carried, not just the kilometres driven.

What makes this vertical distinctive

Reserved warehouse slots — an early pickup window at the warehouse is reserved for one specific vehicle, on top of the standard hours everyone else sees.
Load-aware CO2 accounting — CO2 is calculated from the load actually carried per leg, not from distance alone.
Consolidation loops — a truck with no fixed home base opens and closes its tour on whichever point it visits first, minimizing empty running.
A real overnight rest — a two-day route plans an explicit rest period, not just a working window that happens to span two days.

Combined example

{
  "resources": [
    {
      "id": "truck-1",
      "vehicleProfile": { "type": "truck", "grossWeight": 40000 },
      "workingTimeWindow": { "begin": "2026-08-03T06:00:00Z", "end": "2026-08-04T20:00:00Z" },
      "capacities": { "weight": 24000 },
      "breaks": [
        { "type": "workingDurationSlidingBreak", "minBreakDuration": "PT11H", "maxInterBreakDuration": "PT12H" }
      ],
      "CO2EmissionCalculation": {
        "km": { "costCoeff": 0.82 },
        "costPerCapacityPerTravelledKm": { "weight": { "costCoeff": 1.45e-05 } }
      }
    },
    {
      "id": "tractor-reserved-1",
      "vehicleProfile": { "type": "truck" },
      "tags": ["dock-slot:reserved-a"]
    },
    {
      "id": "truck-loops-1",
      "vehicleProfile": { "type": "truck" },
      "arrival": "atFirstPosition",
      "capacities": { "weight": 24000 }
    }
  ],
  "orders": [
    {
      "id": "order-warehouse-dock",
      "stops": [
        {
          "type": "single",
          "id": "stop-warehouse-dock",
          "position": { "lon": 2.55, "lat": 48.635 },
          "kind": "pickup",
          "operationDuration": "PT30M",
          "authorizedTimeWindows": [
            { "begin": "2026-08-03T06:00:00Z", "end": "2026-08-03T07:00:00Z", "resourceTags": ["dock-slot:reserved-a"] }
          ]
        }
      ]
    },
    {
      "id": "order-loop-0",
      "stops": [
        { "type": "single", "id": "stop-pickup-0", "position": { "lon": 2.595, "lat": 48.63 }, "kind": "pickup", "operationDuration": "PT30M", "capacities": { "weight": 8000 } },
        { "type": "single", "id": "stop-delivery-0", "position": { "lon": 2.568, "lat": 48.606 }, "kind": "delivery", "operationDuration": "PT30M", "capacities": { "weight": 8000 } }
      ],
      "successiveStops": true
    },
    {
      "id": "order-day2-delivery",
      "stops": [
        {
          "type": "single",
          "id": "stop-day2-delivery",
          "position": { "lon": 2.605, "lat": 48.615 },
          "kind": "delivery",
          "operationDuration": "PT25M",
          "authorizedTimeWindows": [{ "begin": "2026-08-04T08:00:00Z", "end": "2026-08-04T18:00:00Z" }]
        }
      ]
    }
  ]
}

Reserved warehouse slots

order-warehouse-dock’s window carries resourceTags: ["dock-slot:reserved-a"] — only tractor-reserved-1, which holds that tag, can be assigned this early slot; every other resource is restricted to whatever untagged window exists elsewhere on the same stop. See Restricting a window to specific resources — the exact worked example this follows.

Emissions scaled to load carried

truck-1.CO2EmissionCalculation mirrors the Cost object’s shape: a flat km rate plus costPerCapacityPerTravelledKm, which multiplies the weight actually carried on each leg by the distance travelled. A fully loaded leg reports more CO2 than an empty return leg over the same kilometres, instead of both being priced identically by distance alone.

Consolidation loops

truck-loops-1 has no departure and sets arrival: "atFirstPosition" — its tour closes on whichever stop the engine assigns first, rather than a fixed depot. Paired with order-loop-0’s pickup-then-delivery stops (successiveStops: true, matching weight capacities), this lets the engine build a self-contained loop sized to whatever load it consolidates. See Depot vs. position for how "atFirstPosition" fits alongside a normal fixed departure/arrival.

A real overnight rest

truck-1.workingTimeWindow spans two calendar days, but that alone wouldn’t force any rest between them — the workingDurationSlidingBreak (an 11-hour minimum every 12 hours) is what actually reserves the overnight period, which is why order-day2-delivery’s window only opens the next day. See Modeling multi-day sleepovers — the exact worked example this follows.

Full payload

Full payload — ready to submit as POST /plans

The preceding example isolates the four mechanisms this vertical needs; this expands it to the scale of a real working day — a full fleet schedule (workingTimeWindow, departure, arrival), the complete objectives list, and enough orders (including an LTL pickup/dropoff pair unloaded in strict LIFO order) to look like an actual route rather than a minimal illustration. Submit it as-is via POST /plans — the service assigns the plan’s id, so don’t include one of your own.

{
  "tz": "Europe/Paris",
  "resources": [
    {
      "id": "truck-1",
      "vehicleProfile": { "type": "truck", "grossWeight": 40000, "avoidTunnel": true, "tunnelCategory": "D", "shippedHazardousGoods": ["flammable", "corrosive"] },
      "workingTimeWindow": { "begin": "2026-08-03T06:00:00Z", "end": "2026-08-04T20:00:00Z" },
      "departure": { "lon": 2.58, "lat": 48.62 },
      "arrival": { "lon": 2.58, "lat": 48.62 },
      "capacities": { "weight": 24000 },
      "breaks": [{ "type": "workingDurationSlidingBreak", "minBreakDuration": "PT11H", "maxInterBreakDuration": "PT12H" }],
      "maxWorkingDuration": "PT13H",
      "cost": { "workedHours": { "costFloor": 8, "costCoeff": 1, "overcostFloor": 10, "overcostCoeff": 1.25 } },
      "CO2EmissionCalculation": { "km": { "costCoeff": 0.82 }, "costPerCapacityPerTravelledKm": { "weight": { "costCoeff": 1.45e-05 } } }
    },
    {
      "id": "tractor-preloaded-1",
      "vehicleProfile": { "type": "truck" },
      "workingTimeWindow": { "begin": "2026-08-03T05:00:00Z", "end": "2026-08-04T20:00:00Z" },
      "departure": { "lon": 2.572, "lat": 48.594 },
      "arrival": { "lon": 2.58, "lat": 48.62 },
      "capacities": { "weight": 18000 },
      "tags": ["trailer"]
    },
    {
      "id": "tractor-reserved-1",
      "vehicleProfile": { "type": "truck" },
      "workingTimeWindow": { "begin": "2026-08-03T05:00:00Z", "end": "2026-08-04T20:00:00Z" },
      "departure": { "lon": 2.58, "lat": 48.62 },
      "arrival": { "lon": 2.58, "lat": 48.62 },
      "tags": ["dock-slot:reserved-a"]
    },
    {
      "id": "truck-loops-1",
      "vehicleProfile": { "type": "truck" },
      "workingTimeWindow": { "begin": "2026-08-03T05:00:00Z", "end": "2026-08-04T20:00:00Z" },
      "arrival": "atFirstPosition",
      "capacities": { "weight": 24000 }
    },
    {
      "id": "tanker-1",
      "vehicleProfile": { "type": "truck" },
      "workingTimeWindow": { "begin": "2026-08-03T05:00:00Z", "end": "2026-08-04T20:00:00Z" },
      "departure": { "lon": 2.58, "lat": 48.62 },
      "arrival": { "lon": 2.58, "lat": 48.62 },
      "capacities": { "petrol": 12000, "diesel": 9000, "additive": 1500 }
    }
  ],
  "orders": [
    {
      "id": "order-loop-0",
      "stops": [
        { "type": "single", "id": "stop-pickup-0", "position": { "lon": 2.595, "lat": 48.63 }, "kind": "pickup", "operationDuration": "PT30M", "capacities": { "weight": 8000 } },
        { "type": "single", "id": "stop-delivery-0", "position": { "lon": 2.568, "lat": 48.606 }, "kind": "delivery", "operationDuration": "PT30M", "capacities": { "weight": 8000 } }
      ],
      "successiveStops": true
    },
    {
      "id": "order-loop-1",
      "stops": [
        { "type": "single", "id": "stop-pickup-1", "position": { "lon": 2.56, "lat": 48.628 }, "kind": "pickup", "operationDuration": "PT30M", "capacities": { "weight": 8000 } },
        { "type": "single", "id": "stop-delivery-1", "position": { "lon": 2.605, "lat": 48.615 }, "kind": "delivery", "operationDuration": "PT30M", "capacities": { "weight": 8000 } }
      ],
      "successiveStops": true
    },
    {
      "id": "order-ltl-pickup-1",
      "stops": [{ "type": "single", "id": "stop-ltl-pickup-1", "position": { "lon": 2.585, "lat": 48.642 }, "kind": "pickup", "operationDuration": "PT20M", "capacities": { "weight": 2000 } }]
    },
    {
      "id": "order-ltl-pickup-2",
      "stops": [{ "type": "single", "id": "stop-ltl-pickup-2", "position": { "lon": 2.572, "lat": 48.594 }, "kind": "pickup", "operationDuration": "PT20M", "capacities": { "weight": 3000 } }]
    },
    {
      "id": "order-ltl-dropoff-1",
      "stops": [{ "type": "single", "id": "stop-ltl-dropoff-1", "position": { "lon": 2.595, "lat": 48.63 }, "kind": "delivery", "operationDuration": "PT20M", "capacities": { "weight": 2000 } }]
    },
    {
      "id": "order-ltl-dropoff-2",
      "stops": [{ "type": "single", "id": "stop-ltl-dropoff-2", "position": { "lon": 2.56, "lat": 48.628 }, "kind": "delivery", "operationDuration": "PT20M", "capacities": { "weight": 3000 } }]
    },
    {
      "id": "order-day1-delivery",
      "stops": [
        { "type": "single", "id": "stop-day1-delivery", "position": { "lon": 2.59, "lat": 48.602 }, "kind": "delivery", "operationDuration": "PT25M", "authorizedTimeWindows": [{ "begin": "2026-08-03T08:00:00Z", "end": "2026-08-03T18:00:00Z" }] }
      ]
    },
    {
      "id": "order-day2-delivery",
      "stops": [
        { "type": "single", "id": "stop-day2-delivery", "position": { "lon": 2.605, "lat": 48.615 }, "kind": "delivery", "operationDuration": "PT25M", "authorizedTimeWindows": [{ "begin": "2026-08-04T08:00:00Z", "end": "2026-08-04T18:00:00Z" }] }
      ]
    },
    {
      "id": "order-warehouse-dock",
      "stops": [
        {
          "type": "single",
          "id": "stop-warehouse-dock",
          "position": { "lon": 2.55, "lat": 48.635 },
          "kind": "pickup",
          "operationDuration": "PT30M",
          "authorizedTimeWindows": [{ "begin": "2026-08-03T06:00:00Z", "end": "2026-08-03T07:00:00Z", "resourceTags": ["dock-slot:reserved-a"] }]
        }
      ]
    },
    {
      "id": "order-trailer-0",
      "stops": [
        { "type": "single", "id": "stop-trailer-load-0", "position": { "lon": 2.572, "lat": 48.594 }, "kind": "pickup", "operationDuration": "PT45M", "capacities": { "weight": 6000 }, "tags": ["trailer:loaded"] },
        { "type": "single", "id": "stop-trailer-delivery-0", "position": { "lon": 2.595, "lat": 48.63 }, "kind": "delivery", "operationDuration": "PT25M", "capacities": { "weight": 6000 } }
      ]
    },
    {
      "id": "order-trailer-1",
      "stops": [
        { "type": "single", "id": "stop-trailer-load-1", "position": { "lon": 2.572, "lat": 48.594 }, "kind": "pickup", "operationDuration": "PT45M", "capacities": { "weight": 6000 }, "tags": ["trailer:loaded"] },
        { "type": "single", "id": "stop-trailer-delivery-1", "position": { "lon": 2.56, "lat": 48.628 }, "kind": "delivery", "operationDuration": "PT25M", "capacities": { "weight": 6000 } }
      ]
    },
    {
      "id": "order-petrol",
      "stops": [{ "type": "single", "id": "stop-petrol", "position": { "lon": 2.59, "lat": 48.602 }, "kind": "delivery", "operationDuration": "PT20M", "capacities": { "petrol": 4000 } }]
    },
    {
      "id": "order-diesel",
      "stops": [{ "type": "single", "id": "stop-diesel", "position": { "lon": 2.56, "lat": 48.628 }, "kind": "delivery", "operationDuration": "PT20M", "capacities": { "diesel": 3500 } }]
    },
    {
      "id": "order-additive",
      "stops": [{ "type": "single", "id": "stop-additive", "position": { "lon": 2.595, "lat": 48.63 }, "kind": "delivery", "operationDuration": "PT15M", "capacities": { "additive": 500 } }]
    }
  ],
  "objectives": ["maximizeMandatoryStops", "minimizeCosts", "minimizeDistance", "minimizeWorkingDuration"],
  "additionalConstraints": [
    { "type": "removalStrategy", "removalStrategy": "lifo", "name": "ltl-unload-in-lifo-order" }
  ],
  "operationDurationPoliciesByResourceTag": { "trailer": [{ "policy": "withoutFirstOperationDuration", "stopTags": ["trailer:loaded"] }] }
}

By industry

What makes this vertical distinctive

Combined example

Reserved warehouse slots

Emissions scaled to load carried

Consolidation loops

A real overnight rest

Full payload

See also

​What makes this vertical distinctive

​Combined example

​Reserved warehouse slots

​Emissions scaled to load carried

​Consolidation loops

​A real overnight rest

​Full payload

​See also

What makes this vertical distinctive

Combined example

Reserved warehouse slots

Emissions scaled to load carried

Consolidation loops

A real overnight rest

Full payload

See also