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

摘要

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

使用情况

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

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

  • 要删除所有现有路径并创建新的路径,取消选中追加到现有路径参数复选框。

参数

标注说明数据类型
输入车辆配送图层

将添加路径的车辆配送分析图层。

Network Analyst Layer
路径数
(可选)

将添加的路径数量。

Long
路径名称前缀
(可选)

将添加至每个路径图层项目标题的限定符。 例如,路径名称前缀 WeekdayRoute 将用作每个路径名称的起始文本,并附加对象 ID(WeekdayRoute1、WeekdayRoute2 等)。

String
起始站点名称
(可选)

路径的起始站点名称。 如果该值为空,则路径会将分配的第一个停靠点作为起始点。 车辆的起始位置未知或者与问题不相关时,可以忽略起始站点。 但是,当该值为空时,则终止站点名称参数值不能同时为空。 如果停靠点或站点跨多个时区,则不允许使用虚拟起始站点。

String
终止站点名称
(可选)

路径的终止站点名称。 如果该值为空,则路径将在分配的最后一个停靠点处结束。 当该值为空时,则起始站点名称参数值不能同时为空。

String
最早开始时间
(可选)

路径允许的最早开始时间。

求解程序通过将该参数与起始站点的时间窗(在 Depots 图层中由 TimeWindowStart 字段提供)结合使用来确定可行的路径开始时间。 该参数的默认仅时间值是 800: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

派生输出

标注说明数据类型
输出车辆配送图层

更新的网络分析图层。

Network Analyst Layer

arcpy.management.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(WeekdayRoute1、WeekdayRoute2 等)。

String
start_depot_name
(可选)

路径的起始站点名称。 如果该值为空,则路径会将分配的第一个停靠点作为起始点。 车辆的起始位置未知或者与问题不相关时,可以忽略起始站点。 但是,当该值为空时,则终止站点名称参数值不能同时为空。 如果停靠点或站点跨多个时区,则不允许使用虚拟起始站点。

String
end_depot_name
(可选)

路径的终止站点名称。 如果该值为空,则路径将在分配的最后一个停靠点处结束。 当该值为空时,则起始站点名称参数值不能同时为空。

String
earliest_start_time
(可选)

路径允许的最早开始时间。

求解程序通过将该参数与起始站点的时间窗(在 Depots 图层中由 TimeWindowStart 字段提供)结合使用来确定可行的路径开始时间。 该参数的默认仅时间值是 800: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

更新的网络分析图层。

Network Analyst Layer

环境

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