ShipmentModel

string

用户定义的货件显示名称。最多可包含 63 个字符，可以使用 UTF-8 字符。

object (VisitRequest)

与相应配送相关联的一组自提替代方案。如果未指定，车辆只需前往与配送对应的位置。

object (VisitRequest)

与相应货件相关联的一组配送替代方案。如果未指定，车辆只需前往与上车点对应的位置。

map (key: string, value: object (Load))

货件的装载需求（例如重量、体积、托盘数量等）。映射中的键应为描述相应负载类型的标识符，最好还包含单位。例如：“weight_kg”“volume_gallons”“pallet_count”等。如果给定键未出现在映射中，则相应载荷将被视为 null。

integer

可能执行此货件运输的一组车辆。如果为空，则所有车辆都可以执行该操作。车辆由其在 ShipmentModel 的 vehicles 列表中的索引给出。

number

指定每辆车运送相应货件时产生的费用。如果指定，则必须具有以下任一值：

• 与 costsPerVehicleIndices 的元素数量相同。costsPerVehicle[i] 对应于相应型号的车辆 costsPerVehicleIndices[i]。
• 与模型中的车辆数量相同的元素数量。第 i 个元素对应于相应型号的第 i 辆车。

这些费用必须与 penaltyCost 的单位相同，且不得为负数。如果没有此类费用，请将此字段留空。

integer

costsPerVehicle 适用的车辆的索引。如果非空，则必须与 costsPerVehicle 具有相同数量的元素。车辆指数不得指定多次。如果车辆被排除在 costsPerVehicleIndices 之外，则其费用为零。

string (Duration format)

指定与从上车点到送达点的最短路径相比，最长的绝对绕行时间。如果指定，则必须为非负值，并且相应配送必须至少包含取件和送达。

例如，假设 t 是从所选自提替代方案直接前往所选送货替代方案所需的最短时间。然后，设置 pickupToDeliveryAbsoluteDetourLimit 会强制执行以下操作：

startTime(delivery) - startTime(pickup) <=
t + pickupToDeliveryAbsoluteDetourLimit

如果同一批货件同时指定了相对限制和绝对限制，则对于每个可能的取货/送货对，系统会使用限制性更强的限制。截至 2017 年 10 月，仅当出行时长不取决于车辆时，系统才支持绕行。

string (Duration format)

指定从取件开始到送达开始的货件最长时长。如果指定，则必须为非负值，并且相应配送必须至少包含取货和送货。这并不取决于为取货和送货选择的替代方案，也不取决于车辆速度。此参数可以与最大绕行限制一起指定：解决方案将同时遵守这两项规范。

string

非空字符串，用于指定相应货件的“类型”。此功能可用于定义 shipment_types 之间的不兼容性或要求（请参阅 ShipmentModel 中的 shipmentTypeIncompatibilities 和 shipmentTypeRequirements）。

与为单次访问指定的 visitTypes 不同：属于同一批次的所有取货/送货共用同一个 shipmentType。

string

指定相应货件的标签。此标签会在相应 ShipmentRoute.Visit 的 shipmentLabel 中报告。

boolean

如果为 true，则跳过相应配送，但不应用 penaltyCost。

如果模型中存在任何 shipmentTypeRequirements，忽略货件会导致验证错误。

允许忽略在 injectedFirstSolutionRoutes 或 injectedSolutionConstraint 中执行的货件；求解器会从执行路线中移除相关的取货/送货访问。引用被忽略货件的 precedenceRules 也会被忽略。

number

如果未完成配送，此罚款将添加到路线的总费用中。如果某个配送方案的取货和送货替代方案之一被访问，则该配送方案被视为已完成。费用可以采用与模型中所有其他费用相关字段相同的单位表示，并且必须为正数。

重要提示：如果未指定此罚款，则视为无限期，即必须完成发货。

number

指定与从上车点到送达点的最短路径相比，最长的相对绕行时间。如果指定，则必须为非负值，并且相应配送必须至少包含取件和送达。

例如，假设 t 是从所选自提替代方案直接前往所选送货替代方案所需的最短时间。然后，设置 pickupToDeliveryRelativeDetourLimit 会强制执行以下操作：

