添加车辆配送路径 (Network Analyst)

摘要

在 Vehicle Routing Problem (VRP) 图层中创建路径。该工具会将行追加到 Routes 子图层，并可以在创建唯一名称字段时添加具有特定设置的行。

使用情况

• 该工具会将路径添加到具有以（以 路径名称前缀参数值为开头的唯一名称的 VRP 图层。

• 起始站点名称和终止站点名称参数值均基于 Depots 图层中的名称。

• 要删除所有现有路径并创建新的路径，选中追加到现有路径参数复选框（在 Python 中为 append_to_existing_routes = "CLEAR"）。

参数

对话框

标注	说明	数据类型
输入车辆配送图层	将添加路径的车辆配送分析图层。	Network Analyst Layer
路径数 (可选)	要添加的路径数。	Long
路径名称前缀 (可选)	添加至每个路径图层项目标题的限定符。例如，路径名称前缀 WeekdayRoute 将用作每个路径名称的起始文本，并附加对象 ID。	String
起始站点名称 (可选)	路径的起始站点的名称。如果起始站点名称值为空，则路径会将分配的第一个停靠点作为起始点。车辆的起始位置未知或者与您的问题不相关时，可以忽略起始站点。但是，当起始站点名称值为空时，则终止站点名称值不能同时为空。如果停靠点或站点跨多个时区，则不允许使用虚拟起始站点。	String
终止站点名称 (可选)	路径的终止站点名称。如果终止站点名称值为空，则路径将在分配的最后一个停靠点处结束。当终止站点名称值为空时，则起始站点名称值不能同时为空。	String
最早开始时间 (可选)	路径允许的最早开始时间。 求解程序通过将该参数与起始站点的时间窗（在 Depots 图层中由 TimeWindowStart 提供）结合使用来确定可行的路径开始时间。该参数的默认仅时间值是 8:00:00 a.m.，解释为分析层的 Default Date 属性给定的日期的上午 8:00:00。如果未指定任何值，则将使用默认值。	Date
最晚开始时间 (可选)	路径允许的最晚开始时间。该参数的默认仅时间值是 10:00:00 a.m.，解释为分析层的 Default Date 属性提供的日期的上午 10:00:00。如果未指定任何值，则将使用默认值。	Date
最大停靠点计数 (可选)	路径上允许的最大停靠点数。默认值为 30。如果未指定任何值，则将使用默认值。	Long
容量 (可选)	车辆的最大装载量（体积、重量、数量等）。空值等于零。最多允许 9 个容量字段，但仅使用对车辆需求进行建模所需的数量。	Value Table
路径约束 (可选)	对路径施加的限制，用于限制总时间、总行驶时间和总距离。 最长总时间 - 允许的最大路径持续时间。路径持续时间包括行驶时间以及在停靠点、站点和休息点的服务和等待时间。 最大总行驶时间 - 路径允许的最大行驶时间。行驶时间只包括在网络上行驶时所用的时间，不包括服务或等待时间。该字段值不能大于 MaxTotalTime 字段值。 最大总距离 - 路径允许的最大行驶距离。	Value Table
成本 (可选)	VRP 解决方案中路径产生的成本。 固定成本 - 仅当解决方案中使用路径（即，路径分配有停靠点）时才产生的固定货币成本。 单位时间成本 - 路径总持续时间（包括行驶时间以及在停靠点、站点和休息点的服务时间和等待时间）中每单位工作时间产生的货币成本。 单位距离成本 - 在路径长度（总行驶距离）上行驶单位距离产生的货币成本。 加班时间开始时间 - 开始计算加班时间之前的规定工作时间。 单位加班时间成本 - 每单位加班工作时间产生的货币成本。该字段可以包含空值；空值表示单位加班时间成本值与单位时间成本值相同。	Value Table
附加路径时间 (可选)	附件路径时间选项。 起始站点服务时间 - 起始站点的服务时间。该字段可用于为车辆装货所用的时间建立模型。 结束站点服务时间 - 结束站点的服务时间。该字段可用于为车辆卸货所用的时间建立模型。 到达/离开延迟 - 将车辆加速到正常行驶速度、减速到停止状态以及离开和进入网络（例如，出入停车场）所需的行驶时间。通过包含到达/离开延迟值，可防止 VRP 求解程序发送多条路径来为完全重合的停靠点提供服务。	Value Table
追加到现有路径 (可选)	指定是否将新的路径追加到现有路径属性表中。 选中 - 新的路径将追加到路径属性表的现有集合中。这是默认设置。 未选中 - 现有路径将被删除并替换为新路径。	Boolean

