Schedule Route Optimization

This endpoint initializes the route optimization workflow. It requires the necessary information about the route optimization (RO) as a request parameter and responds with any issues in the input. If successful, it provides a summary and an RO ID for the next step in the optimization process.

Name	Type	Description
tasks	Array of Strings	Required. The list of tasks ID(s)s that are unassigned to consider for the Route Optimization.
teams	Object	The Team IDs and their associated workers' ID for Route Optimization to consider.
date	Number	Timestamp in unix.
timezone	String	Optional. The timezone in which the optimization should consider.
mode	Number	0 for Minimize Distance Driven. 1 for Always on Time. 2 for Aggressive batch order pairs(use for linked Tasks). 3 for Balance Driving distance and Timely Arrival
serviceTime	Number	The time that should be spent by the workers at each Task location, in minutes.
maxViolationTime	Number	Max allowed delay time, in minutes
maxTasksPerRoute	Number	The maximum number of tasks a worker can be assigned.
schedulingMethod	Number	Optional. Schedules that the RO should consider. 1 for use default schedule. 2 for worker schedules only.
defaultSchedule	Array of Numbers	Optional. An array of default schedules if no specific worker schedule is available.
optimizationServiceArea	String	Optional. The ID of the optimization service area if applicable.
routeStart	String	Optional. Starting point of the route, can be a hub or a worker's Location.
routeEnd	String	Optional. Ending point of the route.
osaRouteZoneCount	Number	Optional. Only used if RouteZone is involved.

🚧
Route Start and Route End
The routeStart and routeEnd have very specific formats. The allowed values are:

”teams://DEFAULT” (this will be the team hub)

”workers://ROUTING_ADDRESS” (the workers routing address)

”hub://{hub_id}" (specify a hub)

You also must have at least one of the two (routeStart or routeEnd) set. You can have both set, but having both empty will throw a validation error.

{
  "capacity": 30,
  "date": 1718728193838,
  "timezone": "America/Toronto",
  "mode": 1,
  "serviceTime": 15,
  "tasks": [
    "atnk3APxhJrgfx9mgWaRhByQ",
    "4kA7bOH*Kz7K0YA6~NpqWDke"
  ],
  "teams": {
    "5y1jHFp7OBfFU6SekbwwwRfL": [
      "GLlLB2123ABCkXOJAHPklMPZ",
      "~jCf16ZaT07pdtf~oFb~XAH9"
    ]
  },
  "schedulingMethod": 1,
  "routeStart": "teams://DEFAULT",
  "routeEnd": "teams://DEFAULT",
  "maxViolationTime": 0,
  "defaultSchedule": [
    {
      "date": 1718683200000,
      "slots": [
        {
          "start": "0000",
          "end": "2359"
        }
      ],
      "owner": "pOoPktB~Hry706w2JT30rJGi",
      "timezone": "America/Toronto"
    }
  ]
}

Response fields:

id (string). id for the optimization. This property is not included if issues includes an error.
shortId (string). shortId for the optimization.
issues (Array of issues). An issue includes.
- type (string). “warning“ or “error“. Warnings allow the optimization proceed. Errors prevent successful initialization of RO.
- message (string). User friendly message for the issue.
- shortId (string). shortId for the task causing the issue.
- reason (string). Identifier for the issue.
summary. This property is not included if issues includes an error.
- workers:
  - count (number). number of workers included in the optimization.
- tasks:
  - count (number). number of tasks included in the optimization.
- routeZones:
  - count (number). number of routeZones included in the optimization.

{
  "id": "CQ6rFedL7VBL2VjURsGnb1cx",
  "issues": [
    {
      "type": "warning",
      "message": "Task 611552d3 does not have a time range (completeAfter/completeBefore) specified. Add time range for better optimization.",
      "entityType": "task",
      "entityId": "atnk3APxhJrgfx9mgWaRhByQ",
      "shortId": "611552d3",
      "reason": "no-time-range"
    },
    {
      "type": "warning",
      "message": "Task 08607990 does not have a time range (completeAfter/completeBefore) specified. Add time range for better optimization.",
      "entityType": "task",
      "entityId": "4kA7bOH*Kz7K0YA6~NpqWDke",
      "shortId": "08607990",
      "reason": "no-time-range"
    }
  ],
  "summary": {
    "workers": {
      "count": 2
    },
    "tasks": {
      "count": 2,
      "cost": 0.2
    },
    "routeZones": {
      "count": 0
    },
    "total": 0.2
  },
  "shortId": "682589c95927064e"
}

📘
Use Start Route Optimization
This endpoint is simply setting up the parameters and preview the results. The error handling should occur in this step prior to start Route Optimization using Start Route Optimization

Schedule Route Optimization

🚧
Route Start and Route End

📘
Use Start Route Optimization

🚧Route Start and Route End

📘Use Start Route Optimization

🚧
Route Start and Route End

📘
Use Start Route Optimization