startTime(delivery) - startTime(pickup) <=
std::ceil(t * (1.0 + pickupToDeliveryRelativeDetourLimit))

如果同一批货件同时指定了相对限制和绝对限制，则对于每个可能的取货/送货对，系统会使用限制性更强的限制。截至 2017 年 10 月，仅当出行时长不取决于车辆时，系统才支持绕行。

object (LatLng)

执行此 VisitRequest 时车辆到达的地理位置。如果配送模型具有时长距离矩阵，则不得指定 arrivalLocation。

object (Waypoint)

执行此 VisitRequest 时车辆到达的途经点。如果配送模型具有时长距离矩阵，则不得指定 arrivalWaypoint。

object (LatLng)

车辆在完成此 VisitRequest 后出发的地理位置。如果与 arrivalLocation 相同，则可以省略。如果配送模型具有时长距离矩阵，则不得指定 departureLocation。

object (Waypoint)

车辆在完成此 VisitRequest 后出发的途经点。如果与 arrivalWaypoint 相同，则可以省略。如果配送模型具有时长距离矩阵，则不得指定 departureWaypoint。

string

指定附加到访问请求的标记。不允许使用空字符串或重复的字符串。

object (TimeWindow)

限制访问到达时间的时间窗口。请注意，车辆可能会在到达时间窗口之外出发，也就是说，到达时间 + 时长不必在时间窗口内。如果车辆在 TimeWindow.start_time 之前到达，则可能会产生等待时间。

如果不存在 TimeWindow，则表示车辆可以在任意时间执行此访问。

时间窗口必须是不相交的，也就是说，任何时间窗口都不得与其他时间窗口重叠或相邻，并且必须按递增顺序排列。

只有当时间窗口为单个时，才能设置 costPerHourAfterSoftEndTime 和 softEndTime。

string (Duration format)

访问时长，即车辆从到达到离开之间所花费的时间（将添加到可能的等待时间；请参阅 timeWindows）。

number

在车辆路线中服务此访问请求的费用。您可以使用此子属性为每次替代性取货或送货支付不同的费用。此费用必须与 Shipment.penalty_cost 的单位相同，且不得为负数。

map (key: string, value: object (Load))

加载相应访问请求的需求。这与 Shipment.load_demands 字段类似，只不过它仅适用于此 VisitRequest，而不是整个 Shipment。此处列出的需求会添加到 Shipment.load_demands 中列出的需求中。

string

指定访问的类型。这可用于分配车辆完成此访问所需的额外时间（请参阅 Vehicle.extra_visit_duration_for_visit_type）。

一种类型只能出现一次。

string

为相应 VisitRequest 指定标签。此标签在响应中以相应 ShipmentRoute.Visit 中的 visitLabel 形式报告。

boolean

指定是否应避免在此位置的驾车路线中掉头。系统会尽力避免掉头，但无法保证完全避免。这是一项实验性功能，其行为可能会发生变化。

实验性功能：如需了解详情，请参阅 https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request。

number

纬度（以度为单位）。它必须在 [-90.0, +90.0] 范围内。

number

经度（以度为单位）。它必须在 [-180.0, +180.0] 范围内。

boolean

可选。表示此航点的位置旨在让车辆优先停靠在道路的特定一侧。设置此值后，路线将经过相应位置，以便车辆停在道路中心偏向该位置的一侧。此选项不适用于“步行”出行模式。

boolean

表示该航点是供车辆停靠的地点，目的是接载或送达乘客。此选项仅适用于“DRIVING”出行模式，且仅当“locationType”为“location”时有效。

实验性：此字段的行为或存在性将来可能会发生变化。

object (Location)

使用地理坐标指定的点，包括可选的朝向。

string

与途经点关联的 POI 地点 ID。

使用地点 ID 指定 VisitRequest 的到达或出发地点时，请使用足够具体的地点 ID 来确定前往该地点的导航 LatLng 位置。例如，表示建筑物的地点 ID 是合适的，但表示道路的地点 ID 不建议使用。

object (LatLng)

途经点的地理坐标。

