ShipmentModel

string

使用者定義的出貨顯示名稱。長度上限為 63 個半形字元，可以使用 UTF-8 字元。

object (VisitRequest)

與出貨商品相關的自取替代方案。如未指定，車輛只需前往與送貨地點相應的位置。

object (VisitRequest)

與出貨商品相關的一組替代運送方式。如未指定，車輛只需前往與取貨地點相應的位置。

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

貨運的裝載需求 (例如重量、體積、棧板數量等)。對應中的鍵應為描述對應負載類型的 ID，最好也包含單位。例如：「weight_kg」、「volume_gallons」、「pallet_count」等。如果對應的鍵未顯示在對應中，系統會將相應的負載視為空值。

integer

可能執行這項出貨作業的車輛組合。如果留空，所有車輛都可以執行這項作業。車輛會依 ShipmentModel's 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 正規化，並使用 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 正規化，並使用 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 正規化，並使用 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 正規化，並使用 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))

車輛容量 (例如重量、體積、棧板數量)。地圖中的鍵是載入類型的 ID，與 Shipment.load_demands 欄位的鍵一致。如果這個對應中缺少特定鍵，對應的容量就會視為無限。

number

車輛成本：所有成本加總，且必須與 Shipment.penalty_cost 採用相同單位。

車輛路線的每小時費用。這項費用會計入路線的總耗時，包括行程時間、等待時間和拜訪時間。使用 costPerHour 而非 costPerTraveledHour 可能會導致額外延遲。

number

車輛路線每行駛一小時的費用。這項費用僅適用於路線的行程時間 (即 ShipmentRoute.transitions 中回報的時間)，不包括等待時間和拜訪時間。

number

車輛路線每公里的成本。這項費用會套用至 ShipmentRoute.transitions 中回報的距離，不會套用至從單一 VisitRequest 的 arrivalLocation 到 departureLocation 隱含移動的任何距離。

number

如果使用這輛車處理貨件，則會套用固定費用。

boolean

如果車輛的路線不包含任何貨物，則僅適用於車輛。指出車輛是否應視為二手車。

如果為真，車輛會從起點前往終點，即使沒有運送任何貨物，系統也會將起點到終點的行車時間和距離納入考量。

否則車輛不會從起點行駛至終點，且不會為這輛車排定 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 正規化，並使用 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 正規化，並使用 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

定義這些屬性適用的 (src->dst) 轉換集。

如果來源造訪或車輛啟動的 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

「第二個」事件的出貨索引。這個欄位必須指定。