Skip to main content

Add Fleet Routing Routes (Network Analyst Tools)

Summary

Creates routes in a vehicle routing problem, last mile delivery, or waste collection analysis layer. This tool will append rows to the Routes sublayer and can add rows with specific settings while creating a unique name field.

Legacy:

This tool was named Add Vehicle Routing Problem Routes in versions earlier than ArcGIS Pro 3.5.

Usage

  • The tool adds routes to the Routes sublayer with unique names starting with the Route Name Prefix parameter value.

  • The Start Depot Name and End Depot Name parameter values are based on the names in the Depots sublayer.

  • To delete all existing routes and create new routes, uncheck the Append To Existing Routes parameter.

Parameters

Label Explanation Data type

Input Vehicle Routing Problem Layer

The  vehicle routing problem, last mile delivery, or waste collection analysis layer to which routes will be added.

Network Analyst Layer

Number of Routes

(Optional)

The number of routes that will be added.

Long

Route Name Prefix

(Optional)

A qualifier that will be added to the name of every route. For example, a route name prefix of WeekdayRoute would be used as the starting text for every route's name with an incrementing numerical suffix appended to it (for example, WeekdayRoute1, WeekdayRoute2, and so on).

String

Start Depot Name

(Optional)

The name of the starting depot for the route.

If this value is null, the route will begin from the first order assigned. Omitting the start depot is useful when the vehicle's starting location is unknown or irrelevant to the problem.

For vehicle routing problem layers, when this value is null, the End Depot Name parameter value cannot also be null. Both start and end depots can be null for last mile delivery and waste collection layers.

Virtual start depots are not allowed if orders or depots are in multiple time zones.

String

End Depot Name

(Optional)

The name of the ending depot for the route.

If this value is null, the route will end at the last order assigned.

For vehicle routing problem layers, when this value is null, the Start Depot Name parameter value cannot also be null. Both start and end depots can be null for last mile delivery and waste collection layers.

String

Earliest Start Time

(Optional)

The earliest allowable start time for the route in a vehicle routing problem layer.

This parameter is used by the solver in conjunction with the time window of the starting depot provided in the Depots sublayer by the TimeWindowStart field for determining feasible route start times. This parameter has a default time-only value of 8:00:00 a.m., which is interpreted as 8:00:00 a.m. on the date provided by the Default Date property of the analysis layer. If no value is specified, the default value is used.

This parameter is only applicable if the input layer is a vehicle routing problem layer. It is hidden if the input layer has a different solver type.

Date

Latest Start Time

(Optional)

The latest allowable start time for the route in a vehicle routing problem layer.

This parameter has a default time-only value of 10:00:00 a.m., which is interpreted as 10:00:00 a.m. on the date provided by the Default Date property of the analysis layer. If no value is specified, the default value is used.

This parameter is only applicable if the input layer is a vehicle routing problem layer. It is hidden if the input layer has a different solver type.

Date

Max Order Count

(Optional)

The maximum allowable number of orders on the route. The default value is 30 for vehicle routing problem layers and null for last mile delivery layers. If no value is specified, the default value is used.

This parameter is not applicable and is hidden if the input layer is a waste collection layer.

Long

Capacities

(Optional)

The maximum amount (volume, weight, quantity, and so on) that can be carried by the vehicle. A null value is the same as zero. A maximum of nine capacity fields are allowed, but use only the number necessary to model the needs of the vehicles.

This parameter is not applicable and is hidden if the input layer is a waste collection layer.

Value table columns:

  • Capacity_1—The first capacity field.

  • Capacity_2—The second capacity field.

  • Capacity_3—The third capacity field.

  • Capacity_4—The fourth capacity field.

  • Capacity_5—The fifth capacity field.

  • Capacity_6—The sixth capacity field.

  • Capacity_7—The seventh capacity field.

  • Capacity_8—The eight capacity field.

  • Capacity_9—The nine capacity field.

Value Table

Route Constraints

(Optional)

The constraints that will be placed on routes to limit total time, total travel time, and total distance.

This parameter is not applicable and is hidden if the input layer is a waste collection layer.

Value table columns:

  • Max Total Time—The maximum allowable route duration. The route duration includes travel times as well as service and wait times at orders, depots, and breaks. Specify the value in the input layer's time units.

  • Max Total Travel Time—The maximum allowable travel time for the route. The travel time includes only the time spent driving on the network and does not include service or wait times. This field value can't be larger than the MaxTotalTime field value. Specify the value in the input layer's time units.

  • Max Total Distance—The maximum allowable travel distance for the route. Specify the value in the input layer's distance units.

Value Table

Costs

(Optional)

The costs that may be incurred by the route in a solution.

This parameter is not applicable and is hidden if the input layer is a waste collection layer.

