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

摘要

可用于在车辆配送 (VRP) 图层最后一公里配送图层中创建路径。 该工具会将行追加到 Routes 子图层,并可以在创建唯一名称字段时添加具有特定设置的行。

使用情况

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

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

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

参数

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

将添加路径的车辆配送或最后一公里配送分析图层。

Network Analyst Layer
路径数
(可选)

将添加的路径数量。

Long
路径名称前缀
(可选)

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

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 解决方案中路径可能产生的成本。

  • 固定成本 - 仅当解决方案中使用路径(即,路径分配有停靠点)时才产生的固定货币成本。
  • 单位时间成本 - 路径总持续时间(包括行驶时间以及在停靠点、站点和休息点的服务时间和等待时间)中每单位工作时间产生的货币成本。 默认值为 1。
  • 单位距离成本 - 在路径长度(总行驶距离)上行驶单位距离产生的货币成本。
  • 加班时间开始时间 - 开始计算加班时间之前的规定工作时间。
  • 单位加班时间成本 - 每单位加班工作时间产生的货币成本。 该字段可以包含空值;空值表示单位加班时间成本值与单位时间成本值相同。

Value Table
附加路径时间
(可选)

附件路径时间选项。

  • 起始站点服务时间 - 起始站点的服务时间。 该字段可用于为车辆装货所用的时间建立模型。
  • 结束站点服务时间 - 结束站点的服务时间。 该字段可用于为车辆卸货所用的时间建立模型。
  • 到达/离开延迟 - 将车辆加速到正常行驶速度、减速到停止状态以及离开和进入网络(例如,出入停车场)所需的行驶时间。 通过包含到达/离开延迟值,可防止求解程序发送多条路径来为完全重合的停靠点提供服务。

Value Table
追加到现有路径
(可选)

指定是否将新的路径追加到现有路径属性表中。

  • 选中 - 新的路径将追加到路径属性表的现有集合中。 这是默认设置。
  • 未选中 - 现有路径将被删除并替换为新路径。

Boolean
日期和时间
(可选)

最后一公里配送图层的附加日期和时间选项。

  • 最早路径开始日期 - 已添加路径的最早开始日期。 如果未指定此属性,则路径将使用图层的默认最早路径开始日期。
  • 最早路径开始时间 - 已添加路径的最早开始时间。 如果未指定此属性,则路径将使用图层的默认最早路径开始时间。
  • 路径开始灵活性 - 指示允许路径开始的最早开始时间之后的时间量。 此值可以是空值、零值(表示开始时间没有灵活性)或正数。 以输入图层的时间单位指定值。

虽然可以同时为最早路径开始日期最早路径开始时间属性指定日期和时间,但日期部分仅用于最早路径开始日期,时间部分仅用于最早路径开始时间

如果输入图层为车辆配送图层,则此参数不适用且将被隐藏。

Value Table

派生输出

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

更新的网络分析图层。

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}, {date_and_time})
名称说明数据类型
in_vrp_layer

将添加路径的车辆配送或最后一公里配送分析图层。

Network Analyst Layer
number_of_routes
(可选)

将添加的路径数量。

Long
route_name_prefix
(可选)

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

String
start_depot_name
(可选)

路径的起始站点名称。

如果该值为空,则路径会将分配的第一个停靠点作为起始点。 车辆的起始位置未知或者与问题不相关时,可以忽略起始站点。

对于车辆配送图层,如果该值为空,则 end_depot_name 参数值不能同时为空。 对于最后一公里配送图层,起始站点和终止站点可同时为空。

如果停靠点或站点跨多个时区,则不允许使用虚拟起始站点。

String
end_depot_name
(可选)

路径的终止站点名称。

如果该值为空,则路径将在分配的最后一个停靠点处结束。

对于车辆配送图层,如果该值为空,则 start_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 解决方案中路径可能产生的成本。

  • 固定成本 - 仅当解决方案中使用路径(即,路径分配有停靠点)时才产生的固定货币成本。
  • 单位时间成本 - 路径总持续时间(包括行驶时间以及在停靠点、站点和休息点的服务时间和等待时间)中每单位工作时间产生的货币成本。 默认值为 1。
  • 单位距离成本 - 在路径长度(总行驶距离)上行驶单位距离产生的货币成本。
  • 加班时间开始时间 - 开始计算加班时间之前的规定工作时间。
  • 单位加班时间成本 - 每单位加班工作时间产生的货币成本。 该字段可以包含空值;空值表示单位加班时间成本值与单位时间成本值相同。

Value Table
additional_route_time
[additional_route_time,...]
(可选)

附件路径时间选项。

  • 起始站点服务时间 - 起始站点的服务时间。 该字段可用于为车辆装货所用的时间建立模型。
  • 结束站点服务时间 - 结束站点的服务时间。 该字段可用于为车辆卸货所用的时间建立模型。
  • 到达/离开延迟 - 将车辆加速到正常行驶速度、减速到停止状态以及离开和进入网络(例如,出入停车场)所需的行驶时间。 通过包含到达/离开延迟值,可防止求解程序发送多条路径来为完全重合的停靠点提供服务。

Value Table
append_to_existing_routes
(可选)

指定是否将新的路径追加到现有路径属性表中。

  • APPEND新的路径将追加到路径属性表的现有集合中。 这是默认设置。
  • CLEAR现有路径将被删除并替换为新路径。
Boolean
date_and_time
[date_and_time,...]
(可选)

最后一公里配送图层的附加日期和时间选项。

  • 最早路径开始日期 - 已添加路径的最早开始日期。 如果未指定此属性,则路径将使用图层的默认最早路径开始日期。
  • 最早路径开始时间 - 已添加路径的最早开始时间。 如果未指定此属性,则路径将使用图层的默认最早路径开始时间。
  • 路径开始灵活性 - 指示允许路径开始的最早开始时间之后的时间量。 此值可以是空值、零值(表示开始时间没有灵活性)或正数。 以输入图层的时间单位指定值。

可以使用 datetime.date 对象指定最早路径开始日期属性,使用 datetime.time 对象指定最早路径开始时间属性。

如果输入图层为车辆配送图层,则此参数不适用并且将忽略其值。

Value Table

派生输出

名称说明数据类型
out_vrp_layer

更新的网络分析图层。

Network Analyst Layer

环境

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