integer

与交通流量方向相关的罗盘航向。此值用于指定上下车时要使用的道路一侧。航向值可以介于 0 到 360 之间，其中 0 表示正北方向，90 表示正东方向，依此类推。

string (Timestamp format)

硬性时间窗口的开始时间。如果未指定，则设置为 ShipmentModel.global_start_time。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

string (Timestamp format)

硬性时间窗口结束时间。如果未指定，则设置为 ShipmentModel.global_end_time。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

string (Timestamp format)

时间窗口的软开始时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

string (Timestamp format)

时间窗口的软结束时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

number

如果活动发生在 softStartTime 之前，则添加到模型中其他费用的每小时费用，计算方式如下：

   max(0, softStartTime - t.seconds)
                          * costPerHourBeforeSoftStartTime / 3600,
t being the time of the event.

此费用必须为正数，并且只有在设置了 softStartTime 时才能设置此字段。

number

如果事件发生在 softEndTime 之后，则添加到模型中其他费用的每小时费用，计算方式如下：

   max(0, t.seconds - softEndTime.seconds)
                    * costPerHourAfterSoftEndTime / 3600,
t being the time of the event.

此费用必须为正数，并且只有在已设置 softEndTime 的情况下才能设置此字段。

string

用户定义的车辆显示名称。最多可包含 63 个字符，可以使用 UTF-8 字符。

enum (TravelMode)

出行模式，会影响车辆可行驶的道路及其行驶速度。另请参阅 travelDurationMultiple。

object (RouteModifiers)

一组要满足的条件，这些条件会影响给定车辆的路线计算方式。

object (LatLng)

车辆在取货前开始行驶的地理位置。如果未指定，车辆将从第一个上车点开始。如果配送模型具有时长和距离矩阵，则不得指定 startLocation。

object (Waypoint)

表示车辆在取货前开始行驶的地理位置的途经点。如果既未指定 startWaypoint，也未指定 startLocation，则车辆从第一个上车点开始。如果配送模型具有时长和距离矩阵，则不得指定 startWaypoint。

object (LatLng)

车辆在完成最后一次 VisitRequest 后停靠的地理位置。如果未指定，车辆的 ShipmentRoute 会在完成最后一次 VisitRequest 后立即结束。如果配送模型具有时长和距离矩阵，则不得指定 endLocation。

object (Waypoint)

表示车辆在完成最后一次 VisitRequest 后停止的地理位置的途经点。如果未指定 endWaypoint 和 endLocation，则车辆在完成最后一次 VisitRequest 后立即结束 ShipmentRoute。如果配送模型具有时长和距离矩阵，则不得指定 endWaypoint。

string

指定附加到车辆路线起点的标记。

不允许使用空字符串或重复的字符串。

string

指定附加到车辆路线末尾的标记。

不允许使用空字符串或重复的字符串。

object (TimeWindow)

车辆可以从起始地点出发的时间段。它们必须在全局时间限制内（请参阅 ShipmentModel.global_* 字段）。如果未指定，则除了全局时间限制之外，没有其他限制。

属于同一重复字段的时间窗口必须是不相交的，即任何时间窗口都不能与另一个时间窗口重叠或相邻，并且它们必须按时间顺序排列。

只有当时间窗口为单个时，才能设置 costPerHourAfterSoftEndTime 和 softEndTime。

object (TimeWindow)

车辆可能到达最终位置的时间窗口。它们必须在全局时间限制内（请参阅 ShipmentModel.global_* 字段）。如果未指定，则除了全局时间限制之外，没有其他限制。

属于同一重复字段的时间窗口必须是不相交的，即任何时间窗口都不能与另一个时间窗口重叠或相邻，并且它们必须按时间顺序排列。

只有当时间窗口为单个时，才能设置 costPerHourAfterSoftEndTime 和 softEndTime。

enum (UnloadingPolicy)

在车辆上强制执行的卸货政策。

map (key: string, value: object (LoadLimit))

车辆的载重能力（例如重量、体积、托盘数量）。映射中的键是加载类型的标识符，与 Shipment.load_demands 字段的键一致。如果此映射中缺少某个给定的键，则相应容量会被视为无限。

number

车辆费用：所有费用加起来必须与 Shipment.penalty_cost 的单位相同。

车辆路线的每小时费用。此费用适用于路线的总耗时，包括行程时间、等待时间和访问时间。使用 costPerHour 而不是仅使用 costPerTraveledHour 可能会导致额外的延迟时间。

number

车辆路线每小时的行驶费用。此费用仅适用于路线所用的行程时间（即 ShipmentRoute.transitions 中报告的时间），不包括等待时间和拜访时间。

number

车辆路线的每公里费用。此费用适用于 ShipmentRoute.transitions 中报告的距离，不适用于从单个 VisitRequest 的 arrivalLocation 到 departureLocation 隐式行进的任何距离。

number

如果使用相应车辆处理货件，则应用固定费用。

boolean

此字段仅适用于路线不包含任何货件的车辆。它用于指明在这种情况下是否应将车辆视为二手车。

如果为 true，则车辆会从起点前往终点，即使它不运送任何货物，并且会考虑从起点到终点的行驶所产生的时间和距离成本。

否则，它不会从起始位置行驶到结束位置，并且不会为该车辆安排任何 breakRule 或延迟（来自 TransitionAttributes）。在这种情况下，车辆的 ShipmentRoute 除了车辆索引和标签之外，不包含任何信息。

object (DurationLimit)

适用于车辆路线总时长的限制。在给定的 OptimizeToursResponse 中，车辆的路线时长是其 vehicleEndTime 与 vehicleStartTime 之间的差值。

object (DurationLimit)

应用于车辆路线的行驶时限。在给定的 OptimizeToursResponse 中，路线的行驶时长是所有 transitions.travel_duration 的总和。

object (DistanceLimit)

应用于车辆路线总距离的限制。在给定的 OptimizeToursResponse 中，路线距离是所有 transitions.travel_distance_meters 的总和。

map (key: string, value: string (Duration format))

指定从 visitTypes 字符串到时长的映射。时长是指在具有指定 visitTypes 的访问中，除了 VisitRequest.duration 之外还要花费的时间。如果指定了 costPerHour，则此额外访问时长会增加费用。键（即 visitTypes）不能是空字符串。

如果预约请求包含多种类型，系统会在地图中为每种类型添加时长。

object (BreakRule)

描述要在此车辆上强制执行的休息时间表。如果为空，则不会为相应车辆安排休息时间。

string

指定相应车辆的标签。此标签在响应中报告为相应 ShipmentRoute 的 vehicleLabel。

boolean

如果为 true，则 usedIfRouteIsEmpty 必须为 false，并且相应车辆将保持未使用状态。

如果某项配送任务由 injectedFirstSolutionRoutes 中被忽略的车辆执行，则该任务会在第一个解决方案中跳过，但可以在响应中自由执行。

如果某项配送任务由 injectedSolutionConstraint 中被忽略的车辆执行，并且任何相关的取货/送货任务都受限于只能由该车辆执行（即，未放宽到级别 RELAX_ALL_AFTER_THRESHOLD），则该配送任务会在响应中被跳过。如果某批货件的 allowedVehicleIndices 字段不为空，但所有允许的车辆都被忽略，则该货件会在响应中被跳过。

number

指定一个乘法系数，可用于增加或减少相应车辆的出行时间。例如，将此值设置为 2.0 表示相应车辆速度较慢，行程时间是标准车辆的两倍。此倍数不会影响访问时长。如果指定了 costPerHour 或 costPerTraveledHour，则会影响费用。此值必须在 [0.001, 1000.0] 范围内。如果未设置，则表示车辆为标准车辆，相应倍数视为 1.0。

警告：应用此倍数后，但在执行任何数值运算之前，出行时间将四舍五入到最接近的秒数，因此，较小的倍数可能会导致精度损失。

另请参阅下文中的 extraVisitDurationForVisitType。

boolean

指定是否在合理的情况下避开收费公路。系统会优先选择不包含收费公路的路线。仅适用于机动出行方式。

boolean

指定是否在合理的情况下避开高速公路。系统会优先选择不包含高速公路的路线。仅适用于机动出行方式。

boolean

指定是否在合理的情况下避开轮渡。系统会优先选择不包含渡轮行程的路线。仅适用于机动出行方式。

boolean

可选。指定是否在合理的情况下避免室内导航。系统会优先选择不包含室内导航的路线。仅适用于 WALKING 出行模式。

string (int64 format)

负载的软性限制。请参阅 costPerUnitAboveSoftMax。

number

如果车辆在行驶路线上的载重超过 softMaxLoad，则会产生以下费用罚款（每辆车仅一次）：（载重 - softMaxLoad）* costPerUnitAboveSoftMax。所有费用加起来必须与 Shipment.penalty_cost 的单位相同。软限制只能针对在整个模型中仅适用于自提或仅适用于送货的类型进行定义。

object (Interval)

车辆在路线开始时的可接受载荷区间。

object (Interval)

路线结束时车辆的可接受装载间隔。

string (int64 format)

可接受的最大负荷量。

object (LoadCost)

此车辆每移动一单位负载一公里的费用。这可用作燃料消耗量的代理变量：如果负荷是重量（以牛顿为单位），则负荷*千米的维度为能量。

实验性功能：如需了解详情，请参阅 https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request。

object (LoadCost)

此车辆每小时每单位负载的行驶费用。

实验性功能：如需了解详情，请参阅 https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request。

string (int64 format)

可接受的最低负荷。必须大于等于 0。如果同时指定了这两个值，则 min 必须 ≤ max。

string (int64 format)

最大可接受的负荷。必须大于等于 0。如果未指定，则此消息不会限制最大负载。如果同时指定了这两个值，则 min 必须 ≤ max。

string (int64 format)

负载量，当负载量超过此值时，移动单位负载的费用将从 costPerUnitBelowThreshold 变为 costPerUnitAboveThreshold。必须大于等于 0。

number

移动一个单位的负载的费用，对于介于 0 和阈值之间的每个单位。必须是有限值，且大于等于 0。

number

每单位高于阈值的负载的移动成本。在阈值为 0 的特殊情况下，这是每单位的固定费用。必须是有限值，且大于等于 0。

string (Duration format)

一种硬性限制，将时长限制为最多 maxDuration。

string (Duration format)

一种软性限制，不会强制执行时长上限，但如果违反此限制，路线会产生费用。此费用会与模型中定义的其他费用相加，单位相同。

如果已定义，softMaxDuration 必须为非负数。如果还定义了 maxDuration，则 softMaxDuration 必须小于 maxDuration。

string (Duration format)

一种软性限制，不会强制执行时长上限，但如果违反此限制，路线会产生费用，费用与时长呈二次方关系。此费用会与模型中定义的其他费用相加，单位相同。

如果设置了 quadraticSoftMaxDuration，则必须满足以下条件：

• 必须为非负数。
• 必须定义 maxDuration。
• quadraticSoftMaxDuration 必须小于 maxDuration。
• 差值不得超过一天：maxDuration - quadraticSoftMaxDuration <= 86400 seconds

number

如果违反 softMaxDuration 阈值，则每小时产生的费用。如果时长低于阈值，则额外费用为 0；否则，费用取决于时长，如下所示：

  costPerHourAfterSoftMax * (duration - softMaxDuration)

费用必须是非负数。

number

如果违反 quadraticSoftMaxDuration 阈值，则产生的每平方小时费用。

如果时长低于阈值，则额外费用为 0；否则，费用取决于时长，如下所示：

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

费用必须是非负数。

string (int64 format)

一种硬性限制，用于将距离限制为最多 maxMeters。限值必须是非负数。

string (int64 format)

一种不强制执行最大距离限制的软限制，但如果违反该限制，则会产生费用，该费用会与其他在模型中定义的费用相加，单位相同。

如果定义了 softMaxMeters，则该值必须小于 maxMeters 且必须为非负数。

number

每公里费用（最高可达 softMaxMeters），计算公式如下：

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

routeDistanceLimit 不支持此费用。

number

