添加车队路径 (Network Analyst)

摘要

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

旧版本:
ArcGIS Pro 3.5 之前的版本中,此工具被称为添加车辆配送路径

使用情况

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

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

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

参数

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

将添加路径的车辆配送、最后一公里配送或废弃物收集分析图层。

Network Analyst Layer
路径数
(可选)

将添加的路径数量。

Long
路径名称前缀
(可选)

将添加至每条路径名称的限定符。 例如,路径名称前缀 WeekdayRoute 将用作每个路径名称的起始文本,并在其后附加递增的数字后缀(例如 WeekdayRoute1、WeekdayRoute2,以此类推)。

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
成本
(可选)

解决方案中路径可能产生的成本。

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

如果输入图层为废弃物收集图层,则此参数不适用且将被隐藏。

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

附件路径时间选项。

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

如果输入图层为废弃物收集图层,则此参数不适用且将被隐藏。

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

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

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

Boolean
日期和时间
(可选)

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

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

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

仅当输入图层为最后一公里配送图层时,此参数才适用。 如果输入图层具有不同的求解程序类型,则其将被隐藏。

Value Table
容量
(可选)

废弃物收集图层中路径的容量。

  • MaxBins_1 - 车辆在必须清空之前可以收集的 1 类废弃物垃圾桶的最大数量。
  • MaxWeight_1 - 车辆在必须清空之前可以收集的 1 类废弃物的最大物理重量。 只要针对所有重量字段均使用相同的单位,即可针对此值使用任何重量单位。
  • MaxVolume_1 - 车辆在必须清空之前可以收集的 1 类废弃物的最大体积。 只要针对所有体积字段均使用相同的单位,即可针对此值使用任何体积单位。
  • MaxBins_2 - 车辆在必须清空之前可以收集的 2 类废弃物垃圾桶的最大数量。
  • MaxWeight_2 - 车辆在必须清空之前可以收集的 2 类废弃物的最大物理重量。 只要针对所有重量字段均使用相同的单位,即可针对此值使用任何重量单位。
  • MaxVolume_2 - 车辆在必须清空之前可以收集的 2 类废弃物的最大体积。 只要针对所有体积字段均使用相同的单位,即可针对此值使用任何体积单位。

仅当输入图层为废弃物收集图层时,此参数才适用。 如果输入图层具有不同的求解程序类型,则其将被隐藏。

Value Table
开始时间
(可选)

废弃物收集图层的附加日期和时间属性。

  • 开始时间 - 该路径的开始时间。 如果未指定此属性,则路径将使用图层的默认开始时间。
  • 加班时间开始时间 - 开始计算加班时间之前的规定工作时间。 空值表示没有加班时间。 以输入图层的时间单位指定值。

虽然可以为开始时间属性同时指定日期和时间,但仅会使用时间部分。

仅当输入图层为废弃物收集图层时,此参数才适用。 如果输入图层具有不同的求解程序类型,则其将被隐藏。

Value Table
路径约束
(可选)

将对路径施加的限制,用于限制总时间和距离。

  • 最长总时间 - 允许的最大路径持续时间。 路径持续时间包括行驶时间以及在停靠点、站点和货物补给点的服务和等待时间。 以输入图层的时间单位指定值。
  • 最大总距离 - 路径允许的最大行驶距离。 以输入图层的距离单位指定值。

仅当输入图层为废弃物收集图层时,此参数才适用。 如果输入图层具有不同的求解程序类型,则其将被隐藏。

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

附件路径时间属性。

  • 起始站点服务时间 - 起始站点的服务时间。 该字段可用于为车辆装货所用的时间建立模型。
  • 结束站点服务时间 - 结束站点的服务时间。 该字段可用于为车辆卸货所用的时间建立模型。

仅当输入图层为废弃物收集图层时,此参数才适用。 如果输入图层具有不同的求解程序类型,则其将被隐藏。

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

将添加路径的车辆配送、最后一公里配送或废弃物收集分析图层。

Network Analyst Layer
number_of_routes
(可选)

将添加的路径数量。

Long
route_name_prefix
(可选)

将添加至每条路径名称的限定符。 例如,路径名称前缀 WeekdayRoute 将用作每个路径名称的起始文本,并在其后附加递增的数字后缀(例如 WeekdayRoute1、WeekdayRoute2,以此类推)。

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,...]
(可选)

解决方案中路径可能产生的成本。

  • 固定成本 - 仅当解决方案中使用路径(即,路径分配有停靠点)时才产生的固定货币成本。
  • 单位时间成本 - 路径总持续时间(包括行驶时间以及在停靠点、站点和休息点的服务时间和等待时间)中每单位工作时间产生的货币成本。 默认值为 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
waste_capacities
[waste_capacities,...]
(可选)

废弃物收集图层中路径的容量。

  • MaxBins_1 - 车辆在必须清空之前可以收集的 1 类废弃物垃圾桶的最大数量。
  • MaxWeight_1 - 车辆在必须清空之前可以收集的 1 类废弃物的最大物理重量。 只要针对所有重量字段均使用相同的单位,即可针对此值使用任何重量单位。
  • MaxVolume_1 - 车辆在必须清空之前可以收集的 1 类废弃物的最大体积。 只要针对所有体积字段均使用相同的单位,即可针对此值使用任何体积单位。
  • MaxBins_2 - 车辆在必须清空之前可以收集的 2 类废弃物垃圾桶的最大数量。
  • MaxWeight_2 - 车辆在必须清空之前可以收集的 2 类废弃物的最大物理重量。 只要针对所有重量字段均使用相同的单位,即可针对此值使用任何重量单位。
  • MaxVolume_2 - 车辆在必须清空之前可以收集的 2 类废弃物的最大体积。 只要针对所有体积字段均使用相同的单位,即可针对此值使用任何体积单位。

仅当输入图层为废弃物收集图层时,此参数才适用。 如果输入图层具有不同的求解程序类型,则将忽略该值。

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

废弃物收集图层的附加日期和时间属性。

  • 开始时间 - 该路径的开始时间。 如果未指定此属性,则路径将使用图层的默认开始时间。
  • 加班时间开始时间 - 开始计算加班时间之前的规定工作时间。 空值表示没有加班时间。 以输入图层的时间单位指定值。

可以使用 datetime.time 对象指定开始时间属性。

仅当输入图层为废弃物收集图层时,此参数才适用。 如果输入图层具有不同的求解程序类型,则将忽略该值。

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

将对路径施加的限制,用于限制总时间和距离。

  • 最长总时间 - 允许的最大路径持续时间。 路径持续时间包括行驶时间以及在停靠点、站点和货物补给点的服务和等待时间。 以输入图层的时间单位指定值。
  • 最大总距离 - 路径允许的最大行驶距离。 以输入图层的距离单位指定值。

仅当输入图层为废弃物收集图层时,此参数才适用。 如果输入图层具有不同的求解程序类型,则将忽略该值。

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

附件路径时间属性。

  • 起始站点服务时间 - 起始站点的服务时间。 该字段可用于为车辆装货所用的时间建立模型。
  • 结束站点服务时间 - 结束站点的服务时间。 该字段可用于为车辆卸货所用的时间建立模型。

仅当输入图层为废弃物收集图层时,此参数才适用。 如果输入图层具有不同的求解程序类型,则将忽略该值。

Value Table

派生输出

名称说明数据类型
out_vrp_layer

更新的网络分析图层。

Network Analyst Layer

环境

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