Working with the resulting solution

When automatic routing is complete, you can view and edit the results.

Solution ID

Each solution has a unique task_id, which is given in the URL:

https://yandex.com/courier/companies/<company_id>/depots/all/mvrp/<task_id>,

where company_id is the company ID.

To open the solution later, save the address from the browser address bar.

Page elements

The page for working with the resulting solution has the following blocks:

You can change the block layout:

  • Position the block

    Hover over the upper-left corner of the block, and left-click and drag the block to the desired location.

  • Set the block size

    Use the control element in the lower-right corner of the block.

  • Change column width

    To adjust the column width, move the borders of the column header.

  • Reorder columns and choose which ones to show

    Click in the upper-right corner of the block.

    • To adjust the column order, drag the column name to the desired position in the list.
    • To hide a column, disable the option with the relevant name.
    • To return to the standard settings, click Reset.

Control panel

Date

Corresponds to the date or period for which the solution was planned. By default, routes are displayed as of the date that corresponds to the start of the planning period. To view routes for multiple days in a row, enter the start and end dates. You can select only the dates within the planning period.

Copy the planning link

Use the  icon to copy the link to a ready solution.

Search

Search by location or route number. To go to a particular object, select a location or route from the drop-down list, and it will be highlighted in the blocks.

Filter

The filter lists the values from the Employee properties field in the Routes table (equivalent to tags). To display routes that match specific employee properties, select the appropriate value. You can select multiple values. As a result, data is filtered across all blocks.

Employees

You can hide routes from specific employees.

New planning

Starts a new planning task. To avoid losing the current solution's results, save the ID task_id before starting a new planning task.

Export

Used for exporting solutions.

Routes

When you select a route in the table, it is highlighted on the map, and the locations included in it are displayed in the Visits table.

Replace employee: Assign a route to a different employee.

: Comments on the route. Hover over the icon to see the comments.

: Hide the route on the map. Clicking it in the table header will hide all routes.

Visits and Undistributed visits

When you select a row in the Visits table, the corresponding point is highlighted on the map.

: Comments on the visit. Hover over the icon to see the comments.

Planning results

The table contains basic metrics of the resulting solution, including:

  • The number of locations, visits, routes, and employees.
  • Working time utilization.
  • Average duration and distance of routes.
  • Violations.

The table below describes some metrics:

Metric name Metric Description
Routes used_man_days Total number of routes
Locations assigned_locations_count / (assigned_locations_count + unassigned_locations_count) Total number of visited locations / Total number of visited and unvisited locations
Visits accomplished_visits / (accomplished_visits + unfulfilled_visits) Total number of visits to locations / Total number of completed and skipped visits to locations
Visit time utilization affecting_utilization Ratio of the time at all locations to the total working time, %
Utilization of all working time general_utilization Ratio of the total planned time to the total available working time, %

Total available employee time is calculated based on the values of the max_duration_s parameter. If these values aren't specified, it is calculated based on the values of the hard_max_duration_s parameter. If these values aren't specified either, the value defaults to 48 hours. For more information, see Start and end of a working day.
Time window violations at locations total_failed_time_window_count Number of times locations were visited earlier or later than the specified time window
Time window violations total_failed_time_window_duration_s Total time of location window violations in a solution
Overtime overtime_runs_count Number of overtime cases in a solution
Overtime duration overtime_duration_s Total duration of overtime of all employees in a solution
Average overtime duration avg_overtime Average duration of overtime of all employees in a solution
Undertime undertime_runs_count Number of working days with the total planned time less than the total available time
Undertime duration undertime_duration_s Total undertime duration
Available working days used_man_days / available_man_days Number of days with planned routes / Total number of available days for planning

Please note the planning results:

  • If the number of planned routes used_man_days is significantly lower than the number of available days for planning available_man_days, try to reduce the number of employees on the routes or increase the number of locations.

  • The greater the value of Visit time utilization affecting_utilization and Total working time utilization general_utilization metrics, the more optimal routes are.

  • Locations of the base type aren't considered when calculating metrics. For more information about location types, see {#T}.

Map

1 : Visit and its sequential number in a route.

: Unassigned visit.

Viewing the solution

If you select a route on the map, it will be highlighted in the table. If you select a route in the table, it will be highlighted on the map. Similarly, when you select a point on the map, the corresponding location visit will be highlighted in the tables, and when you select a visit in the table, the corresponding point will be highlighted on the map.

You can also use the Search field to open a specific object. Select a location or route in the drop-down list, and it will be highlighted in the blocks. The search is performed by the following fields:

  • For visits (including unassigned visits)
    • Number
    • Name
    • Address
    • Comment
    • Tags (mandatory and optional)
    • Properties

Editing a solution

You can change the planning result:

Exclude a visit from the route

Drag the row from the Visits table to the Undistributed visits table.

Include an unassigned visit in the route

Tables: click the route in the table or on the map. Drag the row from the Undistributed visits table to the Visits table.

Map: drag the unassigned visit's map icon to the row of the target route.

Assign another employee to the route

Highlight an employee in the Routes table and click Replace employee. In the window that opens, choose an employee. If you need to replace an employee only on certain dates, specify the replacement period. By default, the entire period of the selected route is specified.

Move a visit from one route to another

Tables: drag an object from the Visits table to the Routes table in the row of the target route.

Map: drag the location visit's icon to the row of the target route.

To drag multiple items at once, hold the Ctrl key and select them.

Contact support