如果距离超过 softMaxMeters 限制，则每公里产生的费用。如果距离低于限值，则额外费用为 0；否则，用于计算费用的公式如下：

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

费用必须是非负数。

object (BreakRequest)

休息顺序。查看 BreakRequest 消息。

object (FrequencyConstraint)

可能需要使用多个 FrequencyConstraint。这些要求必须全部由相应 BreakRule 的 BreakRequest 满足。请参阅 FrequencyConstraint。

string (Timestamp format)

必需。休止开始时间的下限（含）。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

string (Timestamp format)

必需。休止开始时间的上限（含）。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

string (Duration format)

必需。休息时长的下限。必须为正值。

string (Duration format)

必需。相应限制条件的最短休息时长。非负。请参阅 FrequencyConstraint 的说明。

string (Duration format)

必需。路线中任何时间段的最大允许跨度，该时间段不包含至少部分 duration >= minBreakDuration 的休息时间。必须为正值。

enum (Type)

目标的类型。

number

相应目标相对于其他目标的权重。可以是任何非负数，权重不必总和为 1。权重默认为 1.0。

object (Row)

指定时长和距离矩阵的行。它必须具有与 ShipmentModel.duration_distance_matrix_src_tags 相同的元素数量。

string

用于定义相应时长和距离矩阵适用于哪些车辆的标记。如果为空，则此设置适用于所有车辆，并且只能有一个矩阵。

每次车辆启动都必须与一个矩阵完全匹配，也就是说，车辆启动的 startTags 字段必须与一个矩阵（且仅与一个矩阵）的 vehicleStartTag 相匹配。

所有矩阵的 vehicleStartTag 都必须不同。

string (Duration format)

相应行的时长值。它必须具有与 ShipmentModel.duration_distance_matrix_dst_tags 相同的元素数量。

number

相应行的距离值。如果模型中没有任何费用或限制涉及距离，则可将此参数留空；否则，此参数必须包含与 durations 相同数量的元素。

string

用于定义这些属性所适用的（来源->目的地）过渡的标记。

当来源访问或车辆启动的 VisitRequest.tags 或 Vehicle.start_tags 包含 srcTag 或不包含 excludedSrcTag 时（具体取决于这两个字段中哪个不为空），来源访问或车辆启动即匹配。

string

请参阅 srcTag。srcTag 和 excludedSrcTag 中必须且只能有一个不为空。

string

当目的地访问或车辆行程结束的 VisitRequest.tags 或 Vehicle.end_tags 包含 dstTag 或不包含 excludedDstTag 时（具体取决于这两个字段中哪个不为空），即表示匹配。

string

请参阅 dstTag。dstTag 和 excludedDstTag 中必须且只能有一个不为空。

number

指定执行此转换的费用。此费用与模型中的所有其他费用采用相同的单位，且不得为负值。它是在所有其他现有费用的基础上收取的。

number

指定在执行此过渡时，按行驶距离计算的每公里费用。它会添加车辆上指定的所有 Vehicle.cost_per_kilometer。

object (DistanceLimit)

指定执行此过渡时行驶的距离限制。

截至 2021 年 6 月，仅支持软限制。

string (Duration format)

指定执行此过渡时产生的延迟。

此延迟始终发生在完成来源访问之后和开始目标访问之前。

string

不兼容的类型列表。如果两个货件的所列 shipment_types 不同，则这两个货件“不兼容”。

enum (IncompatibilityMode)

应用于不兼容性的模式。

string

dependentShipmentTypes 所需的替代配送类型列表。

string

如果某批货件的类型在 dependentShipmentTypes 字段中指定，则必须在同一路线中访问至少一批类型为 requiredShipmentTypeAlternatives 的货件。

注意：不允许出现 shipmentType 依赖于自身的依赖链。

enum (RequirementMode)

应用于要求的模式。

boolean

表示“第一个”事件是否为交付。

boolean

指示“第二个”事件是否为交付。

string (Duration format)

“第一个”事件与“第二个”事件之间的偏移量。可以为负数。

integer

“第一个”事件的货件指数。必须指定此字段。

integer

“第二个”事件的货件指数。必须指定此字段。