Time Windows

When deliveries have opening hours, add an opening_time window ([from, to]) to each section: the window applies to the arrival at that section’s destination. The optimizer then plans departure time and charging together so every window is met — it can shift the tour start later (optimal_departure_time in the response) and place charging where waiting would otherwise occur, so time spent standing is used for charging. This example delivers from Munich to Augsburg (09:00–12:00 window) and on to Ulm (13:00–17:00 window). start_time_tour is the earliest the truck can leave; the response tells you when it should leave.

Request

curl -X POST "https://api.fryte.com/planner/v2?corridor=8000" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "010160700001",
    "battery_level_start": 0.8,
    "section_list": [
      {
        "section_id": "muenchen-augsburg",
        "start_pos": [48.1351, 11.5820],
        "stop_pos": [48.3705, 10.8978],
        "payload_kg": 19300,
        "opening_time": ["09:00:00", "12:00:00"]
      },
      {
        "section_id": "augsburg-ulm",
        "start_pos": [48.3705, 10.8978],
        "stop_pos": [48.4011, 9.9876],
        "payload_kg": 12000,
        "opening_time": ["13:00:00", "17:00:00"]
      }
    ],
    "poi_info": {
      "min_kW": 150,
      "connector_type": ["CCS"]
    },
    "start_time_tour": "06:00:00"
  }'

import requests

response = requests.post(
    "https://api.fryte.com/planner/v2",
    params={"corridor": 8000},
    headers={"Authorization": "Bearer <your-token>"},
    json={
        "vehicle_id": "010160700001",
        "battery_level_start": 0.8,
        "section_list": [
            {
                "section_id": "muenchen-augsburg",
                "start_pos": [48.1351, 11.5820],
                "stop_pos": [48.3705, 10.8978],
                "payload_kg": 19300,
                "opening_time": ["09:00:00", "12:00:00"],
            },
            {
                "section_id": "augsburg-ulm",
                "start_pos": [48.3705, 10.8978],
                "stop_pos": [48.4011, 9.9876],
                "payload_kg": 12000,
                "opening_time": ["13:00:00", "17:00:00"],
            },
        ],
        "poi_info": {
            "min_kW": 150,
            "connector_type": ["CCS"],
        },
        "start_time_tour": "06:00:00",
    },
)
print(response.json())

const response = await fetch("https://api.fryte.com/planner/v2?corridor=8000", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <your-token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    vehicle_id: "010160700001",
    battery_level_start: 0.8,
    section_list: [
      {
        section_id: "muenchen-augsburg",
        start_pos: [48.1351, 11.5820],
        stop_pos: [48.3705, 10.8978],
        payload_kg: 19300,
        opening_time: ["09:00:00", "12:00:00"],
      },
      {
        section_id: "augsburg-ulm",
        start_pos: [48.3705, 10.8978],
        stop_pos: [48.4011, 9.9876],
        payload_kg: 12000,
        opening_time: ["13:00:00", "17:00:00"],
      },
    ],
    poi_info: {
      min_kW: 150,
      connector_type: ["CCS"],
    },
    start_time_tour: "06:00:00",
  }),
});
const data = await response.json();
console.log(data);

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer <your-token>");

var json = """
{
    "vehicle_id": "010160700001",
    "battery_level_start": 0.8,
    "section_list": [
        {
            "section_id": "muenchen-augsburg",
            "start_pos": [48.1351, 11.5820],
            "stop_pos": [48.3705, 10.8978],
            "payload_kg": 19300,
            "opening_time": ["09:00:00", "12:00:00"]
        },
        {
            "section_id": "augsburg-ulm",
            "start_pos": [48.3705, 10.8978],
            "stop_pos": [48.4011, 9.9876],
            "payload_kg": 12000,
            "opening_time": ["13:00:00", "17:00:00"]
        }
    ],
    "poi_info": {
        "min_kW": 150,
        "connector_type": ["CCS"]
    },
    "start_time_tour": "06:00:00"
}
""";

