- JSON 表示法
- Shipment
- VisitRequest
- LatLng
- Waypoint
- Location
- TimeWindow
- 車輛
- TravelMode
- UnloadingPolicy
- LoadLimit
- 間隔
- DurationLimit
- DistanceLimit
- BreakRule
- BreakRequest
- FrequencyConstraint
- DurationDistanceMatrix
- 列
- TransitionAttributes
- ShipmentTypeIncompatibility
- IncompatibilityMode
- ShipmentTypeRequirement
- RequirementMode
- PrecedenceRule
運送模型包含一組運送作業,必須由一組車輛執行,同時盡可能降低整體成本,也就是下列項目的總和:
- 車輛路線的費用 (所有車輛的總交通時間、平均交通時間、固定費用)。
- 未完成出貨的處罰。
- 運送作業全球作業期間的成本
JSON 表示法 |
---|
{ "shipments": [ { object ( |
欄位 | |
---|---|
shipments[] |
必須在模型中執行的一組貨運組合。 |
vehicles[] |
可用於執行拜訪的車輛組合。 |
globalStartTime |
模型的全球開始和結束時間:系統不會將範圍外的時間視為有效時間。 模型的時間跨度不得超過一年,也就是 使用 RFC3339 世界標準時間「Zulu」格式的時間戳記,解析度以奈秒為單位,小數點後最多 9 位。範例: |
globalEndTime |
如未設定,1971 年 1 月 1 日世界標準時間 00:00:00 (也就是秒數:31536000,nanos: 0) 會做為預設值。 RFC3339 世界標準時間「Zulu」格式的時間戳記,解析度以奈秒為單位,小數點後最多 9 位。範例: |
globalDurationCostPerHour |
整體企劃書的「全球持續時間」,是指所有車輛最早生效開始時間與最晚有效結束時間之間的差距。舉例來說,使用者可以為該數量設定每小時費用,以針對最快完成的工作進行最佳化。這個成本必須與 |
durationDistanceMatrices[] |
指定模型中使用的持續時間和距離矩陣。如果這個欄位空白,系統會根據 使用範例:
|
durationDistanceMatrixSrcTags[] |
定義時間長度和距離矩陣的來源的標記; 標記會對應至 |
durationDistanceMatrixDstTags[] |
定義時間和距離矩陣目的地的標記; 標記對應至 |
transitionAttributes[] |
新增至模型的轉場屬性。 |
shipmentTypeIncompatibilities[] |
不相容的 shipment_types 組合 (請參閱 |
shipmentTypeRequirements[] |
一組 |
precedenceRules[] |
模型中必須強制執行的優先順序規則集。 |
maxActiveVehicles |
限制可運作的車輛數量上限。如果路線至少執行一次貨運,表示車輛正在行駛中。在駕駛人數少於車輛數量,且車隊車輛種類不一的情況下,您可以使用這個選項限制路線數量。系統就會選取最適合的車輛子集。必須為正值。 |
運送地址
單一商品的運送作業,從其中一個提貨地點到其中一個送達地點。每輛車都必須前往其中一個上車地點 (並視情況調降空間) 至貨運地點,才能順利將貨物視為出貨。
JSON 表示法 |
---|
{ "displayName": string, "pickups": [ { object ( |
欄位 | |
---|---|
displayName |
使用者定義的運送顯示名稱。長度上限為 63 個半形字元,可以使用 UTF-8 字元。 |
pickups[] |
與出貨相關的取貨替代選項組合。如果未指定,車輛只需前往與送貨地點相對應的位置即可。 |
deliveries[] |
與出貨相關的提交替代方案。如果未指定,車輛只需前往與乘客上車地點相對應的位置即可。 |
loadDemands |
裝載貨物的負載需求 (例如重量、體積、貨架數量等)。圖中的鍵應為說明對應負載類型的 ID,最好也包含單位。例如:"weight_kg"、"volume_gallons"、"pallet_count" 等。如果指定的鍵未顯示在對應的載入中,系統會將該載入視為空值。 這個物件中包含 |
allowedVehicleIndices[] |
可能執行這項運送作業的車輛組合。如果留空,則所有車輛都可能執行該動作。車輛會依據 |
costsPerVehicle[] |
指定每輛車出貨時的運費。如果已指定,則必須具備下列其中一種條件:
這些費用必須與 |
costsPerVehicleIndices[] |
適用 |
pickupToDeliveryAbsoluteDetourLimit |
指定從上車到貨運之間的最短路徑等待時間。如果指定了這個值,則必須為非負值,且運送作業至少必須包含一個取件和一個送達作業。 舉例來說,如果從選定的取貨替代服務直接改為配送至所選配送方式,最早需要多久時間才能處理完畢。接著設定
如果同一運送屬性同時指定了相對和絕對限制,則每個取貨/外送組合使用的限制越多。自 2017 年 10 月起,系統只會在行程時間不受車輛影響時支援繞道。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
pickupToDeliveryTimeLimit |
指定從開始取貨到出貨到貨之間的最長時間。若有指定,其必須為非負數,且運送必須包含至少一項取貨和送貨服務。這不會影響取貨方式,或選擇取貨和送貨的替代地點,以及車輛速度。您可以與最大繞道限制一起指定這項設定:解決方案將遵循這兩種規格。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
shipmentType |
指定這個貨品的「type」為非空白字串。這項功能可用於定義 與 |
label |
指定此貨品的標籤。這個標籤會在對應 |
ignore |
如果為 True,則略過這項出貨作業,但不會套用 如果模型中含有任何 系統允許忽略在 |
penaltyCost |
如果無法完成運送,這筆罰款會加到路線的整體費用中。如果消費者造訪了自行選擇的上車地點和替代貨品,系統就會將包裹視為完成運送。費用可以使用模型中所有其他費用相關欄位使用的單位來表示,且必須為正值。 重要事項:如未指明這項處分,系統會將其視為無限期,也就是必須完成出貨。 |
pickupToDeliveryRelativeDetourLimit |
指定從上車地點到貨品送達的最短路徑,最長的相對繞路時間。若有指定,其必須為非負數,且運送必須包含至少一項取貨和送貨服務。 舉例來說,假設 t 是從所選取的取貨替代方案直接前往所選取的送貨替代方案所需的最短時間。接著,設定
如果同一運送屬性同時指定了相對和絕對限制,則每個取貨/外送組合使用的限制越多。截至 2017 年 10 月 10 日為止,只有交通時間不需乘車時,系統才會支援繞道時間。 |
VisitRequest
可要求搭乘由車輛完成的造訪要求:有地理位置 (或兩個如下所示)、以時間範圍表示的開業和打烊時間,以及服務持續時間 (車輛抵達上車或下車後花費的時間)。
JSON 表示法 |
---|
{ "arrivalLocation": { object ( |
欄位 | |
---|---|
arrivalLocation |
執行這個 |
arrivalWaypoint |
車輛執行這項 |
departureLocation |
車輛完成這項 |
departureWaypoint |
完成這個 |
tags[] |
指定附加至造訪要求的標記。字串不得留空或重複。 |
timeWindows[] |
限製造訪時的抵達時間的時間範圍。請注意,車輛可能會在抵達時間回溯期過後離開,也就是說,抵達時間 + 車程時間不一定會在回溯期內。如果車輛在 如果沒有 時間區間必須不重疊,也就是說,每個時間區間都不得與其他時間區間重疊或相鄰,且必須依遞增順序排列。 只有在單一時間範圍內,才能設定 |
duration |
造訪所需時間,例如車輛抵達和離開之間經過的時間 (可計入可能的等待時間;請參閱 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
cost |
針對車輛路線提出造訪要求的費用。你可以使用這項功能,為每項貨物的替代取貨或配送服務支付不同的費用。這個成本必須與 |
loadDemands |
載入此造訪要求的需求。這與 這個物件中包含 |
visitTypes[] |
指定造訪類型。這項資訊可用於分配車輛完成這次拜訪所需的額外時間 (請參閱 一個類型只能出現一次。 |
label |
指定這個「 |
avoidUTurns |
指定這個位置的行車路線是否應避開迴轉。迴轉迴轉是盡可能避免的,但不保證能完全避免。這是實驗功能,行為可能會有所變動。 |
LatLng
代表經緯度組合的物件。以一對雙精準數表示經度度數和緯度度數。除非另有指定,否則這個物件必須符合 WGS84 標準。此外,值必須在正規化範圍內。
JSON 表示法 |
---|
{ "latitude": number, "longitude": number } |
欄位 | |
---|---|
latitude |
緯度度數,必須介於 [-90.0, +90.0] 的範圍之間。 |
longitude |
經度度數,必須介於 [-180.0, +180.0] 的範圍之間。 |
途經點
封裝路線控點。路線控點會標示 VisitRequests 的抵達和出發地點,以及車輛的起點和終點。
JSON 表示法 |
---|
{ "sideOfRoad": boolean, // Union field |
欄位 | |
---|---|
sideOfRoad |
選用設定。表示這個路線控點的位置,是為了讓車輛偏好停靠在道路的特定側邊。設定這個值後,路線就會通過位置,這樣車輛就能在路側停靠,該位置是從道路中心偏離位置。這個選項不適用於「WALKING」交通方式。 |
聯集欄位 location_type 。以不同方式表示地點。location_type 只能是下列其中一項: |
|
location |
使用地理座標指定的點,包括選用的標頭。 |
placeId |
與路標相關聯的 POI 地點 ID。 |
位置
包含位置 (地理位置和選用標題)。
JSON 表示法 |
---|
{
"latLng": {
object ( |
欄位 | |
---|---|
latLng |
航點的地理座標。 |
heading |
與車流方向相關聯的指南針方向。這個值用於指定接送和下車地點的道路兩側。方向值的範圍為 0 到 360,其中 0 指定正北方向,90 指定正東方向,以此類推。 |
TimeWindow
時間窗可限制事件的時間,例如造訪的抵達時間,或車輛的開始和結束時間。
硬性時間範圍邊界 startTime
和 endTime
會強制執行事件的最早和最晚時間,例如 startTime <= event_time <=
endTime
。軟性時間回溯期的下限 softStartTime
表示事件發生時機應在 softStartTime
當天或之後,發生時間與事件發生前軟性開始時間的時間間隔成正比。電子時間範圍上限 softEndTime
表示在 softEndTime
當天或之前發生事件的偏好,其費用與 softEndTime
事件發生後的時間長度成正比。startTime
、endTime
、softStartTime
和 softEndTime
應在全球時間限制內 (請參閱 ShipmentModel.global_start_time
和 ShipmentModel.global_end_time
),並應遵守下列規定:
0 <= `startTime` <= `endTime` and
0 <= `startTime` <= `softStartTime` and
0 <= `softEndTime` <= `endTime`.
JSON 表示法 |
---|
{ "startTime": string, "endTime": string, "softStartTime": string, "softEndTime": string, "costPerHourBeforeSoftStartTime": number, "costPerHourAfterSoftEndTime": number } |
欄位 | |
---|---|
startTime |
硬性時段開始時間。如果未指定,則會設為 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。範例: |
endTime |
硬性時間範圍的結束時間。如果未指定,則會設為 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。範例: |
softStartTime |
時間範圍的正規開始時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。範例: |
softEndTime |
時間範圍的虛假結束時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
costPerHourBeforeSoftStartTime |
如果事件發生時間早於 softStartTime,系統會將每小時費用加進模型中的其他費用,計算方式如下:
費用必須為正數,且必須先設定 softStartTime 才能設定欄位。 |
costPerHourAfterSoftEndTime |
如果事件發生在
費用必須為正數,且只有在已設定 |
車輛
模擬出貨問題中的車輛。解決運送問題時,系統會為這輛車輛建立從 startLocation
到 endLocation
的路線。路線是一系列造訪記錄 (請參閱 ShipmentRoute
)。
JSON 表示法 |
---|
{ "displayName": string, "travelMode": enum ( |
欄位 | |
---|---|
displayName |
使用者定義的車輛顯示名稱。長度上限為 63 個半形字元,可以使用 UTF-8 字元。 |
travelMode |
行駛模式會影響車輛可行駛的道路和速度。另請參閱 |
startLocation |
車輛開始載運貨物的地理位置。如未指定,車輛會在第一次上車時開始。如果運送模型包含時間長度和距離矩陣,則不得指定 |
startWaypoint |
路徑點代表車輛在取件前出發的地理位置。如果未指定 |
endLocation |
車輛在最後一次完成 |
endWaypoint |
路線點代表車輛在最後一次完成 |
startTags[] |
指定車輛路線起點所附加的標記。 字串不得留空或重複。 |
endTags[] |
指定附加在車輛路線結尾的標記。 不得使用空字串或重複的字串。 |
startTimeWindows[] |
車輛可能從起點出發的時間範圍。必須在全球時間限制範圍內 (請參閱 屬於相同重複欄位的時間範圍必須不重疊,也就是說,任何時間範圍都不能與其他時間範圍重疊或相鄰,且必須按時間順序排列。 只有單一時段才能設定 |
endTimeWindows[] |
車輛抵達目的地所需的時間範圍。必須在全球時間限制範圍內 (請參閱 屬於相同重複欄位的時間範圍必須不重疊,也就是說,任何時間範圍都不能與其他時間範圍重疊或相鄰,且必須按時間順序排列。 只有在單一時間範圍內,才能設定 |
unloadingPolicy |
已對車輛強制執行卸載政策。 |
loadLimits |
車輛的容量 (例如重量、體積、貨架數量)。對應中的鍵是載入類型的 ID,與 這個物件中包含 |
costPerHour |
車輛費用:所有費用都會加總,且必須與 車輛路線的每小時費用。這筆費用適用於該路線總共花費的時間,而且包含交通時間、等待時間和造訪時間。使用 |
costPerTraveledHour |
車輛路線的每小時行駛費用。這項費用只會套用在路線的行程時間 (即 |
costPerKilometer |
車輛路線的每公里費用。這筆費用會套用至 |
fixedCost |
如果這輛車輛用於處理出貨作業,就會收取這筆固定費用。 |
usedIfRouteIsEmpty |
這個欄位僅適用於車輛路線不提供任何貨運時。用於說明車輛是否應視為「二手」或在這個案例中否。 如果設為 true,即使車輛不提供任何貨物,車輛也會從起點移動到終點,並考量從開始到終點之間的時間和距離成本> 計算。 否則,車輛就不會從起點移動到終點,且系統不會為該車輛安排 |
routeDurationLimit |
這個限制適用於車輛路線的總行車時間。在指定的 |
travelDurationLimit |
套用至車輛路線的車程時間限制。在特定 |
routeDistanceLimit |
套用至車輛路線總距離的限制。在指定的 |
extraVisitDurationForVisitType |
指定 VisitTypes 字串到 times 的對應。時間長度是指在指定 如果造訪要求包含多個類型,地圖中會為每個類型加入持續時間。 這個物件中包含 |
breakRule |
說明這輛車要強制執行的休息時間表。如果留空,這輛車就不會安排休息時間。 |
label |
指定此車輛的標籤。在回覆中會回報這個標籤為對應 |
ignore |
如果為 true, 如果 如果運送作業是由 |
travelDurationMultiple |
指定乘數,可用來增加或減少這輛車的交通時間。舉例來說,如果將這個項目設定為 2.0,就代表這輛車的行駛速度較慢,而且交通時間是一般車輛的兩倍。這個係數不會影響造訪時間長度。但如果指定 警告:在套用這個倍數後,但在執行任何數值運算之前,系統會將行程時間四捨五入至最近的秒,因此如果倍數過小,可能會導致精確度降低。 另請參閱下方的 |
TravelMode
車輛可使用的交通方式。
這些應為 Google 地圖平台路線偏好 API 的部分交通模式,請參閱:https://developers.google.com/maps/documentation/routes_preferred/reference/rest/Shared.Types/RouteTravelMode。
列舉 | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
未指定交通方式,相當於 DRIVING 。 |
DRIVING |
與駕駛路線相對應的交通模式 (汽車、...)。 |
WALKING |
與步行路線對應的交通模式。 |
UnloadingPolicy
車輛卸載方式相關政策。僅適用於同時包含自取和運送的貨件。
其他商品在路線上的任何地點皆可自由運送,與 unloadingPolicy
無關。
列舉 | |
---|---|
UNLOADING_POLICY_UNSPECIFIED |
未指定的卸載政策;送件必須於相應的取貨時間之後發生。 |
LAST_IN_FIRST_OUT |
貨品必須按取貨順序反向排序 |
FIRST_IN_FIRST_OUT |
運送作業必須按照取貨順序進行 |
LoadLimit
定義適用於車輛的負載限制,例如「這輛卡車只能載運 3500 公斤以下的貨物」。詳情請參閱《loadLimits
》。
JSON 表示法 |
---|
{ "softMaxLoad": string, "costPerUnitAboveSoftMax": number, "startLoadInterval": { object ( |
欄位 | |
---|---|
softMaxLoad |
負載的軟性限制。詳情請參閱《 |
costPerUnitAboveSoftMax |
如果載重量超過這輛車輛路線的 |
startLoadInterval |
車輛在路線起點的允許載客量間隔。 |
endLoadInterval |
車輛在路線結束時可接受的載客量間隔。 |
maxLoad |
可接受的最大負載量。 |
時間間隔
可接受的負載量間隔。
JSON 表示法 |
---|
{ "min": string, "max": string } |
欄位 | |
---|---|
min |
|
max |
可接受的最大負載。必須大於或等於 0。如果未指定,則此訊息不會限制最大負載。如果同時指定兩者, |
DurationLimit
定義車輛路線的時間上限。可以是硬式或軟式。
定義軟性上限欄位時,必須一併定義軟性上限門檻及其相關費用。
JSON 表示法 |
---|
{ "maxDuration": string, "softMaxDuration": string, "quadraticSoftMaxDuration": string, "costPerHourAfterSoftMax": number, "costPerSquareHourAfterQuadraticSoftMax": number } |
欄位 | |
---|---|
maxDuration |
硬性限制將持續時間限制在 maxDuration 內。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
softMaxDuration |
非強制執行時間限制並未強制執行時間長度上限,而違反時路徑會產生費用。這筆費用會與模型中定義的其他費用相加,且單位相同。 如果已定義, 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
quadraticSoftMaxDuration |
非強制執行的持續時間上限並未強制執行時間上限,但如果違反,路徑會在這段時間內產生二次費用。這項費用會與模型中定義的其他費用相加,並使用相同的單位。 如果已定義,
時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
costPerHourAfterSoftMax |
違反
費用必須為非負值。 |
costPerSquareHourAfterQuadraticSoftMax |
違反 如果時間長度低於門檻,額外費用為 0,否則費用取決於時間長度,如下所示:
費用必須為正數。 |
DistanceLimit
定義可行駛的最大距離。可以是硬式或軟式。
如果定義軟性限制,softMaxMeters
和 costPerKilometerAboveSoftMax
都必須定義且為非負值。
JSON 表示法 |
---|
{ "maxMeters": string, "softMaxMeters": string, "costPerKilometerAboveSoftMax": number } |
欄位 | |
---|---|
maxMeters |
硬性限制會將距離限制在 maxMeter 內。限制值不得為負數。 |
softMaxMeters |
非強制規定的距離上限並未強制執行,不過一旦違反,成本就會加起來,等於模型中定義的其他費用,且單位相同。 如果定義的 softMaxMeters 必須小於 maxMeters,且不得為負數。 |
costPerKilometerAboveSoftMax |
如果距離超過
費用必須為非負值。 |
BreakRule
產生車輛休息時間的規則 (例如午餐休息時間)。休息時間是指車輛在目前位置處於閒置狀態,無法執行任何拜訪的連續時間。下列情形可能會發生中斷:
- 。
- 或是車輛啟動時 (車輛不得在休息中發動),在這種情況下,並不會影響車輛開始時間。
- 或是車輛結束 (坐下與車輛結束時間) 後。
JSON 表示法 |
---|
{ "breakRequests": [ { object ( |
欄位 | |
---|---|
breakRequests[] |
中斷序列。請參閱 |
frequencyConstraints[] |
可能會套用多個 |
BreakRequest
您必須事先知道適用於每輛車的休息時間序列 (即數量和順序)。重複的 BreakRequest
會定義該序列的出現順序。兩者的時間範圍 (earliestStartTime
/ latestStartTime
) 可能會重疊,但必須與訂單相容 (系統會檢查這項條件)。
JSON 表示法 |
---|
{ "earliestStartTime": string, "latestStartTime": string, "minDuration": string } |
欄位 | |
---|---|
earliestStartTime |
必要欄位。廣告插播開始時的下限 (含)。 RFC3339 世界標準時間「Zulu」格式的時間戳記,解析度以奈秒為單位,小數點後最多 9 位。範例: |
latestStartTime |
必要欄位。休息時間開始的上限 (包含在內)。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。範例: |
minDuration |
必要欄位。插播時間長度下限。必須為正數。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
FrequencyConstraint
其中一種做法是強制執行最小的廣告插播頻率 (例如「每 12 小時至少要有 1 小時」),限制上述廣告插播的頻率和時間長度。假設這個值可解讀為「在 12 小時的任何滑動時間範圍內,至少要有一個廣告插播時段至少一小時」,則範例會轉譯為下列 FrequencyConstraint
:
{
minBreakDuration { seconds: 3600 } # 1 hour.
maxInterBreakDuration { seconds: 39600 } # 11 hours (12 - 1 = 11).
}
除了 BreakRequest
中已指定的時間區間和最短時間長度外,解決方案中的中斷時間和時間長度都會遵循所有這類限制。
FrequencyConstraint
可能在練習時適用於不連續的休息時間。舉例來說,以下時程會遵循「每 12 小時 1 小時」的範例:
04:00 vehicle start
.. performing travel and visits ..
09:00 1 hour break
10:00 end of the break
.. performing travel and visits ..
12:00 20-min lunch break
12:20 end of the break
.. performing travel and visits ..
21:00 1 hour break
22:00 end of the break
.. performing travel and visits ..
23:59 vehicle end
JSON 表示法 |
---|
{ "minBreakDuration": string, "maxInterBreakDuration": string } |
欄位 | |
---|---|
minBreakDuration |
必要欄位。此限制的插播時間長度下限。正數。請參閱 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
maxInterBreakDuration |
必要欄位。路線中任何時間間隔的上限,至少不包含部分 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
DurationDistanceMatrix
指定從造訪和車輛起點到造訪和車輛終點的時間和距離矩陣。
JSON 表示法 |
---|
{
"rows": [
{
object ( |
欄位 | |
---|---|
rows[] |
指定時間長度和距離矩陣的資料列。必須包含與 |
vehicleStartTag |
標記定義這個時間長度和距離矩陣適用於哪些車輛。如果為空白,表示適用於所有車輛,且只能有一個矩陣。 每個車輛啟動都必須與單一矩陣相符,也就是說,其中的 所有矩陣都必須有不同的 |
列
指定時間長度和距離矩陣的資料列。
JSON 表示法 |
---|
{ "durations": [ string ], "meters": [ number ] } |
欄位 | |
---|---|
durations[] |
指定資料列的持續時間值。必須包含與 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
meters[] |
特定資料列的距離值。如果沒有任何費用或限制是指模型中的距離,則可留空,否則包含的元素數量必須與 |
TransitionAttributes
指定路線上兩次連續造訪之間的轉換屬性。同一轉換可能有幾個 TransitionAttributes
:在這種情況下,所有額外費用都會增加,且須遵守最嚴格的限製或限制 (遵循自然「AND」語意)。
JSON 表示法 |
---|
{
"srcTag": string,
"excludedSrcTag": string,
"dstTag": string,
"excludedDstTag": string,
"cost": number,
"costPerKilometer": number,
"distanceLimit": {
object ( |
欄位 | |
---|---|
srcTag |
定義一組 (src->dst) 轉場效果的標記,會套用至這些屬性。 如果 |
excludedSrcTag |
請參閱 |
dstTag |
如果目的地或車輛的 |
excludedDstTag |
請參閱 |
cost |
指定執行此轉換作業的費用。此值的單位與模型中的所有其他成本相同,且不得為負數。此額度適用於所有其他現有費用。 |
costPerKilometer |
指定在執行此轉場時,所採計的每公里成本。會加總車輛上指定的所有 |
distanceLimit |
指定執行此轉場效果時的行駛距離限制。 自 2021 年 6 月起,我們只支援軟性限制。 |
delay |
指定執行這項轉換時的延遲時間。 這項延遲一律會發生在完成來源造訪「後」和開始目的地造訪「前」。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
ShipmentTypeIncompatibility
根據 shipmentType 指定不同出貨之間的不相容性。系統會根據不相容模式,限制在同一路線上顯示不相容的貨件。
JSON 表示法 |
---|
{
"types": [
string
],
"incompatibilityMode": enum ( |
欄位 | |
---|---|
types[] |
不相容類型的清單。兩件出貨各有不同的 |
incompatibilityMode |
套用至不相容項目的模式。 |
IncompatibilityMode
定義同一條路線上不相容貨運外觀的限制方式。
列舉 | |
---|---|
INCOMPATIBILITY_MODE_UNSPECIFIED |
未指定不相容模式。請一律不要使用這個值。 |
NOT_PERFORMED_BY_SAME_VEHICLE |
在這種模式下,兩個不相容的貨物無法共用同一輛車輛。 |
NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY |
如果兩個出貨項目的類型不相容,且使用
|
ShipmentTypeRequirement
根據運送類型指定貨物之間的各項規定。需求的具體內容則由需求模式定義。
JSON 表示法 |
---|
{
"requiredShipmentTypeAlternatives": [
string
],
"dependentShipmentTypes": [
string
],
"requirementMode": enum ( |
欄位 | |
---|---|
requiredShipmentTypeAlternatives[] |
|
dependentShipmentTypes[] |
所有在 注意:系統不允許 |
requirementMode |
套用至需求的模式。 |
RequirementMode
定義路線上相依運送方式的模式。
列舉 | |
---|---|
REQUIREMENT_MODE_UNSPECIFIED |
未指定需求模式。請一律不要使用這個值。 |
PERFORMED_BY_SAME_VEHICLE |
在此模式下,所有「相依」貨物運送時都必須與至少一項「必要」貨物共乘同一輛車。 |
IN_SAME_VEHICLE_AT_PICKUP_TIME |
使用 因此「相依」運送取貨必須符合以下條件:
|
IN_SAME_VEHICLE_AT_DELIVERY_TIME |
與前述相同,但「依附」運送作業必須在運送時,在其車輛上有「必要」運送作業。 |
PrecedenceRule
兩個事件之間的優先順序規則 (每個事件都是提貨或出貨):第二個事件必須在第一個事件開始後至少 offsetDuration
才會開始。
不過,有些優先順序可代表相同 (或相關) 事件,例如:「B 送貨後取貨」和「從 B 取件後到貨 (C) 發生」。
此外,只有在兩項運送作業都發生時,優先順序才會套用,其他作業則遭到忽略。
JSON 表示法 |
---|
{ "firstIsDelivery": boolean, "secondIsDelivery": boolean, "offsetDuration": string, "firstIndex": integer, "secondIndex": integer } |
欄位 | |
---|---|
firstIsDelivery |
指出「first」事件是否為放送事件。 |
secondIsDelivery |
表示「第二個」事件是否為傳送事件。 |
offsetDuration |
「第一個」和「第二個」事件之間的偏移。可以是負值。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
firstIndex |
「第一個」事件的運送索引。必須指定此欄位。 |
secondIndex |
「second」事件的出貨索引。必須指定此欄位。 |