派生输出

标注	说明	数据类型
输出车辆配送图层	更新的网络分析图层。	网络分析图层

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})

名称	说明	数据类型
in_vrp_layer	将添加路径的车辆配送分析图层。	Network Analyst Layer
number_of_routes (可选)	要添加的路径数。	Long
route_name_prefix (可选)	添加至每个路径图层项目标题的限定符。例如，路径名称前缀 WeekdayRoute 将用作每个路径名称的起始文本，并附加对象 ID。	String
start_depot_name (可选)	路径的起始站点的名称。如果起始站点名称值为空，则路径会将分配的第一个停靠点作为起始点。车辆的起始位置未知或者与您的问题不相关时，可以忽略起始站点。但是，当起始站点名称值为空时，则终止站点名称值不能同时为空。如果停靠点或站点跨多个时区，则不允许使用虚拟起始站点。	String
end_depot_name (可选)	路径的终止站点名称。如果终止站点名称值为空，则路径将在分配的最后一个停靠点处结束。当终止站点名称值为空时，则起始站点名称值不能同时为空。	String
earliest_start_time (可选)	路径允许的最早开始时间。 求解程序通过将该参数与起始站点的时间窗（在 Depots 图层中由 TimeWindowStart 提供）结合使用来确定可行的路径开始时间。该参数的默认仅时间值是 8:00:00 a.m.，解释为分析层的 Default Date 属性给定的日期的上午 8:00:00。如果未指定任何值，则将使用默认值。	Date
latest_start_time (可选)	路径允许的最晚开始时间。该参数的默认仅时间值是 10:00:00 a.m.，解释为分析层的 Default Date 属性提供的日期的上午 10:00:00。如果未指定任何值，则将使用默认值。	Date
max_order_count (可选)	路径上允许的最大停靠点数。默认值为 30。如果未指定任何值，则将使用默认值。	Long
capacities [capacities,...] (可选)	车辆的最大装载量（体积、重量、数量等）。空值等于零。最多允许 9 个容量字段，但仅使用对车辆需求进行建模所需的数量。	Value Table
route_constraints [route_constraints,...] (可选)	对路径施加的限制，用于限制总时间、总行驶时间和总距离。 最长总时间 - 允许的最大路径持续时间。路径持续时间包括行驶时间以及在停靠点、站点和休息点的服务和等待时间。 最大总行驶时间 - 路径允许的最大行驶时间。行驶时间只包括在网络上行驶时所用的时间，不包括服务或等待时间。该字段值不能大于 MaxTotalTime 字段值。 最大总距离 - 路径允许的最大行驶距离。	Value Table
costs [costs,...] (可选)	VRP 解决方案中路径产生的成本。 固定成本 - 仅当解决方案中使用路径（即，路径分配有停靠点）时才产生的固定货币成本。 单位时间成本 - 路径总持续时间（包括行驶时间以及在停靠点、站点和休息点的服务时间和等待时间）中每单位工作时间产生的货币成本。 单位距离成本 - 在路径长度（总行驶距离）上行驶单位距离产生的货币成本。 加班时间开始时间 - 开始计算加班时间之前的规定工作时间。 单位加班时间成本 - 每单位加班工作时间产生的货币成本。该字段可以包含空值；空值表示单位加班时间成本值与单位时间成本值相同。	Value Table
additional_route_time [additional_route_time,...] (可选)	附件路径时间选项。 起始站点服务时间 - 起始站点的服务时间。该字段可用于为车辆装货所用的时间建立模型。 结束站点服务时间 - 结束站点的服务时间。该字段可用于为车辆卸货所用的时间建立模型。 到达/离开延迟 - 将车辆加速到正常行驶速度、减速到停止状态以及离开和进入网络（例如，出入停车场）所需的行驶时间。通过包含到达/离开延迟值，可防止 VRP 求解程序发送多条路径来为完全重合的停靠点提供服务。	Value Table
append_to_existing_routes (可选)	指定是否将新的路径追加到现有路径属性表中。 APPEND—新的路径将追加到路径属性表的现有集合中。这是默认设置。 CLEAR—现有路径将被删除并替换为新路径。	Boolean

派生输出

名称	说明	数据类型
out_vrp_layer	更新的网络分析图层。	网络分析图层

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是