Value table columns:

  • Fixed Cost—A fixed monetary cost that is incurred only if the route is used in a solution (that is, it has orders assigned to it).

  • Cost Per Unit Time—The monetary cost incurred per unit of work time for the total route duration, including travel times and service and wait times at orders, depots, and breaks.

  • Cost Per Unit Distance—The monetary cost incurred per unit of distance traveled for the route length (total travel distance).

  • Overtime Start Time—The duration of regular work time before overtime computation begins.

  • Cost Per Unit Overtime—The monetary cost incurred per time unit of overtime work. This field can contain null values; a null value indicates that the Cost Per Unit Overtime value is the same as the Cost Per Unit Time value.

Value Table

Additional Route Time

(Optional)

Additional route time options.

This parameter is not applicable and is hidden if the input layer is a waste collection layer.

Value table columns:

  • Start Depot Service Time—The service time at the starting depot. This can be used to model the time spent loading the vehicle.

  • End Depot Service Time—The service time at the ending depot. This can be used to model the time spent unloading the vehicle.

  • Arrive/Depart Delay—The amount of travel time needed to accelerate the vehicle to normal travel speeds, decelerate it to a stop, and move it off and on the network (for example, in and out of parking). By including an Arrive/Depart Delay value, the solver is deterred from sending many routes to service physically coincident orders.

Value Table

Append To Existing Routes

(Optional)

Specifies whether new routes will be appended to the existing routes attribute table.

  • Checked—New routes will be appended to the existing set in the routes attribute table. This is the default.

  • Unchecked—Existing routes will be deleted and replaced with new routes.

Boolean

Date and Time

(Optional)

Additional date and time properties for a last mile delivery layer.

This parameter is only applicable if the input layer is a last mile delivery layer. It is hidden if the input layer has a different solver type.

Value table columns:

  • Earliest Route Start Date—The earliest start date for added routes. If this property is not specified, the routes will use the layer's default earliest route start date.

  • Earliest Route Start Time—The earliest start time of day for added routes. If this property is not specified, the routes will use the layer's default earliest route start time.

  • Route Start Flexibility—Indicates how long after the earliest allowed route start time the route can start. The value can be zero, which means that there is no flexibility in the starting time, or a positive number. Specify the value in the input layer's time units.

Value Table

Capacities

(Optional)

The capacities for routes in a waste collection layer.

This parameter is only applicable if the input layer is a waste collection layer. It is hidden if the input layer has a different solver type.

Value table columns:

  • MaxBins_1—The maximum number of waste bins for fraction 1 that the vehicle can collect before it must be emptied.

  • MaxWeight_1—The maximum physical weight for fraction 1 that the vehicle can collect before it must be emptied. Any weight units can be used for this value as long as the same units are used for all weight fields.

  • MaxVolume_1—The maximum volume for fraction 1 that the vehicle can collect before it must be emptied. Any volume units can be used for this value as long as the same units are used for all volume fields.

  • MaxBins_2—The maximum number of waste bins for fraction 2 that the vehicle can collect before it must be emptied.

  • MaxWeight_2—The maximum physical weight for fraction 2 that the vehicle can collect before it must be emptied. Any weight units can be used for this value as long as the same units are used for all weight fields.

  • MaxVolume_2—The maximum volume for fraction 2 that the vehicle can collect before it must be emptied. Any volume units can be used for this value as long as the same units are used for all volume fields.

Value Table

Start Time

(Optional)

Additional date and time properties for a waste collection layer.

Although you can specify both a date and a time for the Start Time property, only the time portion is used.

This parameter is only applicable if the input layer is a waste collection layer. It is hidden if the input layer has a different solver type.

Value table columns:

  • Start Time—The starting time for the route. If this property is not specified, the routes will use the layer's default start time.

  • Overtime Start Time—The duration of regular work time before overtime computation begins. A null value indicates that overtime does not apply. Specify the value in the input layer's time units.

Value Table

Route Constraints

(Optional)

The constraints that will be placed on routes to limit total time and distance.

This parameter is only applicable if the input layer is a waste collection layer. It is hidden if the input layer has a different solver type.

Value table columns:

  • Max Total Time—The maximum allowable route duration. The route duration includes travel times as well as service and wait times at stops, depots, and renewals. Specify the value in the input layer's time units.

  • Max Total Distance—The maximum allowable travel distance for the route. Specify the value in the input layer's distance units.

Value Table

Additional Route Time

(Optional)

Additional route time properties.

This parameter is only applicable if the input layer is a waste collection layer. It is hidden if the input layer has a different solver type.

Value table columns:

  • Start Depot Service Time—The service time at the starting depot. This can be used to model the time spent loading the vehicle.

  • End Depot Service Time—The service time at the ending depot. This can be used to model the time spent unloading the vehicle.

Value Table

Derived output

Label Explanation Data type

Output Vehicle Routing Problem Layer

The updated network analyst layer.

Network Analyst Layer

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes