添加车辆配送休息点 (Network Analyst)

摘要

在车辆配送 (VRP) 图层中创建休息点。

使用情况

  • 此工具会将行追加到 VRP 图层下的休息点子图层,并且可以同时将所有五个休息点添加到路径。如果所有路径的休息点时间相同,则可以一次将所有休息点添加到所有路径。

  • 如果未指定目标路径名称参数值,则会为每个现有路径创建休息点。

  • 要删除所有现有休息点并创建新的休息点,选中追加到现有路径参数复选框(在 Python 中为 append_to_existing_breaks = "CLEAR")。

  • 只能将一种类型的休息点添加到 VRP;不指定工具参数中其他类型的休息点值。

参数

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

将向其添加休息点的车辆配送分析图层。

Network Analyst Layer
目标路径名称
(可选)

休息点参数的路径。如果未指定此参数,则会为每个现有路径创建休息点。

String
休息点类型
(可选)

指定当前 VRP 图层的休息点类型。所有休息点的类型必须相同。

  • 时间窗休息点 休息将在特定时间窗内进行。这是默认设置。
  • 最长行驶时间中断 在经过一定的行驶时间后休息。这些值为到达第一个休息点之前或两个休息点之间的时间量。
  • 最长工作时间中断 累积一定时间后休息。这些值始终是自路径起点开始经历的时间。
String
休息点属性
(可选)

指定休息开始的时间范围。要设置时间窗休息点,请使用两个时间值。

休息点类型参数设置为时间窗休息点时,启用以下选项。

  • 已支付 - 用来指示是否为休息支付报酬的布尔值。
  • 休息点持续时间 - 休息的持续时间。该字段不能包含空值,其默认值为 60。
  • 时间窗开始 - 时间窗的开始时间。
  • 时间窗结束 - 时间窗的结束时间。
  • 最长冲突时间:该字段为时间窗休息点指定允许的最长冲突时间。如果到达时间不在该时间范围内,则认为与时间窗发生冲突。零值表示不能与时间窗发生冲突;即时间窗是硬性的。非零值表示最长延迟时间。例如,休息可在其时间窗结束后最多 30 分钟内开始,但会按照时间窗冲突重要性设置对延迟进行惩罚(该设置可评定遵循时间窗且不引起冲突的重要性)。

Value Table
休息点属性
(可选)

指定可在驾驶多长时间之后才需要休息。

休息点类型参数设置为最长行驶时间中断时,启用以下属性。

  • 已支付 - 用来指示是否为休息点支付报酬的布尔值。
  • 休息点持续时间 - 休息点的持续时间。该字段不能包含空值,其默认值为 60。
  • 最长行驶时间 - 休息之前可累积的最长行驶时间。行驶时间从上一个休息点的结束时间开始累积,或者从路径的起始点开始累积(如果还未休息过)。

    如果这是路径的最后一个休息点,则 MaxTravelTimeBetweenBreaks 字段还会指明从最后一个休息点到终止站点可累积的最长行驶时间。

    该字段将限制可在驾驶多长时间之后才需要休息。例如,如果分析的时间字段单位参数(Python 中的 time_units)设为分钟,而且 MaxTravelTimeBetweenBreaks 字段的值为 120,则司机将在驾驶两个小时之后中断驾驶以得到休息。如果要再驾驶两个小时后休息一次,则第二次休息的 MaxTravelTimeBetweenBreaks 字段值必须为 120。

    该字段值的单位由时间字段单位参数(Python 中的 time_units)指定。

Value Table
休息点属性
(可选)

指定可在工作多长时间之后才需要休息。

休息点类型参数设置为最长工作时间休息点时,启用以下属性。

  • 已支付 - 用来指示是否为休息点支付报酬的布尔值。
  • 休息点持续时间 - 休息点的持续时间。该字段不能包含空值,其默认值为 60。
  • 累积的最长工作时间 - 休息之前可累积的最长工作时间。工作时间始终从路径的起始点开始累积。工作时间等于行驶时间加上在停靠点、站点和休息点的服务时间。不过,此时间不包括等待时间,等待时间是指路径(或驾驶员)在停靠点或站点处等待时间窗打开所用的时间。

    MaxCumulWorkTime 字段也表示休息之前可累积的最长工作时间。

    该字段将限制可在工作多长时间之后才需要休息。例如,如果时间字段单位参数(Python 中的 time_units)设为分钟,而且 MaxCumulWorkTime 字段的值为 120,ServiceTime 字段的值为 15,则司机将在工作 2 个小时之后获得 15 分钟的休息时间。

    继续此示例来进行说明,假设工作了 3 个小时之后又需要休息。那么,要指定该休息点,需要输入 315(5 小时 15 分钟)作为第二个休息点的 MaxCumulWorkTime 字段值。这个数字包括前一个休息点的 MaxCumulWorkTime 值和 ServiceTime 字段值,以及准许进行第二次休息之前的另外 3 个小时工作时间。为避免过早经过最长工作时间休息点,应该记住:工作时间是从路径的起始点开始累积的,并且包括在之前访问的站点、停靠点和休息点处的服务时间。

Value Table
追加到现有休息点
(可选)

指定是否将新的休息点追加到现有的休息点属性表中。

  • 选中 - 新的休息点将追加到休息点属性表的现有集合中。这是默认设置。
  • 未选中 - 现有休息点将被替换为新的休息点。