var response = await client.PostAsync(
    "https://api.fryte.com/planner/v2?corridor=8000",
    new StringContent(json, System.Text.Encoding.UTF8, "application/json")
);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);

Response

{
  "qualification": "Driveable",
  "battery_level_start": 0.8,
  "battery_level_end": 0.674,
  "optimal_departure_time": "2026-05-04T08:40:00Z",
  "time_windows_reachable": "True",
  "sections": [
    {
      "start_pos": [48.135, 11.582, 0.80],
      "stop_pos": [48.28, 11.271, 0.779],
      "polyline": "BlX8s5lJkk...",
      "poi_summary": {
        "id": 0,
        "name": "Energie Südbayern (ESB)",
        "address": "Ohmstraße 2",
        "coordinate_lat": 48.28,
        "coordinate_lon": 11.269,
        "power_available_kW": 300.0,
        "energy_kWh": 18.0,
        "charge_time_min": 4.0,
        "service_time_min": 7.0,
        "arrival_time": "2026-05-04T09:33:18Z",
        "sec_length_km": 31.223,
        "sec_duration_min": 53.318,
        "sec_energy_consumption_kWhkm": 0.983,
        "start_soc": 0.749,
        "stop_soc": 0.779,
        "additional_stops": true,
        "alternatives": [
          { "name": "Tesla Supercharger", "address": "An der Brandleiten 6", "coordinate_lat": 48.394, "coordinate_lon": 11.071 },
          { "name": "Shell Recharge", "address": "Laimeringer Straße 10", "coordinate_lat": 48.39, "coordinate_lon": 11.066 },
          { "name": "Aral pulse", "address": "Laimeringer Straße 2", "coordinate_lat": 48.39, "coordinate_lon": 11.064 },
          { "name": "Electra", "address": "Laimeringer Straße 1", "coordinate_lat": 48.391, "coordinate_lon": 11.064 }
        ],
        "amenities": [],
        "bookable": false,
        "location_id": "a667eb3e-77f7-11ed-8312-42010aa40fc0"
      }
    },
    "... 5 more sections ...",
    {
      "start_pos": [48.457, 10.029, 0.669],
      "stop_pos": [48.401, 9.988, 0.674],
      "polyline": "BlXgr4nJs5...",
      "poi_summary": {
        "id": 0,
        "name": "Destination",
        "address": "See Destination",
        "coordinate_lat": 48.401,
        "coordinate_lon": 9.988,
        "power_available_kW": 0,
        "energy_kWh": 0,
        "charge_time_min": 0,
        "service_time_min": 0,
        "arrival_time": "2026-05-04T13:00:53Z",
        "sec_length_km": 8.735,
        "sec_duration_min": 12.91,
        "sec_energy_consumption_kWhkm": -0.306,
        "start_soc": 0.674,
        "stop_soc": 0.674,
        "additional_stops": false,
        "alternatives": null,
        "amenities": [],
        "bookable": false,
        "location_id": null
      }
    }
  ]
}

What the optimizer did

Two response fields carry the time-window result:

optimal_departure_time: the truck should leave at 08:40, not at the earliest possible 06:00 — leaving earlier would only mean waiting in front of a closed gate in Augsburg.
time_windows_reachable: "True" — both windows are met (Augsburg within 09:00–12:00, Ulm within 13:00–17:00). If a plan cannot meet every window, the best feasible plan is returned and this field is "False".

The first stop is a short 4-minute top-up: with tight windows the optimizer charges in small increments where they cost the least time. If such short sessions are operationally undesirable, set a floor with min_charge_duration_min.

Time windows are not considered on multi-day tours.

Getting Started

Example Routes

Endpoints

Request

Response

What the optimizer did

​Request

​Response

​What the optimizer did

Request

Response

What the optimizer did