添加车队路径休息点 (Network Analyst)

摘要

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

旧版本：

此工具在 ArcGIS Pro 3.5 之前名为添加车辆配送休息点。

使用情况

• 此工具可将行追加到车辆配送图层的 Breaks 子图层。

• 一次只能添加一种类型的休息点，但可在一次工具运行中添加多个相同类型的休息点。 保留与未指定的其他类型的休息点相关联的参数。

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

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

参数

对话框

标注	说明	数据类型
输入车辆配送图层	将向其添加休息点的车辆配送分析图层。	Network Analyst Layer
目标路径名称 (可选)	将应用休息点的路径。 如果未提供值，则会为每个现有路径创建休息点。	String
休息点类型 (可选)	指定将添加的休息点类型。 时间窗休息点—休息点将在特定时间窗期间发生。 这是默认设置。 最长行驶时间休息点—休息点将在特定行驶时间量之后发生。 这些是第一个休息点之前的时间量或休息点之间的时间量。 最长工作时间休息点—休息点将在特定累积时间量之后发生。 这些值是从路径开始起经过的时间量。	String
休息点属性 (可选)	指定休息点开始时间的时间范围。 要设置时间窗休息点，可使用两个一天中的时间值。 当休息点类型参数设置为时间窗休息点时，启用下方属性。 付费 - 指示是否为休息支付报酬的布尔值。 休息持续时间 - 休息点的持续时间，采用图层时间字段单位属性的单位。 该属性不能包含空值，其默认值为 60。 时间窗开始 - 时间窗的开始时间。 时间窗结束 - 时间窗的结束时间。 最长冲突时间 - 时间窗休息点的允许的最长冲突时间（以图层时间字段单位属性的单位表示）。 如果到达时间不在该时间范围内，则认为与时间窗发生冲突。 零值表示不能与时间窗发生冲突；即时间窗是硬性的。 非零值表示最长延迟时间。 例如，休息点可以在时间窗结束后最多 30 分钟内开始，但延迟会根据时间窗重要性设置受到惩罚，该设置用于评估遵守时间窗而不造成冲突的重要性。	Value Table
休息点属性 (可选)	指定休息点成为必须之前人员可以驾驶多长时间。 当休息点类型参数设置为最长行驶时间休息点时，启用下方属性。 付费 - 指示是否为休息支付报酬的布尔值。 休息持续时间 - 休息点的持续时间，采用图层时间字段单位属性的单位。 该属性不能包含空值，其默认值为 60。 休息点之间的最长行驶时间 - 采用休息点之前可以累积的最长行驶时间量，采用图层时间字段单位属性的单位。 行驶时间从上一个休息点的结束时间开始累积，或者从路径的起始点开始累积（如果还未休息过）。 如果这是路径的最后一个休息点，则 MaxTravelTimeBetweenBreaks 字段还表示从最后一个休息点到终止站点可累积的最长行驶时间。 该字段用于限制可在驾驶多长时间之后才需要休息。 例如，如果时间字段单位属性设置为分钟，而且 MaxTravelTimeBetweenBreaks 字段的值为 120，则驾驶员将在驾驶两个小时之后开始休息。 如果要行驶多个小时后再休息一次，则第二个休息点的 MaxTravelTimeBetweenBreaks 字段值必须为 120。	Value Table
休息点属性 (可选)	指定可在工作多长时间之后才需要下一个休息点。 当休息点类型参数设置为最长工作时间休息点时，启用下方属性。 付费 - 指示是否为休息支付报酬的布尔值。 休息持续时间 - 休息点的持续时间，采用图层时间字段单位属性的单位。 该属性不能包含空值，其默认值为 60。 最长累积工作时间 - 采用休息点之前可以累积的最长工作时间量，采用图层时间字段单位属性的单位。 工作时间从路径的起始点开始累积。 工作时间等于行驶时间加上在停靠点、站点和休息点的服务时间。 但是，这不包括等待时间，等待时间是指路径（或驾驶员）在停靠点或站点处等待时间窗打开所用的时间。 MaxCumulWorkTime 字段还指示休息之前可累积的最长工作时间。 该字段用于限制可在工作多长时间之后才需要休息。 例如，如果时间字段单位参数（Python 中的 time_units）设置为分钟，且 MaxCumulWorkTime 字段的值为 120，ServiceTime 字段的值为 15，则驾驶员将在工作 2 个小时之后获得 15 分钟的休息时间。 继续以此示例来进行说明，假设工作了 3 个小时之后又需要休息。 那么，要指定该休息点，需要输入 315（5 小时 15 分钟）作为第二个休息点的 MaxCumulWorkTime 字段值。 这个数字包括前一个休息点的 MaxCumulWorkTime 和 ServiceTime 字段的值，以及准许进行第二次休息之前的另外 3 个小时工作时间。 为避免过早经过最长工作时间休息点，请牢记工作时间是从路径的起始点开始累积，并且包括在之前访问的站点、停靠点和休息点处的服务时间。	Value Table
追加到现有休息点 (可选)	指定是否将新休息点追加到现有休息点属性表中。 选中 - 新休息点将追加到休息点属性表中的现有集合。 这是默认设置。 未选中 - 现有休息点将替换为新休息点。	Boolean

派生输出

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

Python

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 (可选)	指定将添加的休息点类型。 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 字段还表示从最后一个休息点到终止站点可累积的最长行驶时间。 该字段用于限制可在驾驶多长时间之后才需要休息。 例如，如果时间字段单位属性设置为分钟，而且 MaxTravelTimeBetweenBreaks 字段的值为 120，则驾驶员将在驾驶两个小时之后开始休息。 如果要行驶多个小时后再休息一次，则第二个休息点的 MaxTravelTimeBetweenBreaks 字段值必须为 120。	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	更新的网络分析图层。	Network Analyst Layer

环境

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

许可信息

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