Package google.maps.routeoptimization.v1

int32

已執行的出貨次數。請注意，取貨和送貨配對只會計算一次。

Duration

路線或解決方案的總旅行時間。

Duration

路線或解決方案的總等待時間。

Duration

路線或解決方案的總延遲時間。

Duration

路線或解決方案的休息時間總長度。

Duration

路線或解決方案的總造訪時間長度。

Duration

總時間長度應等於上述所有時間長度的總和。如果是路線，則也對應至：

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

路線或解決方案的總行駛距離。

map<string, VehicleLoad>

整個路線 (或解決方案) 達成的最大負載，針對該路線 (或解決方案) 上的每個數量，計算為所有 Transition.vehicle_loads (或 ShipmentRoute.metrics.max_loads。

int32

執行的強制出貨次數。

實驗性：這個欄位的行為或存在狀態日後可能會變更。

double

已執行出貨的 Shipment.penalty_cost 總和。

實驗性：這個欄位的行為或存在狀態日後可能會變更。

string

必要欄位。用於發出呼叫的目標專案和位置。

格式：

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

如未指定位置，系統會自動選擇區域。

AsyncModelConfig

必要欄位。每個購買模型的輸入/輸出資訊，例如檔案路徑和資料格式。

string

(選用步驟) 使用者定義的模型名稱，可做為別名，方便使用者追蹤模型。

InputConfig

必要欄位。輸入模型的相關資訊。

OutputConfig

必要欄位。所需的輸出位置資訊。

BreakRequest

休息時間的順序。請參閱 BreakRequest 訊息。

FrequencyConstraint

可能適用多個 FrequencyConstraint。這些條件必須由這個 BreakRule 的 BreakRequest 滿足。詳情請參閱 FrequencyConstraint。

Timestamp

必要欄位。休息開始時間的下限 (含)。

Timestamp

必要欄位。休息開始時間的上限 (含)。

Duration

必要欄位。休息時間下限。必須為正數。

Duration

必要欄位。這項限制的最短休息時間。非負數。請參閱 FrequencyConstraint 的說明。

Duration

必要欄位。路線中任何時間間隔的允許跨度上限，該間隔至少不包含部分 duration >= min_break_duration 中斷。必須為正數。

int64

硬性限制，距離不得超過 max_meters。限制不得為負數。

int64

軟性限制不會強制執行距離上限，但如果違反規定，就會產生費用，並以相同單位加總至模型中定義的其他費用。

如果定義 soft_max_meters，則該值必須小於 max_meters，且不得為負數。

double

每公里產生的費用，最高可達 soft_max_meters，計算公式如下：

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

route_distance_limit不支援這項費用。

double

如果距離超過 soft_max_meters 限制，每公里費用。如果距離低於限制，則額外費用為 0；否則，計算費用的公式如下：

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

費用不得為負值。

string

必要欄位。Google Cloud Storage URI。

string

必要欄位。Google Cloud Storage 物件的 URI，格式為 gs://bucket/path/to/object。

ShipmentRoute

要注入的解決方案路徑。原始解決方案可能會省略部分路線。路線和略過的貨運必須符合 injected_first_solution_routes 列出的基本有效性假設。

SkippedShipment

已略過要注入的解決方案出貨。部分內容可能已從原始解決方案中省略。請參閱 routes 欄位。

ConstraintRelaxation

針對零或多個車輛群組，指定放寬限制的時間和幅度。如果這個欄位為空白，所有非空白車輛路線都會受到完整限制。

Relaxation

所有適用於路線上車輛的拜訪限制放寬條件。vehicle_indices

int32

指定要套用拜訪限制 relaxations 的車輛索引。如果留空，系統會將此視為預設值，且 relaxations 會套用至其他 constraint_relaxations 中未指定的車輛。最多只能有一個預設值，也就是最多只能有一個限制寬鬆欄位允許空白 vehicle_indices。即使在多個 constraint_relaxations 中，車輛索引也只能列出一次。

如果 interpret_injected_solutions_using_labels 為 true，則車輛索引會對應至 ShipmentRoute.vehicle_index (請參閱 fields 註解)。

Level

當 threshold_time「和」threshold_visit_count 滿足條件時，適用的限制寬鬆程度。

Timestamp

可套用寬限期的時間 (含) 之後。level

int32

放寬限制 level 的造訪次數下限。如果 threshold_visit_count 為 0 (或未設定)，level 可能會直接在車輛啟動時套用。

如果是 route.visits_size() + 1，level 只能套用至車輛端。如果超過 route.visits_size() + 1，系統就不會為該路線套用 level。

DataFormat

必要欄位。輸入資料格式。

GcsSource

Google Cloud Storage 位置。這必須是單一物件 (檔案)。

LatLng

途中的地理座標。

int32

與車流方向相關的指南針方位。這個值用於指定取貨和下車地點的道路側。航向值可以介於 0 到 360 之間，其中 0 指定正北方的航向，90 指定正東方的航向，依此類推。

string

必要欄位。要發出呼叫的目標專案或位置。

格式：

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

如未指定位置，系統會自動選擇區域。

Duration

如果設定這個逾時時間，伺服器會在逾時時間經過前或達到同步要求的伺服器期限前傳回回應 (以較早者為準)。

如果是非同步要求，伺服器會在逾時前產生解決方案 (如有可能)。

ShipmentModel

要解決的貨運模型。

SolvingMode

預設的求解模式為 DEFAULT_SOLVE (0)。

SearchMode

用於解決要求的搜尋模式。

ShipmentRoute

引導最佳化演算法找出與先前解決方案類似的初始解決方案。

建構第一個解決方案時，模型會受到限制。在第一個解決方案中，系統會隱含略過未在路線上執行的任何出貨作業，但可能會在後續解決方案中執行。

解決方案必須滿足一些基本有效性假設：

• 所有路線的 vehicle_index 都必須在範圍內，且不得重複。
• 所有造訪次數的 shipment_index 和 visit_request_index 都必須在範圍內。
• 一筆貨運只能參照一條路線。
• 取貨遞送貨件的取貨作業必須在遞送前完成。
• 每件貨物只能選擇一種取貨或送貨方式。
• 所有路線的行車時間都變長 (即 vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time)。
• 只能在允許的車輛上執行運送作業。如果 Shipment.allowed_vehicle_indices 為空白，或 vehicle_index 包含在 Shipment.allowed_vehicle_indices 中，則允許車輛。

如果注入的解決方案不可行，系統不一定會傳回驗證錯誤，而是可能傳回指出不可行的錯誤。

InjectedSolutionConstraint

限制最佳化演算法，找出與先前解決方案類似的最終解決方案。舉例來說，這項功能可用於凍結已完成或即將完成但不得修改的部分路徑。

如果注入的解決方案不可行，系統不一定會傳回驗證錯誤，而是可能傳回指出不可行的錯誤。

ShipmentRoute

如果不是空白，系統會重新整理指定路徑，但不會修改基礎的造訪順序或行程時間，只會更新其他詳細資料。這無法解決模型問題。

自 2020 年 11 月起，這項功能只會填入非空白路線的折線，且需要將 populate_polylines 設為 true。

傳入路線的 route_polyline 欄位可能與路線 transitions 不一致。

這個欄位不得與 injected_first_solution_routes 或 injected_solution_constraint 一併使用。

Shipment.ignore 和 Vehicle.ignore 不會影響行為。無論相關貨件或車輛是否遭到忽略，系統仍會在所有非空白路線的所有拜訪之間填入折線。

bool

如果為 true：

• 使用 ShipmentRoute.vehicle_label 而非 vehicle_index，將注入解決方案中的路徑與要求中的車輛相符；重複使用原始 ShipmentRoute.vehicle_index 對應至新 ShipmentRoute.vehicle_index 的對應，在非空白時更新 ConstraintRelaxation.vehicle_indices，但對應必須明確 (即多個 ShipmentRoute 不得共用相同的原始 vehicle_index)。
• 使用 ShipmentRoute.Visit.shipment_label 而非 shipment_index，將注入解決方案中的造訪次數與要求中的出貨次數相符；
• 使用 SkippedShipment.label 而非 SkippedShipment.index，將注入解決方案中略過的貨件與要求貨件相符。

這項解讀適用於 injected_first_solution_routes、injected_solution_constraint 和 refresh_details_routes 欄位。如果自建立解決方案以來，要求中的貨運或車輛索引已變更 (可能是因為要求中已移除或新增貨運或車輛)，即可使用這項功能。

如果是 true，下列類別中的標籤在所屬類別中最多只能出現一次：

• 要求中的 Vehicle.label；
• 要求中的 Shipment.label；
• ShipmentRoute.vehicle_label 注入的解決方案；
• SkippedShipment.label 和 ShipmentRoute.Visit.shipment_label (取貨/送貨行程配對除外，這類行程的 shipment_label 必須出現兩次)。

如果插入解決方案中的 vehicle_label 與要求車輛不符，系統會從解決方案中移除對應路線和拜訪地點。如果注入解決方案中的 shipment_label 與要求出貨不符，系統會從解決方案中移除對應的拜訪。如果注入的解決方案中的 SkippedShipment.label 與要求出貨的商品不符，系統會從解決方案中移除 SkippedShipment。

從插入的解決方案中移除路線拜訪或整條路線，可能會影響隱含限制，進而導致解決方案變更、驗證錯誤或不可行。

注意：呼叫者必須確保每個 Vehicle.label (resp. Shipment.label) 可用來不重複地識別車輛 (或貨運) 實體，這兩個相關要求都會用到：產生 OptimizeToursResponse 的過去要求，以及包含插入解決方案的目前要求。上述唯一性檢查不足以確保符合這項規定。

bool

計算 ShipmentRoute 欄位 Transition.travel_duration、Visit.start_time 和 vehicle_end_time 時，請考慮流量估算值；設定 ShipmentRoute.has_traffic_infeasibilities 欄位時，以及計算 OptimizeToursResponse.total_cost 欄位時，也請考慮流量估算值。

bool

如為 true，回應 ShipmentRoute 中會填入折線。

bool

如果為 true，回應 ShipmentRoute.transitions 中會填入折線和路徑權杖。

bool

如果已設定此值，要求的最長期限為 60 分鐘 (請參閱 https://grpc.io/blog/deadlines)。否則，最長期限僅為 30 分鐘。請注意，長時間執行的要求中斷的風險較高 (但仍很小)。

bool

如果為 true，系統會使用測地距離 (而非 Google 地圖距離) 計算移動距離，並使用測地距離和 geodesic_meters_per_second 定義的速度計算移動時間。

string

可用於識別這項要求的標籤，會回報至 OptimizeToursResponse.request_label。

double

如果 use_geodesic_distances 為 true，則必須設定這個欄位，並定義用於計算行程時間的速度。值不得小於 1.0 公尺/秒。

int32

截斷傳回的驗證錯誤數量。除非 solving_mode=VALIDATE_ONLY，否則這些錯誤通常會以 BadRequest 錯誤詳細資料 (https://cloud.google.com/apis/design/errors#error_details) 附加至 INVALID_ARGUMENT 錯誤酬載：請參閱 OptimizeToursResponse.validation_errors 欄位。預設值為 100，上限為 10,000。

ShipmentRoute

為每部車輛計算的路線；第 i 條路線對應模型中的第 i 部車輛。

string

如果要求中指定標籤，則為 OptimizeToursRequest.label 的副本。

SkippedShipment

所有已略過的出貨清單。

OptimizeToursValidationError

我們獨立偵測到的所有驗證錯誤清單。請參閱「MULTIPLE ERRORS」說明，瞭解 OptimizeToursValidationError 訊息。如果 solving_mode 是 DEFAULT_SOLVE，則會包含警告，而非錯誤。

OptimizeToursRequest

在某些情況下，我們會先修改傳入的要求 (例如新增費用)，再解決問題。如果 solving_mode == TRANSFORM_AND_RETURN_REQUEST，則修改後的要求會在此處傳回。

實驗功能：詳情請參閱 https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request。

Metrics

這項解決方案的時長、距離和用量指標。

AggregatedMetrics

匯總所有路線的資料。每個指標都是所有同名 ShipmentRoute.metrics 欄位的總和 (或載入次數上限)。

int32

略過的強制出貨次數。

int32

使用的車輛數量。注意：如果車輛路線為空白且 Vehicle.used_if_route_is_empty 為 true，則車輛視為已使用。

Timestamp

二手車的最早開始時間，計算方式為所有二手車的 ShipmentRoute.vehicle_start_time 最小值。

Timestamp

二手車的最新結束時間，計算方式為所有二手車的 ShipmentRoute.vehicle_end_time 最大值。

map<string, double>

解決方案的費用，依費用相關要求欄位細分。鍵是相對於輸入 OptimizeToursRequest 的原型路徑，例如「model.shipments.pickups.cost」，值則是對應費用欄位產生的總費用，並彙整整個解決方案。換句話說，costs["model.shipments.pickups.cost"] 是解決方案中所有取貨費用的總和。模型中定義的所有費用都會在此詳細列出，但與 TransitionAttributes 相關的費用除外，這類費用自 2022 年 1 月起只會以匯總方式列出。

double

解決方案的總費用。費用對應中的所有值總和。

string

必要欄位。要發出呼叫的目標專案或位置。

格式：

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

如未指定位置，系統會自動選擇區域。

Uri

必要欄位。包含 OptimizeToursRequest 的 Cloud Storage 物件 URI。

Uri

必要欄位。將包含 OptimizeToursResponse 的 Cloud Storage 物件 URI。

Uri

(選用步驟) 包含 OptimizeToursResponse 的 Cloud Storage 物件 URI，編碼格式為 JSON 或 textproto。如果物件是以 JSON 編碼，物件名稱的副檔名會是 .json。如果物件是以 textproto 編碼，物件名稱的副檔名會是 .txtpb。

資源的 crc32_checksum 可用於驗證資源內容是否經過修改。

int32

驗證錯誤是由一對 (code, display_name) 定義，且一律存在。

這個部分後方的欄位會提供更多錯誤相關背景資訊。

多項錯誤：如果有多項錯誤，驗證程序會嘗試輸出多項錯誤。與編譯器類似，這項程序並不完美。部分驗證錯誤屬於「嚴重」錯誤，會導致整個驗證程序停止。display_name="UNSPECIFIED" 錯誤就屬於這種情況。部分錯誤可能會導致驗證程序略過其他錯誤。

穩定性：code 和 display_name 應非常穩定。但隨著時間推移，可能會出現新的代碼和顯示名稱，導致特定 (無效) 要求產生不同的 (code、display_name) 配對，因為新錯誤隱藏了舊錯誤。例如「MULTIPLE ERRORS」。

string

錯誤顯示名稱。

FieldReference

錯誤情境可能涉及 0 個、1 個 (大部分時間) 或多個欄位。舉例來說，如要參照車輛 #4 和貨運 #2 的首次取貨，可以按照下列方式操作：

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

但請注意，特定錯誤碼的基數不應變更。fields

string

使用者容易理解的錯誤說明字串。code 和 error_message 之間存在 1:1 的對應關係 (當程式碼 !=「UNSPECIFIED」時)。

穩定性：不穩定：與特定 code 相關聯的錯誤訊息可能會隨時間變更 (希望是為了釐清問題)。請改用 display_name 和 code。

string

可能包含欄位的值。這項功能不一定適用於所有裝置。您絕對不應依賴這項功能，只能用於手動偵錯模型。

string

欄位名稱，例如「vehicles」。

FieldReference

視需要遞迴巢狀子欄位。

int32

如果是重複欄位，則為欄位的索引。

string

如果欄位是對應項，則為鍵。

DataFormat

必要欄位。輸出資料格式。

GcsDestination

要寫入輸出內容的 Google Cloud Storage 位置。

bool

指定是否要盡量避開收費道路。系統會優先選擇不含收費道路的路線。僅適用於機動交通方式。

bool

指定是否要盡量避開高速公路。系統會優先選擇不含高速公路的路徑。僅適用於機動交通方式。

bool

指定是否應盡量避開渡輪。系統會優先顯示不含渡輪的路線。僅適用於機動交通方式。

bool

(選用步驟) 指定是否應盡量避免室內導航。系統會優先提供不含室內導航的路線。僅適用於「WALKING」旅行模式。

string

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

VisitRequest

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

VisitRequest

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

map<string, Load>

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

int32

可能執行這項出貨作業的車輛組合。如果留空，所有車輛都可以執行這項作業。車輛會依據 ShipmentModel's vehicles 清單中的索引提供。

double

指出每輛車輛運送這批貨物時產生的費用。如果指定，則必須具有下列其中一項：

• 元素數量與 costs_per_vehicle_indices 相同。costs_per_vehicle[i] 對應於車輛 costs_per_vehicle_indices[i] 的模型。
• 元素數量與模型中的車輛數量相同。第 i 個元素對應於車輛模型中的第 i 個車輛。

這些費用必須與 penalty_cost 採用相同單位，且不得為負值。如果沒有這類費用，請將這個欄位留空。

int32

costs_per_vehicle 適用的車輛索引。如果不是空白，則必須與 costs_per_vehicle 具有相同數量的元素。車輛索引不得重複指定。如果車輛排除在 costs_per_vehicle_indices 之外，則費用為零。

Duration

指定與取貨地點到送達地點之間最短路徑相比，絕對繞路時間上限。如要指定，必須為非負值，且出貨內容至少須包含取貨和送達。

舉例來說，假設 t 是從所選取貨替代方案直接前往所選送貨替代方案的最短時間。然後設定 pickup_to_delivery_absolute_detour_limit 強制執行：

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

如果同一批貨物同時指定相對和絕對限制，系統會針對每個可能的取貨/送達配對，採用較嚴格的限制。自 2017 年 10 月起，只有在行程時間不取決於車輛時，系統才會支援繞道。

Duration

指定貨件從取貨開始到開始運送之間的最長時間。如要指定，必須為非負值，且出貨內容至少須包含取貨和送達。這與取貨和送貨的替代方案或車輛速度無關。這項限制可以與最大繞道限制一併指定，解決方案會同時遵守這兩項規格。

string

非空白字串，指定這批貨件的「類型」。這項功能可用於定義 shipment_types 之間的不相容性或需求 (請參閱 ShipmentModel 中的 shipment_type_incompatibilities 和 shipment_type_requirements)。

與單次取貨/送貨的 visit_types 不同：同一批貨的所有取貨/送貨作業都共用相同的 shipment_type。

string

指定這批貨件的標籤。這個標籤會在對應 ShipmentRoute.Visit 的 shipment_label 中回報。

bool

如果為 true，請略過這批貨，但不要套用 penalty_cost。

如果模型中含有任何 shipment_type_requirements，忽略出貨會導致驗證錯誤。

你可以忽略在 injected_first_solution_routes 或 injected_solution_constraint 中執行的貨運作業，求解器會從執行路線中移除相關的取貨/送貨行程。系統也會忽略參照遭忽略出貨內容的 precedence_rules。

double

如果未完成出貨，這筆罰款會加到路線的總成本中。如果選擇自取或替代運送方式，且已前往取貨地點，系統就會將該貨件視為已完成運送。費用可採用模型中所有其他費用相關欄位使用的相同單位，且必須為正數。

重要事項：如未指定這項處罰，系統會視為無限期，也就是必須完成出貨。

double

指定與取貨到送達之間最短路徑相比，可接受的最大相對繞道時間。如要指定，必須為非負值，且出貨內容至少須包含取貨和送達。

舉例來說，假設 t 是從所選取貨替代方案直接前往所選送貨替代方案的最短時間。然後設定 pickup_to_delivery_relative_detour_limit 強制執行：

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

如果同一批貨物同時指定相對和絕對限制，系統會針對每個可能的取貨/送達配對，採用較嚴格的限制。自 2017 年 10 月起，只有在行程時間不取決於車輛時，系統才會支援繞道。

int64

執行相應拜訪行程的車輛負重會有所不同。由於這是整數，建議使用者選擇適當的單位，以免失去精確度。必須 ≥ 0。

LatLng

車輛執行這項 VisitRequest 時抵達的地理位置。如果貨運模型有時間長度距離矩陣，則不得指定 arrival_location。

Waypoint

車輛執行這項 VisitRequest 時抵達的路點。如果貨運模型有時間長度距離矩陣，則不得指定 arrival_waypoint。

LatLng

車輛在完成這項 VisitRequest 後的出發地理位置。如果與 arrival_location 相同，則可省略。如果貨運模型有時間長度距離矩陣，則不得指定 departure_location。

Waypoint

車輛完成這項 VisitRequest 後的出發地點。如果與 arrival_waypoint 相同，則可省略。如果貨運模型有時間長度距離矩陣，則不得指定 departure_waypoint。

string

指定附加至造訪要求的標記。不得使用空白或重複的字串。

TimeWindow

時間範圍，用於限制拜訪的到達時間。請注意，車輛可能會在抵達時間範圍外離開，也就是說，抵達時間 + 停留時間不一定要在時間範圍內。如果車輛在 TimeWindow.start_time 前抵達，你可能需要等待。

如果沒有 TimeWindow，表示車輛隨時可以執行這項拜訪。

時段不得重疊或相鄰，且必須遞增排序。

只有在單一時間範圍內，才能設定 cost_per_hour_after_soft_end_time 和 soft_end_time。

Duration

停留時間，也就是車輛抵達和出發之間的時間 (會加到可能的等待時間；請參閱 time_windows)。

double

在車輛路線上處理這項造訪要求的費用。這項屬性可用於支付不同費用的貨件取貨或運送替代方案。這個費用必須與 Shipment.penalty_cost 的單位相同，且不得為負數。

map<string, Load>

載入這項拜訪要求的負載。這與 Shipment.load_demands 欄位類似，但只適用於這個 VisitRequest，而非整個 Shipment。這裡列出的需求會新增至 Shipment.load_demands 中列出的需求。

string

指定拜訪類型。這項資訊可用於分配車輛完成這項拜訪作業所需的額外時間 (請參閱 Vehicle.extra_visit_duration_for_visit_type)。

類型只能出現一次。

string

指定這個 VisitRequest 的標籤。這個標籤會在回應中以對應 ShipmentRoute.Visit 中的 visit_label 形式回報。

bool

指定在這個地點的行車路線中是否應避開迴轉。系統會盡量避免迴轉，但不保證完全不會迴轉。這項功能仍在實驗階段，行為可能會變更。

實驗功能：詳情請參閱 https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request。

Shipment

模型中必須執行的出貨作業組合。

Vehicle

可用於執行拜訪作業的車輛組合。

Objective

這個模型的目標組合，我們會將其轉換為費用。如果不是空白，輸入模型必須免費。如要取得修改後的要求，請使用 solving_mode = TRANSFORM_AND_RETURN_REQUEST。請注意，系統不會解決這類要求。請參閱相關說明文件。

實驗功能：詳情請參閱 https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request。

Timestamp

模型的全球開始和結束時間：超出這個範圍的時間一律無效。

模型的時間範圍必須少於一年，也就是說，global_end_time 和 global_start_time 之間必須相差 31536000 秒。

使用 cost_per_*hour 欄位時，您可能需要將這個時間範圍設為較小間隔，以提升成效 (例如，如果您要模擬單日，就應將全域時間限制設為該日)。如未設定，系統會使用預設值：世界標準時間 1970 年 1 月 1 日 00:00:00 (即秒數：0，奈秒數：0)。

Timestamp

如未設定，系統會使用預設值：世界標準時間 1971 年 1 月 1 日 00:00:00 (亦即秒數：31536000，奈秒數：0)。

double

整體方案的「全球時間長度」是指所有車輛最早的生效開始時間與最晚的生效結束時間之間的差異。使用者可以為該數量指派每小時的費用，盡量縮短作業完成時間。這個費用必須與 Shipment.penalty_cost 的單位相同。

DurationDistanceMatrix

指定模型中使用的時間和距離矩陣。如果這個欄位空白，系統會改用 Google 地圖或測地距離，具體取決於 use_geodesic_distances 欄位的值。如果不是空白，use_geodesic_distances 就不得為 true，且 duration_distance_matrix_src_tags 和 duration_distance_matrix_dst_tags 皆不得為空白。

使用範例：

• 有兩個地點：locA 和 locB。
• 1 輛車從 locA 開始行駛路線，並在 locA 結束。
• 在 locB 提出 1 項取貨預約要求。

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• 有三個地點：locA、locB 和 locC。
• 1 輛車從 locA 開始路線，在 locB 結束路線，使用「fast」矩陣。
• 1 輛車輛從 locB 開始路線，並在 locB 結束路線，使用「slow」矩陣。
• 1 輛車從 locB 開始路線，並在 locB 結束路線，使用「fast」矩陣。
• 在 locC 提出 1 項取貨預約要求。

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

定義時間長度和距離矩陣來源的標記；duration_distance_matrices(i).rows(j) 定義從具有標記 duration_distance_matrix_src_tags(j) 的造訪到矩陣 i 中其他造訪的時間長度和距離。

標記會對應至 VisitRequest.tags 或 Vehicle.start_tags。這個欄位中的每個 VisitRequest 或 Vehicle 都必須與一個標記完全相符。請注意，Vehicle 的來源、目的地和矩陣標記可能相同；同樣地，VisitRequest 的來源和目的地標記可能相同。所有標記都必須互不相同，且不得為空字串。如果這個欄位不為空，則 duration_distance_matrices 不得為空。

string

定義時間和距離矩陣目的地的標記；duration_distance_matrices(i).rows(j).durations(k) (分別為 duration_distance_matrices(i).rows(j).meters(k)) 定義從具有標記 duration_distance_matrix_src_tags(j) 的造訪到具有標記 duration_distance_matrix_dst_tags(k) 的造訪，在矩陣 i 中的移動時間 (或距離)。

標記會對應至 VisitRequest.tags 或 Vehicle.start_tags。這個欄位中的每個 VisitRequest 或 Vehicle 都必須與一個標記完全相符。請注意，Vehicle 的來源、目的地和矩陣標記可能相同；同樣地，VisitRequest 的來源和目的地標記可能相同。所有標記都必須互不相同，且不得為空字串。如果這個欄位不為空，則 duration_distance_matrices 不得為空。

TransitionAttributes

新增至模型的轉場屬性。

ShipmentTypeIncompatibility

不相容的 shipment_type 組合 (請參閱 ShipmentTypeIncompatibility)。

ShipmentTypeRequirement

shipment_type 需求條件集 (請參閱 ShipmentTypeRequirement)。

PrecedenceRule

模型中必須強制執行的優先順序規則集。

重要事項：使用優先順序規則會限制可最佳化問題的大小。如果優先順序規則包含大量出貨內容，系統可能會拒絕要求。

int32

限制有效車輛數量上限。如果車輛的路線至少執行一次出貨作業，該車輛就會處於有效狀態。如果車輛數多於駕駛人數，且車隊車輛種類不一，這項功能可限制路線數量。最佳化功能會選取最適合的車輛子集。必須為嚴格正數。

Row

指定時間和距離矩陣的資料列。元素數量必須與 ShipmentModel.duration_distance_matrix_src_tags 相同。

string

標記，定義這項時間長度和距離矩陣適用於哪些車輛。如果留空，則適用於所有車輛，且只能有一個矩陣。

每輛車的起點都必須與一個矩陣完全相符，也就是說，車輛的 start_tags 欄位必須與矩陣的 vehicle_start_tag 欄位完全相符 (且只能與該矩陣相符)。

所有矩陣的 vehicle_start_tag 都必須不同。

Duration

指定資料列的持續時間值。元素數量必須與 ShipmentModel.duration_distance_matrix_dst_tags 相同。

double

指定資料列的距離值。如果模型中沒有任何成本或限制是指距離，則可以留空；否則必須與 durations 的元素數量相同。

Type

目標類型。

double

這個目標相對於其他目標的權重。可以是任何非負數，權重總和不必為 1。權重預設為 1.0。

bool

指出「第一個」事件是否為運送。

bool

指出「第二個」事件是否為運送。

Duration

「第一個」和「第二個」事件之間的偏移量。可以是負數。

int32

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

int32

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

int32

執行路線的車輛，由來源 ShipmentModel 中的索引識別。

string

執行這條路線的車輛標籤，如果指定，則等於 ShipmentModel.vehicles(vehicle_index).label。

Timestamp

車輛開始行駛路線的時間。

Timestamp

車輛完成路線的時間。

Visit

代表路線的造訪順序。visits[i] 是路線中的第 i 個造訪地點。如果這個欄位空白，系統會將車輛視為未使用。

Transition

路徑的轉場效果排序清單。

bool

如果 OptimizeToursRequest.consider_road_traffic 設為 true，這個欄位表示系統會根據流量估算行程時間，預測路線時間不一致的情況。在滿足巡訪和車輛時間範圍的同時，可能沒有足夠時間完成交通調整後的行程、延誤和巡訪之間的休息時間，或是在第一次巡訪前或最後一次巡訪後。例如：

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

由於交通流量增加，預估行程時間也隨之增加 travel_duration(previous_visit, next_visit)，因此下一次到訪時間可能會比目前的時間範圍晚。此外，由於預估行程時間增加，以及拜訪或休息時間限制，休息時間可能會被迫與拜訪時間重疊。

EncodedPolyline

路線的編碼折線表示法。只有在 OptimizeToursRequest.populate_polylines 設為 True 時，才會填入這個欄位。

Break

這條路線的車輛排定休息時間。breaks 序列代表時間間隔，每個間隔都從對應的 start_time 開始，持續 duration 秒。

AggregatedMetrics

這條路線的時長、距離和負重指標。視情況而定，AggregatedMetrics 的欄位會加總所有 ShipmentRoute.transitions 或 ShipmentRoute.visits。

VehicleFullness

VehicleFullness 欄位，用於計算受限指標與各自車輛限制的接近程度。這些欄位是設有上限的指標欄位 (例如 AggregatedMetrics.travel_distance_meters) 與相關車輛限制 (例如 Vehicle.route_distance_limit) 之間的比例。

實驗性：這個欄位的行為或存在狀態日後可能會變更。

map<string, double>

路線費用，依費用相關要求欄位細分。這些鍵是相對於輸入 OptimizeToursRequest 的原型路徑，例如「model.shipments.pickups.cost」，值則是對應費用欄位產生的總費用，並彙整整個路線的費用。換句話說，costs["model.shipments.pickups.cost"] 是路線上所有取貨費用的總和。模型中定義的所有費用都會在此詳細列出，但與 TransitionAttributes 相關的費用除外，這類費用自 2022 年 1 月起只會以匯總方式列出。

double

路線的總費用。費用地圖中所有費用的總和。

Timestamp

休息時間的開始時間。

Duration

休息時間長度。

string

代表折線編碼點的字串。

Duration

這段期間的旅行時間。

double

轉場期間移動的距離。

bool

透過 OptimizeToursRequest.consider_road_traffic 要求流量時，如果無法擷取 Transition 的流量資訊，這個布林值就會設為 true。這可能是暫時性問題 (即時流量伺服器偶爾會發生問題)，也可能是永久性問題 (該地點沒有資料)。

Duration

套用至這項轉換的延遲時間總和。如有延遲，會在下一個事件 (到訪或車輛結束) 發生前 delay_duration 秒開始。查看《TransitionAttributes.delay》。

Duration

這段期間內發生的休息時間總長 (如有)。每個休息時間的開始時間和時長詳細資料會儲存在 ShipmentRoute.breaks 中。

Duration

這段期間的等待時間。等待時間對應的是閒置時間，不包含休息時間。另請注意，這段等待時間可能會分成幾個不連續的時間間隔。

Duration

轉移作業的總時間長度 (僅供參考)。這等於：

• 下次造訪 start_time (或 vehicle_end_time，如果這是最後一次轉換) - 這次轉換的 start_time；
• 如果 ShipmentRoute.has_traffic_infeasibilities 為 false，則下列項目也成立：`total_duration = travel_duration + delay_duration
• break_duration + wait_duration」。

Timestamp

這項轉換作業的開始時間。

EncodedPolyline

遷移期間所遵循路線的編碼折線表示法。只有在 populate_transition_polylines 設為 True 時，才會填入這個欄位。

string

僅供輸出。這個不透明權杖可傳遞至 Navigation SDK，在導航期間重建路線，並在重新規劃路線時，根據建立路線時的原始意圖進行規劃。請將這個權杖視為不透明的 Blob。請勿比較不同要求中的值，因為即使服務傳回完全相同的路線，這個值也可能會變更。只有在 populate_transition_polylines 設為 True 時，才會填入這個欄位。

map<string, VehicleLoad>

在此轉換期間，車輛的負載量 (適用於出現在這輛車 Vehicle.load_limits 中的每種負載，或在這條路線上進行的某項貨運中，具有非零 Shipment.load_demands 的負載)。

第一次轉換期間的載貨量是車輛路線的起始載貨量。然後，每次造訪後，系統會根據造訪是取貨或送貨，在下一次轉移的載入次數中加入或扣除該次造訪的 load_demands。

int64

車輛的負重，以指定類型為準。負載單位通常會以類型表示。詳情請參閱《Transition.vehicle_loads》。

int32

來源 ShipmentModel 中 shipments 欄位的索引。

bool

如果是 true，表示該次拜訪是為了取貨 Shipment。否則，則對應於運送。

int32

Shipment 的取貨或運送欄位中的 VisitRequest 索引 (請參閱is_pickup)。

Timestamp

訪視開始時間。請注意，車輛可能比這個時間更早抵達造訪地點。時間與 ShipmentModel 一致。

map<string, Load>

總訪客人數需求，即出貨和訪客要求 load_demands 的總和。如果造訪是送貨，值會是負數。系統會針對與 Transition.loads 相同的類型回報需求 (請參閱這個欄位)。

Duration

由於拜訪前路線上的出貨項目，以及時間範圍可能導致的等待時間，額外繞道的時間。如果行程是送貨，繞道距離會從對應的取貨行程計算，等於：

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

否則，系統會根據車輛 start_location 計算，計算方式如下：

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

如果 Shipment 中有指定，則為對應的 Shipment.label 副本。

string

如果 VisitRequest 中有指定，則為對應的 VisitRequest.label 副本。

int32

不透明權杖，代表造訪地點的相關資訊。

如果這個造訪的 VisitRequest.avoid_u_turns 設為 true，或要求 OptimizeToursRequest 中的 ShipmentModel.avoid_u_turns 設為 true，則結果路徑的造訪可能會填入這個欄位。

實驗功能：詳情請參閱 https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request。

string

不相容的類型清單。如果清單中的兩批貨件有不同的 shipment_types，即為「不相容」。

IncompatibilityMode

套用至不相容項目的模式。

string

dependent_shipment_types 要求的替代運送類型清單。

string

dependent_shipment_types 欄位中含有類型的所有貨件，都必須在同一條路線上至少拜訪一個 required_shipment_type_alternatives 類型的貨件。

注意：不得有需求鏈，導致 shipment_type 依附於自身。

RequirementMode

套用至需求的模式。

int32

索引會對應至來源 ShipmentModel 中的出貨項目索引。

string

如果 Shipment 中有指定，則為對應的 Shipment.label 副本。

Reason

說明貨件遭略過原因的清單。請參閱上方的留言 Reason。如果我們無法瞭解為何跳過出貨，系統就不會設定原因。

double

這是 Shipment.penalty_cost 的副本，方便你查看跳過運送的嚴重程度。

實驗性：這個欄位的行為或存在狀態日後可能會變更。

double

預估無法執行這項出貨作業的車輛比例，原因至少包括下列其中一項。注意：只有在原因與車輛有關時，才會填寫這項資訊。

實驗性：這個欄位的行為或存在狀態日後可能會變更。

Code

請參閱程式碼的註解。

int32

與 example_vehicle_index 相同，但我們提供多個已識別車輛的清單。請注意，這份清單僅列出部分範例。只有在 [fill_example_vehicle_indices_in_skipped_reasons][] 為 true 時，才會填入這項資訊。

實驗性：這個欄位的行為或存在狀態日後可能會變更。

string

如果原因代碼為 DEMAND_EXCEEDS_VEHICLE_CAPACITY，則文件會列出超過的容量類型。

int32

如果原因與出貨車輛不相容有關，這個欄位會提供其中一輛相關車輛的索引。

Timestamp

硬性時間範圍的開始時間。如果未指定，則會設為 ShipmentModel.global_start_time。

Timestamp

硬性時間範圍的結束時間。如果未指定，則會設為 ShipmentModel.global_end_time。

Timestamp

時間範圍的軟性開始時間。

Timestamp

時段的軟性結束時間。

double

如果事件發生時間早於 soft_start_time，則模型中會加入每小時費用，並與其他費用一併計算，計算方式如下：

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

這項費用必須為正數，且只有在設定 soft_start_time 後，才能設定這個欄位。

double

如果事件發生在 soft_end_time 之後，模型中會加入每小時費用，計算方式如下：

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

這項費用必須為正數，且只有在設定 soft_end_time 後才能設定這個欄位。

string

定義屬性適用的一組 (src->dst) 轉換的標記。

如果來源造訪或車輛啟動的 VisitRequest.tags 或 Vehicle.start_tags 包含 src_tag，或不包含 excluded_src_tag (視這兩個欄位中哪個不為空而定)，即為相符。

string

詳情請參閱 src_tag。src_tag 和 excluded_src_tag 必須恰好其中一個不得為空。

string

如果目的地拜訪或車輛終點的 VisitRequest.tags 或 Vehicle.end_tags 包含 dst_tag 或不包含 excluded_dst_tag (視這兩個欄位中哪一個不為空而定)，即為相符。

string

詳情請參閱 dst_tag。dst_tag 和 excluded_dst_tag 必須恰好其中一個不得為空。

double

指定執行這項轉換的費用。這與模型中的所有其他費用採用相同單位，且不得為負數。這項費用會加在所有其他現有費用之上。

double

指定在執行這項轉換時，每公里行駛距離適用的成本。最多可為車輛新增任何Vehicle.cost_per_kilometer。

DistanceLimit

指定執行這項轉場效果時的行駛距離上限。

自 2021 年 6 月起，系統僅支援軟性限制。

Duration

指定執行這項轉換時發生的延遲。

這項延遲一律發生在完成來源造訪後，以及開始目的地造訪前。

string

資源的 URI。資源可能尚未存在。

資源內容會編碼為 JSON 或 textproto。僅支援 Google Cloud Storage 資源。如果資源是以 JSON 格式編碼，資源名稱的尾碼必須為 .json。如果資源是以 textproto 編碼，資源名稱必須加上 .txtpb 後置字串。舉例來說，JSON 編碼檔案的 Google Cloud Storage URI 可能如下所示：gs://bucket/path/input/object.json。

string

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

TravelMode

旅行模式會影響車輛可使用的道路和車速。另請參閱 travel_duration_multiple。

RouteModifiers

一組要滿足的條件，會影響特定車輛的路徑計算方式。

LatLng

車輛在收取任何貨物前的位置。如未指定，車輛會從第一個取貨地點開始。如果貨運模型有時間和距離矩陣，則不得指定 start_location。

Waypoint

代表車輛在收取任何貨物前出發的地理位置。如果未指定 start_waypoint 和 start_location，車輛會從第一個上車地點開始。如果貨運模型有時間和距離矩陣，則不得指定 start_waypoint。

LatLng

車輛完成最後一次 VisitRequest 後的地理位置。如果未指定，車輛的 ShipmentRoute 會在完成最後一個 VisitRequest 後立即結束。如果貨運模型有時間和距離矩陣，則不得指定 end_location。

Waypoint

代表車輛在完成最後一次 VisitRequest 後的地理位置。如果未指定 end_waypoint 或 end_location，車輛的 ShipmentRoute 會在完成最後一個 VisitRequest 後立即結束。如果貨運模型有時間和距離矩陣，則不得指定 end_waypoint。

string

指定附加至車輛路線起點的標記。

不得使用空白或重複的字串。

string

指定附加在車輛路線結尾的標記。

不得使用空白或重複的字串。

TimeWindow

車輛可從出發地點出發的時間範圍。且必須符合全球時間限制 (請參閱ShipmentModel.global_*欄位)。如未指定，則除了全域時間限制外，沒有其他限制。

屬於相同重複欄位的時間範圍不得重疊或相鄰，且必須依時間順序排列。

只有在單一時間範圍內，才能設定 cost_per_hour_after_soft_end_time 和 soft_end_time。

TimeWindow

車輛可能抵達最終地點的時間範圍。且必須符合全球時間限制 (請參閱ShipmentModel.global_*欄位)。如未指定，則除了全域時間限制外，沒有其他限制。

屬於相同重複欄位的時間範圍不得重疊或相鄰，且必須依時間順序排列。

只有在單一時間範圍內，才能設定 cost_per_hour_after_soft_end_time 和 soft_end_time。

UnloadingPolicy

車輛強制執行卸貨政策。

map<string, LoadLimit>

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

double

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

車輛路線每小時的費用。這項費用會套用至路線的總時間，包括交通時間、等待時間和拜訪時間。使用 cost_per_hour 而非 cost_per_traveled_hour 可能會導致額外延遲。

double

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

double

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

double

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

bool

如果車輛的路線不包含任何貨物，這項欄位就只適用於車輛。指出車輛是否應視為二手車。

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

否則，車輛不會從起點行駛至終點，且系統不會為這輛車排定 break_rule 或延誤 (從 TransitionAttributes)。在本例中，車輛的 ShipmentRoute 除了車輛索引和標籤外，不含任何資訊。

DurationLimit

車輛路線的總時長限制。在特定 OptimizeToursResponse 中，車輛的路線時間長度是 vehicle_end_time 和 vehicle_start_time 之間的差異。

DurationLimit

車輛路線的行車時間限制。在特定 OptimizeToursResponse 中，路線的行程時間是所有 transitions.travel_duration 的總和。

DistanceLimit

限制適用於車輛路線的總距離。在特定 OptimizeToursResponse 中，路線距離是所有 transitions.travel_distance_meters 的總和。

map<string, Duration>

指定從 visit_types 字串到時間長度的對應。時間長度是指在指定 visit_types 的就診時間之外，還需要花費的時間。VisitRequest.duration如果指定 cost_per_hour，這段額外時間會產生費用。鍵 (即 visit_types) 不得為空字串。

如果預約要求有多個類型，地圖會為每個類型新增時間長度。

BreakRule

說明要對這部車輛強制執行的休息時間表。如果留空，系統就不會為這輛車安排休息時間。

string

指定這部車輛的標籤。這個標籤會在回應中回報為對應 ShipmentRoute 的 vehicle_label。

bool

如為 true，used_if_route_is_empty 必須為 false，且這部車輛會維持未使用狀態。

如果出貨作業是由 injected_first_solution_routes 中忽略的車輛執行，系統會在第一個解決方案中略過該作業，但可以在回應中執行。

如果出貨作業是由 injected_solution_constraint 中遭忽略的車輛執行，且任何相關取貨/送貨作業都受限於車輛 (即未放寬至 RELAX_ALL_AFTER_THRESHOLD 層級)，則回應中會略過該作業。如果貨運的 allowed_vehicle_indices 欄位不為空，且所有允許的車輛都遭到忽略，則回應中會略過該貨運。

double

指定可用於增加或減少這輛車輛行車時間的乘法因子。舉例來說，如果將此值設為 2.0，表示這部車輛速度較慢，行車時間是標準車輛的兩倍。這個倍數不會影響造訪時間長度。如果指定 cost_per_hour 或 cost_per_traveled_hour，則會影響費用。必須介於 [0.001, 1000.0] 的範圍之間。如未設定，車輛為標準車輛，且這個倍數會視為 1.0。

警告：套用這個倍數後，系統會將車程時間四捨五入至最接近的秒數，然後再執行任何數值運算，因此較小的倍數可能會導致精確度降低。

另請參閱下方的 extra_visit_duration_for_visit_type。

Duration

硬性限制，將時間長度限制在 max_duration 內。

Duration

軟性限制不會強制執行最長時限，但如果違反規定，路線就會產生費用。這項費用會與模型中定義的其他費用加總，單位相同。

如果已定義，soft_max_duration 不得為負數。如果也定義了 max_duration，soft_max_duration 必須小於 max_duration。

Duration

軟性限制不會強制執行時間長度上限，但如果違反規定，路線就會產生費用，費用與時間長度成二次方關係。這項費用會與模型中定義的其他費用加總，單位相同。

如果已定義，quadratic_soft_max_duration 不得為負數。如果也定義了 max_duration，則 quadratic_soft_max_duration 必須小於 max_duration，且兩者差異不得超過一天：

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

如果違反 soft_max_duration 門檻，每小時的費用。如果時間長度低於門檻，則額外費用為 0；否則費用會依時間長度而定，如下所示：

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

費用不得為負值。

double

如果違反 quadratic_soft_max_duration 門檻，每平方小時產生的費用。

如果時間長度低於門檻，則額外費用為 0；否則費用會依時間長度而定，如下所示：

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

費用不得為負值。

int64

負載的軟性限制。詳情請參閱《cost_per_unit_above_soft_max》。

double

如果車輛在路線上的負重超過 soft_max_load，系統會套用以下費用罰款 (每輛車只會套用一次)：(負重 - soft_max_load) * cost_per_unit_above_soft_max。所有費用加總必須與 Shipment.penalty_cost 採用相同單位。軟性限制只能在整個模型中，套用至僅限自取或僅限送貨的類型。

Interval

車輛在路線起點的可接受載重間隔。

Interval

車輛在路線終點可接受的裝載間隔。

int64

可接受的負載量上限。

LoadCost

這輛車每移動一公里，運送一單位負載的成本。這可做為燃料消耗量的替代指標：如果負載是重量 (以牛頓為單位)，則負載*公里具有能量的維度。

實驗功能：詳情請參閱 https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request。

LoadCost

這輛車每小時的單位負重行駛成本。

實驗功能：詳情請參閱 https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request。

int64

可接受的最低負載。必須 ≥ 0。如果兩者都指定，min 必須 ≤ max。

int64

可接受的最高負載。必須 ≥ 0。如未指定，則這則訊息不會限制最大負載。如果兩者都指定，min 必須 ≤ max。

int64

負載量超過此值後，移動單位負載的費用會從 cost_per_unit_below_threshold 變更為 cost_per_unit_above_threshold。必須大於或等於 0。

double

移動一個負載單位的成本，每個單位介於 0 和門檻之間。必須是有限值，且 >= 0。

double

超過門檻的每個負載單位的移動成本。在門檻 = 0 的特殊情況下，這是每單位的固定費用。必須是有限值，且 >= 0。

double

這則訊息中所有其他欄位的最大值。

double

AggregatedMetrics.travel_distance_meters 與 Vehicle.route_distance_limit 之間的比例。如果未設定 Vehicle.route_distance_limit，這個欄位也會未設定。

double

[AggregatedMetrics.travel_duration_seconds][] 與 Vehicle.travel_duration_limit 的比例。如果未設定 Vehicle.travel_duration_limit，這個欄位也會未設定。

double

[AggregatedMetrics.total_duration_seconds][] 與 Vehicle.route_duration_limit 的比率。如果未設定 Vehicle.route_duration_limit，這個欄位也會未設定。

double

所有類型的 [AggregatedMetrics.max_load][] 和各自 Vehicle.load_limits 的最大比率。如果所有 Vehicle.load_limits 欄位都未設定，這個欄位也會未設定。

double

特定車輛的比例 (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time)。如果沒有分母，則會改用 (ShipmentModel.global_end_time - ShipmentModel.global_start_time)。

bool

(選用步驟) 表示這個路線控點的位置偏好車輛停靠在道路的特定一側。設定這個值後，路線會經過該位置，車輛就能在道路中心偏向該位置的一側停靠。這個選項不適用於「步行」交通模式。

bool

指出控點是供車輛停靠，目的是接送乘客。這個選項僅適用於「DRIVING」交通方式，且「location_type」為「location」時。

實驗性：這個欄位的行為或存在狀態日後可能會變更。

Location

使用地理座標指定的點，包括選用航向。

string

與途中的航點相關聯的 POI 地點 ID。

使用地點 ID 指定 VisitRequest 的抵達或出發地點時，請使用足夠具體的地點 ID，以判斷導航至該地點的 LatLng 位置。舉例來說，代表建築物的地點 ID 適合使用，但代表道路的地點 ID 則不建議。