Boolean

派生输出

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

更新的网络分析图层。

网络分析图层

arcpy.na.AddVehicleRoutingProblemBreaks(in_vrp_layer, {target_route}, {break_type}, {time_window_properties}, {travel_time_properties}, {work_time_properties}, {append_to_existing_breaks})
名称说明数据类型
in_vrp_layer

将向其添加休息点的车辆配送分析图层。

Network Analyst Layer
target_route
(可选)

休息点参数的路径。如果未指定此参数,则会为每个现有路径创建休息点。

String
break_type
(可选)

指定当前 VRP 图层的休息点类型。所有休息点的类型必须相同。

  • TIME_WINDOW_BREAK 休息将在特定时间窗内进行。这是默认设置。
  • MAXIMUM_TRAVEL_TIME_BREAK 在经过一定的行驶时间后休息。这些值为到达第一个休息点之前或两个休息点之间的时间量。
  • MAXIMUM_WORK_TIME_BREAK 累积一定时间后休息。这些值始终是自路径起点开始经历的时间。
String
time_window_properties
[time_window_properties,...]
(可选)

指定休息开始的时间范围。要设置时间窗休息点,请使用两个时间值。

休息点类型参数设置为时间窗休息点时,启用以下选项。

  • 已支付 - 用来指示是否为休息支付报酬的布尔值。
  • 休息点持续时间 - 休息的持续时间。该字段不能包含空值,其默认值为 60。
  • 时间窗开始 - 时间窗的开始时间。
  • 时间窗结束 - 时间窗的结束时间。
  • 最长冲突时间:该字段为时间窗休息点指定允许的最长冲突时间。如果到达时间不在该时间范围内,则认为与时间窗发生冲突。零值表示不能与时间窗发生冲突;即时间窗是硬性的。非零值表示最长延迟时间。例如,休息可在其时间窗结束后最多 30 分钟内开始,但会按照时间窗冲突重要性设置对延迟进行惩罚(该设置可评定遵循时间窗且不引起冲突的重要性)。

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

指定可在驾驶多长时间之后才需要休息。

休息点类型参数设置为最长行驶时间中断时,启用以下属性。

  • 已支付 - 用来指示是否为休息点支付报酬的布尔值。
  • 休息点持续时间 - 休息点的持续时间。该字段不能包含空值,其默认值为 60。
  • 最长行驶时间 - 休息之前可累积的最长行驶时间。行驶时间从上一个休息点的结束时间开始累积,或者从路径的起始点开始累积(如果还未休息过)。

    如果这是路径的最后一个休息点,则 MaxTravelTimeBetweenBreaks 字段还会指明从最后一个休息点到终止站点可累积的最长行驶时间。

    该字段将限制可在驾驶多长时间之后才需要休息。例如,如果分析的时间字段单位参数(Python 中的 time_units)设为分钟,而且 MaxTravelTimeBetweenBreaks 字段的值为 120,则司机将在驾驶两个小时之后中断驾驶以得到休息。如果要再驾驶两个小时后休息一次,则第二次休息的 MaxTravelTimeBetweenBreaks 字段值必须为 120。

    该字段值的单位由时间字段单位参数(Python 中的 time_units)指定。

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

指定可在工作多长时间之后才需要休息。

休息点类型参数设置为最长工作时间休息点时,启用以下属性。

  • 已支付 - 用来指示是否为休息点支付报酬的布尔值。
  • 休息点持续时间 - 休息点的持续时间。该字段不能包含空值,其默认值为 60。
  • 累积的最长工作时间 - 休息之前可累积的最长工作时间。工作时间始终从路径的起始点开始累积。工作时间等于行驶时间加上在停靠点、站点和休息点的服务时间。不过,此时间不包括等待时间,等待时间是指路径(或驾驶员)在停靠点或站点处等待时间窗打开所用的时间。

    MaxCumulWorkTime 字段也表示休息之前可累积的最长工作时间。

    该字段将限制可在工作多长时间之后才需要休息。例如,如果时间字段单位参数(Python 中的 time_units)设为分钟,而且 MaxCumulWorkTime 字段的值为 120,ServiceTime 字段的值为 15,则司机将在工作 2 个小时之后获得 15 分钟的休息时间。

    继续此示例来进行说明,假设工作了 3 个小时之后又需要休息。那么,要指定该休息点,需要输入 315(5 小时 15 分钟)作为第二个休息点的 MaxCumulWorkTime 字段值。这个数字包括前一个休息点的 MaxCumulWorkTime 值和 ServiceTime 字段值,以及准许进行第二次休息之前的另外 3 个小时工作时间。为避免过早经过最长工作时间休息点,应该记住:工作时间是从路径的起始点开始累积的,并且包括在之前访问的站点、停靠点和休息点处的服务时间。

Value Table
append_to_existing_breaks
(可选)

指定是否将新的休息点追加到现有的休息点属性表中。

  • APPEND新的休息点将被追加到休息点属性表的现有集合中。这是默认设置。
  • CLEAR现有休息点将被替换为新的休息点。
Boolean

派生输出

名称说明数据类型
out_vrp_layer

更新的网络分析图层。

网络分析图层

环境

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

许可信息

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

相关主题