Add Fleet Routing Routes (Network Analyst)

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

Dialog

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
Route Constraints (Optional)	The constraints that will be placed on routes to limit total time, total travel time, and total distance. 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. This parameter is not applicable and is hidden if the input layer is a waste collection layer.	Value Table
Costs (Optional)	The costs that may be incurred by the route in a solution. 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. The default is 1. 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. This parameter is not applicable and is hidden if the input layer is a waste collection layer.	Value Table
Additional Route Time (Optional)	Additional route time options. 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. This parameter is not applicable and is hidden if the input layer is a waste collection layer.	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. 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 null or 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. Although you can specify both a date and a time for the Earliest Route Start Date and Earliest Route Start Time properties, only the date portion is used for Earliest Route Start Date, and only the time portion is used for Earliest Route Start Time. 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
Capacities (Optional)	The capacities for routes in a waste collection layer. 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. 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
Start Time (Optional)	Additional date and time properties for a waste collection layer. 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. 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
Route Constraints (Optional)	The constraints that will be placed on routes to limit total time and distance. 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. 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
Additional Route Time (Optional)	Additional route time properties. 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. 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

Derived Output

Label	Explanation	Data Type
Output Vehicle Routing Problem Layer	The updated network analyst layer.	Network Analyst Layer

Python

arcpy.na.AddVehicleRoutingProblemRoutes(in_vrp_layer, {number_of_routes}, {route_name_prefix}, {start_depot_name}, {end_depot_name}, {earliest_start_time}, {latest_start_time}, {max_order_count}, {capacities}, {route_constraints}, {costs}, {additional_route_time}, {append_to_existing_routes}, {date_and_time}, {waste_capacities}, {start_time}, {route_time_distance_constraints}, {depot_service_time})

Name	Explanation	Data Type
in_vrp_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. The value is ignored 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 ignored 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 its value is ignored if the input layer is a waste collection layer.	Long
capacities [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 its value is ignored if the input layer is a waste collection layer.	Value Table
route_constraints [route_constraints,...] (Optional)	The constraints that will be placed on routes to limit total time, total travel time, and total distance. 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. This parameter is not applicable and its value is ignored if the input layer is a waste collection layer.	Value Table
costs [costs,...] (Optional)	The costs that may be incurred by the route in a solution. 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. The default is 1. 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. This parameter is not applicable and its value is ignored if the input layer is a waste collection layer.	Value Table
additional_route_time [additional_route_time,...] (Optional)	Additional route time options. 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. This parameter is not applicable and its value is ignored if the input layer is a waste collection layer.	Value Table
append_to_existing_routes (Optional)	Specifies whether new routes will be appended to the existing routes attribute table. APPEND—New routes will be appended to the existing set in the routes attribute table. This is the default. CLEAR—Existing routes will be deleted and replaced with new routes.	Boolean
date_and_time [date_and_time,...] (Optional)	Additional date and time properties for a last mile delivery layer. 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 null or 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. Specify the Earliest Route Start Date property using a datetime.date object and the Earliest Route Start Time property using a datetime.time object. This parameter is only applicable if the input layer is a last mile delivery layer. The value is ignored if the input layer has a different solver type.	Value Table
waste_capacities [waste_capacities,...] (Optional)	The capacities for routes in a waste collection layer. 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. This parameter is only applicable if the input layer is a waste collection layer. The value is ignored if the input layer has a different solver type.	Value Table
start_time [start_time,...] (Optional)	Additional date and time properties for a waste collection layer. 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. Specify the Start Time property using a datetime.time object. This parameter is only applicable if the input layer is a waste collection layer. The value is ignored if the input layer has a different solver type.	Value Table
route_time_distance_constraints [route_time_distance_constraints,...] (Optional)	The constraints that will be placed on routes to limit total time and distance. 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. This parameter is only applicable if the input layer is a waste collection layer. The value is ignored if the input layer has a different solver type.	Value Table
depot_service_time [depot_service_time,...] (Optional)	Additional route time properties. 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. This parameter is only applicable if the input layer is a waste collection layer. The value is ignored if the input layer has a different solver type.	Value Table

Derived Output

Name	Explanation	Data Type
out_vrp_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