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。

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 限制，則每公里產生的費用。如果距離小於限制，額外費用會是 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 為空，或 Shipment.allowed_vehicle_indices 包含車輛的 vehicle_index，則允許刊登車輛。

如果插入的解決方案不可行，則不一定會傳回驗證錯誤，系統可能會改為傳回不可行的錯誤。

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 (因應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

如果設定了這個項目，該要求的期限 (請參閱 https://grpc.io/blog/deadlines) 最多可以有 60 分鐘。否則，最長期限為 30 分鐘。請注意，長時間的要求具有極大 (但仍然很小) 的干擾風險。

bool

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

string

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

double

如果 use_geodesic_distances 為 true，就必須設定這個欄位，並定義計算交通時間時要套用的速度。這個值必須至少為 1.0 公尺/秒。

int32

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

ShipmentRoute

針對每輛車計算的路線第 2 條路線與型號中的第 i 個車輛對應。

string

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

SkippedShipment

略過所有出貨項目的清單。

OptimizeToursValidationError

列出可獨立偵測的所有驗證錯誤。查看「多個錯誤」OptimizeToursValidationError 訊息的說明。

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>

解決方案的費用，按費用相關要求欄位細分。這些鍵是 proto 路徑，相對於輸入的 OptimizeToursRequest，例如：「model.shipments.pickups.cost」和「模型」的值則為對應費用欄位產生的總費用，並匯總為整個解決方案。換句話說，成本 ["model.shipments.pickups.cost"] 是解決方案中所有取貨費用的總和。這裡詳細列出模型中定義的所有費用，但 TransitionAttributes 的相關費用除外。這些費用只以 2022 年 1 月的匯總方式呈現。

double

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

int32

驗證錯誤是由一律存在的組合 (code、display_name) 定義。

其他欄位 (請見下方) 提供更多與錯誤相關的資訊。

多個錯誤：如有多個錯誤，驗證程序會試著輸出數個錯誤。與編譯器類似，這個程序不完美。部分驗證錯誤屬於「嚴重」錯誤，也就是說，這類錯誤會停止整個驗證程序。以上就是 display_name="UNSPECIFIED" 錯誤等等。有些可能會導致驗證程序略過其他錯誤。

STability：code 和 display_name 應非常穩定。不過，新的代碼和顯示名稱可能會隨著時間而出現，這可能導致指定的 (無效) 要求產生不同的組合 (code、display_name)，因為新的錯誤會隱藏舊一組錯誤 (請參閱「MULTIPLE ERRORS」)。

REFERENCE：所有 (代碼、名稱) 組合的清單：

• 未指定 = 0；
• VALIDATION_TIMEOUT_ERROR = 10；無法在期限內完成驗證。

• REQUEST_OPTIONS_ERROR = 12；

  • REQUEST_OPTIONS_INVALID_SOLVING_MODE = 1201；
  • REQUEST_OPTIONS_INVALID_MAX_VALIDATION_ERRORS = 1203；
  • REQUEST_OPTIONS_INVALID_GEODESIC_METERS_PER_second = 1204；
  • REQUEST_OPTIONS_GEODESIC_METERS_PER_second_TOO_SMALL = 1205；
  • REQUEST_OPTIONS_MISSING_GEODESIC_METERS_PER_second = 1206；
  • REQUEST_OPTIONS_POPULATE_PATHFINDER_TRIPS_AND_GEODESIC_DISTANCE = 1207；
  • REQUEST_OPTIONS_COST_MODEL_OPTIONS_AND_GEODESIC_DISTANCE = 1208；
  • REQUEST_OPTIONS_TRAVEL_MODE_INCOMPATIBLE_WITH_TRAFFIC = 1211；
  • REQUEST_OPTIONS_MULTIPLE_TRAFFIC_FLAVORS = 1212；
  • REQUEST_OPTIONS_INVALID_TRAFFIC_FLAVOR = 1213；
  • REQUEST_OPTIONS_TRAFFIC_ENABLED_WITHOUT_GLOBAL_START_TIME = 1214；
  • REQUEST_OPTIONS_TRAFFIC_ENABLED_WITH_PRECEDENCES = 1215；
  • REQUEST_OPTIONS_TRAFFIC_PREFILL_MODE_INVALID = 1216；
  • REQUEST_OPTIONS_TRAFFIC_PREFILL_ENABLED_WITHOUT_TRAFFIC = 1217；
• INJECTED_SOLUTION_ERROR = 20；
  • INJECTED_SOLUTION_MISSING_LABEL = 2000；
  • INJECTED_SOLUTION_DUPLICATE_LABEL = 2001；
  • INJECTED_SOLUTION_AMBIGUOUS_INDEX = 2002；
  • INJECTED_SOLUTION_INFEASIBLE_AFTER_GETTING_TRAVEL_TIMES = 2003 年；
  • INJECTED_SOLUTION_TRANSITION_INCONSISTENT_WITH_ACTUAL_TRAVEL = 2004 年；
  • INJECTED_SOLUTION_CONCURRENT_SOLUTION_TYPES = 2005；
  • INJECTED_SOLUTION_MORE_THAN_ONE_PER_TYPE = 2006；
  • INJECTED_SOLUTION_REFRESH_WITHOUT_POPULATE = 2008 年；
  • INJECTED_SOLUTION_CONSTRAINED_ROUTE_PORTION_INFEASIBLE = 2010；
• SHIPMENT_MODEL_ERROR = 22；
  • SHIPMENT_MODEL_TOO_LARGE = 2200；
  • SHIPMENT_MODEL_TOO_MANY_CAPACITY_TYPES = 2201；
  • SHIPMENT_MODEL_GLOBAL_START_TIME_NEGATIVE_OR_NAN = 2202；
  • SHIPMENT_MODEL_GLOBAL_END_TIME_TOO_LARGE_OR_NAN = 2203；
  • SHIPMENT_MODEL_GLOBAL_START_TIME_AFTER_GLOBAL_END_TIME = 2204；
  • SHIPMENT_MODEL_GLOBAL_DURATION_TOO_LONG = 2205；
  • SHIPMENT_MODEL_MAX_ACTIVE_VEHICLES_NOT_POSITIVE = 2206；
  • SHIPMENT_MODEL_DURATION_MATRIX_TOO_LARGE = 2207；
• INDEX_ERROR = 24；
• TAG_ERROR = 26；
• TIME_WINDOW_ERROR = 28；
  • TIME_WINDOW_INVALID_START_TIME = 2800；
  • TIME_WINDOW_INVALID_END_TIME = 2801；
  • TIME_WINDOW_INVALID_SOFT_START_TIME = 2802；
  • TIME_WINDOW_INVALID_SOFT_END_TIME = 2803；
  • TIME_WINDOW_OUTSIDE_GLOBAL_TIME_WINDOW = 2804；
  • TIME_WINDOW_START_TIME_AFTER_END_TIME = 2805；
  • TIME_WINDOW_INVALID_COST_PER_HOUR_BEFORE_SOFT_START_TIME = 2806；
  • TIME_WINDOW_INVALID_COST_PER_HOUR_AFTER_SOFT_END_TIME = 2807；
  • TIME_WINDOW_COST_BEFORE_SOFT_START_TIME_WITHOUT_SOFT_START_TIME = 2808；
  • TIME_WINDOW_COST_AFTER_SOFT_END_TIME_WITHOUT_SOFT_END_TIME = 2809；
  • TIME_WINDOW_SOFT_START_TIME_WITHOUT_COST_BEFORE_SOFT_START_TIME = 2810；
  • TIME_WINDOW_SOFT_END_TIME_WITHOUT_COST_AFTER_SOFT_END_TIME = 2811；
  • TIME_WINDOW_OVERLAPPING_ADJACENT_OR_EARLIER_THAN_PREVIOUS = 2812；
  • TIME_WINDOW_START_TIME_AFTER_SOFT_START_TIME = 2813；
  • TIME_WINDOW_SOFT_START_TIME_AFTER_END_TIME = 2814；
  • TIME_WINDOW_START_TIME_AFTER_SOFT_END_TIME = 2815；
  • TIME_WINDOW_SOFT_END_TIME_AFTER_END_TIME = 2816；
  • TIME_WINDOW_COST_BEFORE_SOFT_START_TIME_SET_AND_MULTIPLE_WINDOWS = 2817；
  • TIME_WINDOW_COST_AFTER_SOFT_END_TIME_SET_AND_MULTIPLE_WINDOWS = 2818；
  • TRANSITION_ATTRIBUTES_ERROR = 30；
  • TRANSITION_ATTRIBUTES_INVALID_COST = 3000；
  • TRANSITION_ATTRIBUTES_INVALID_COST_PER_KILOMETER = 3001；
  • TRANSITION_ATTRIBUTES_DUPLICATE_TAG_PAIR = 3002；
  • TRANSITION_ATTRIBUTES_DISTANCE_LIMIT_MAX_METERS_UNSUPPORTED = 3003；
  • TRANSITION_ATTRIBUTES_UNSPECIFIED_SOURCE_TAGS = 3004；
  • TRANSITION_ATTRIBUTES_CONFLICTING_SOURCE_TAGS_FIELDS = 3005；
  • TRANSITION_ATTRIBUTES_UNSPECIFIED_實際連結網址 = 3006；
  • TRANSITION_ATTRIBUTES_CONFLICTING_DESTINATION_TAGS_FIELDS = 3007；
  • TRANSITION_ATTRIBUTES_DELAY_DURATION_NEGATIVE_OR_NAN = 3008；
  • TRANSITION_ATTRIBUTES_DELAY_DURATION_EXCEEDS_GLOBAL_DURATION = 3009；
• AMOUNT_ERROR = 31；
  • AMOUNT_NEGATIVE_VALUE = 3100；
• LOAD_LIMIT_ERROR = 33；
  • LOAD_LIMIT_INVALID_COST_ABOVE_SOFT_MAX = 3303；
  • LOAD_LIMIT_SOFT_MAX_WITHOUT_COST_ABOVE_SOFT_MAX = 3304；
  • LOAD_LIMIT_COST_ABOVE_SOFT_MAX_WITHOUT_SOFT_MAX = 3,305；
  • LOAD_LIMIT_NEGATIVE_SOFT_MAX = 3306；
  • LOAD_LIMIT_MIXED_DEMAND_TYPE = 3307；
  • LOAD_LIMIT_MAX_LOAD_NEGATIVE_VALUE = 3308；
  • LOAD_LIMIT_SOFT_MAX_ABOVE_MAX = 3309；
• INTERVAL_ERROR = 34；
  • INTERVAL_MIN_EXCEEDS_MAX = 3401；
  • INTERVAL_NEGATIVE_MIN = 3402；
  • INTERVAL_NEGATIVE_MAX = 3403；
  • INTERVAL_MIN_EXCEEDS_CAPACITY = 3404；
  • INTERVAL_MAX_EXCEEDS_CAPACITY = 3405；
• DISTANCE_LIMIT_ERROR = 36；
  • DISTANCE_LIMIT_INVALID_COST_AFTER_SOFT_MAX = 3601；
  • DISTANCE_LIMIT_SOFT_MAX_WITHOUT_COST_AFTER_SOFT_MAX = 3602；
  • DISTANCE_LIMIT_COST_AFTER_SOFT_MAX_WITHOUT_SOFT_MAX = 3603；
  • DISTANCE_LIMIT_NEGATIVE_MAX = 3604；
  • DISTANCE_LIMIT_NEGATIVE_SOFT_MAX = 3605；
  • DISTANCE_LIMIT_SOFT_MAX_LARGER_THAN_MAX = 3606；
• DURATION_LIMIT_ERROR = 38；
  • DURATION_LIMIT_MAX_DURATION_NEGATIVE_OR_NAN = 3800；
  • DURATION_LIMIT_SOFT_MAX_DURATION_NEGATIVE_OR_NAN = 3801；
  • DURATION_LIMIT_INVALID_COST_PER_HOUR_AFTER_SOFT_MAX = 3802；
  • DURATION_LIMIT_SOFT_MAX_WITHOUT_COST_AFTER_SOFT_MAX = 3803；
  • DURATION_LIMIT_COST_AFTER_SOFT_MAX_WITHOUT_SOFT_MAX = 3804；
  • DURATION_LIMIT_QUADRATIC_SOFT_MAX_DURATION_NEGATIVE_OR_NAN = 3805；
  • DURATION_LIMIT_INVALID_COST_AFTER_QUADRATIC_SOFT_MAX = 3806；
  • DURATION_LIMIT_QUADRATIC_SOFT_MAX_WITHOUT_COST_PER_SQUARE_HOUR = 3807；
  • DURATION_LIMIT_COST_PER_SQUARE_HOUR_WITHOUT_QUADRATIC_SOFT_MAX = 3808；
  • DURATION_LIMIT_QUADRATIC_SOFT_MAX_WITHOUT_MAX = 3809；
  • DURATION_LIMIT_SOFT_MAX_LARGER_THAN_MAX = 3810；
  • DURATION_LIMIT_QUADRATIC_SOFT_MAX_LARGER_THAN_MAX = 3811；
  • DURATION_LIMIT_DIFF_BETWEEN_MAX_AND_QUADRATIC_SOFT_MAX_TOO_LARGE = 3812；
  • DURATION_LIMIT_MAX_DURATION_EXCEEDS_GLOBAL_DURATION = 3813；
  • DURATION_LIMIT_SOFT_MAX_DURATION_EXCEEDS_GLOBAL_DURATION = 3814；
  • DURATION_LIMIT_QUADRATIC_SOFT_MAX_DURATION_EXCEEDS_GLOBAL_DURATION = 3815；
• SHIPMENT_ERROR = 40；
  • SHIPMENT_PD_LIMIT_WITHOUT_PICKUP_AND_DELIVERY = 4014；
  • SHIPMENT_PD_ABSOLUTE_DETOUR_LIMIT_DURATION_NEGATIVE_OR_NAN = 4000；
  • SHIPMENT_PD_ABSOLUTE_DETOUR_LIMIT_DURATION_EXCEEDS_GLOBAL_DURATION = 4001；
  • SHIPMENT_PD_RELATIVE_DETOUR_LIMIT_INVALID = 4015；
  • SHIPMENT_PD_DETOUR_LIMIT_AND_EXTRA_VISIT_DURATION = 4016；
  • SHIPMENT_PD_TIME_LIMIT_DURATION_NEGATIVE_OR_NAN = 4002；
  • SHIPMENT_PD_TIME_LIMIT_DURATION_EXCEEDS_GLOBAL_DURATION = 4003；
  • SHIPMENT_EMPTY_SHIPMENT_TYPE = 4004；
  • SHIPMENT_NO_PICKUP_NO_DELIVERY = 4005；
  • SHIPMENT_INVALID_PENALTY_COST = 4006；
  • SHIPMENT_ALLOWED_VEHICLE_INDEX_OUT_OF_BOUNDS = 4007；
  • SHIPMENT_DUPLICATE_ALLOWED_VEHICLE_INDEX = 4008；
  • SHIPMENT_INCONSISTENT_COST_FOR_VEHICLE_SIZE_WITHOUT_INDEX = 4009；
  • SHIPMENT_INCONSISTENT_COST_FOR_VEHICLE_SIZE_WITH_INDEX = 4010；
  • SHIPMENT_INVALID_COST_FOR_VEHICLE = 4011；
  • SHIPMENT_COST_FOR_VEHICLE_INDEX_OUT_OF_BOUNDS = 4012；
  • SHIPMENT_DUPLICATE_COST_FOR_VEHICLE_INDEX = 4013；
• VEHICLE_ERROR = 42；
  • VEHICLE_EMPTY_REQUIRED_OPERATOR_TYPE = 4200；
  • VEHICLE_DUPLICATE_REQUIRED_OPERATOR_TYPE = 4201；
  • VEHICLE_NO_OPERATOR_WITH_REQUIRED_OPERATOR_TYPE = 4202；
  • VEHICLE_EMPTY_START_TAG = 4203；
  • VEHICLE_DUPLICATE_START_TAG = 4204；
  • VEHICLE_EMPTY_END_TAG = 4205；
  • VEHICLE_DUPLICATE_END_TAG = 4206；
  • VEHICLE_EXTRA_VISIT_DURATION_NEGATIVE_OR_NAN = 4207；
  • VEHICLE_EXTRA_VISIT_DURATION_EXCEEDS_GLOBAL_DURATION = 4208；
  • VEHICLE_EXTRA_VISIT_DURATION_EMPTY_KEY = 4209；
  • VEHICLE_FIRST_SHIPMENT_INDEX_OUT_OF_BOUNDS = 4210；
  • VEHICLE_FIRST_SHIPMENT_IGNORED = 4211；
  • VEHICLE_FIRST_SHIPMENT_NOT_BOUND = 4212；
  • VEHICLE_LAST_SHIPMENT_INDEX_OUT_OF_BOUNDS = 4213；
  • VEHICLE_LAST_SHIPMENT_IGNORED = 4214；
  • VEHICLE_LAST_SHIPMENT_NOT_BOUND = 4215；
  • VEHICLE_IGNORED_WITH_USED_IF_ROUTE_IS_EMPTY = 4216；
  • VEHICLE_INVALID_COST_PER_KILOMETER = 4217；
  • VEHICLE_INVALID_COST_PER_HOUR = 4218；
  • VEHICLE_INVALID_COST_PER_TRAVELED_HOUR = 4219；
  • VEHICLE_INVALID_FIXED_COST = 4220；
  • VEHICLE_INVALID_TRAVEL_DURATION_MULTIPLE = 4221；
  • VEHICLE_TRAVEL_DURATION_MULTIPLE_WITH_SHIPMENT_PD_DETOUR_LIMITS = 4223；
  • VEHICLE_MATRIX_INDEX_WITH_SHIPMENT_PD_DETOUR_LIMITS = 4224；
  • VEHICLE_MINIMUM_DURATION_LONGER_THAN_DURATION_LIMIT = 4222；
• VISIT_REQUEST_ERROR = 44；
  • VISIT_REQUEST_EMPTY_TAG = 4400；
  • VISIT_REQUEST_DUPLICATE_TAG = 4401；
  • VISIT_REQUEST_DURATION_NEGATIVE_OR_NAN = 4404；
  • VISIT_REQUEST_DURATION_EXCEEDS_GLOBAL_DURATION = 4405；
• PRECEDENCE_ERROR = 46；
• BREAK_ERROR = 48；
  • BREAK_RULE_EMPTY = 4800；
  • BREAK_REQUEST_UNSPECIFIED_DURATION = 4801；
  • BREAK_REQUEST_UNSPECIFIED_EARLIEST_START_TIME = 4802；
  • BREAK_REQUEST_UNSPECIFIED_LATEST_START_TIME = 4803；
  • BREAK_REQUEST_DURATION_NEGATIVE_OR_NAN = 4804；= 4804；
  • BREAK_REQUEST_LATEST_START_TIME_BEFORE_EARLIEST_START_TIME = 4805；
  • BREAK_REQUEST_EARLIEST_START_TIME_BEFORE_GLOBAL_START_TIME = 4806；
  • BREAK_REQUEST_LATEST_END_TIME_AFTER_GLOBAL_END_TIME = 4807；
  • BREAK_REQUEST_NON_SCHEDULABLE = 4808；
  • BREAK_FREQUENCY_MAX_INTER_BREAK_DURATION_NEGATIVE_OR_NAN = 4809；
  • BREAK_FREQUENCY_MIN_BREAK_DURATION_NEGATIVE_OR_NAN = 4810；
  • BREAK_FREQUENCY_MIN_BREAK_DURATION_EXCEEDS_GLOBAL_DURATION = 4811；
  • BREAK_FREQUENCY_MAX_INTER_BREAK_DURATION_EXCEEDS_GLOBAL_DURATION = 4812；
  • BREAK_REQUEST_DURATION_EXCEEDS_GLOBAL_DURATION = 4813；
  • BREAK_FREQUENCY_MISSING_MAX_INTER_BREAK_DURATION = 4814；
  • BREAK_FREQUENCY_MISSING_MIN_BREAK_DURATION = 4815；
• SHIPMENT_TYPE_INCOMPATIBILITY_ERROR = 50；
  • SHIPMENT_TYPE_INCOMPATIBILITY_EMPTY_TYPE = 5001；
  • SHIPMENT_TYPE_INCOMPATIBILITY_LESS_THAN_TWO_TYPES = 5002；
  • SHIPMENT_TYPE_INCOMPATIBILITY_DUPLICATE_TYPE = 5003；
  • SHIPMENT_TYPE_INCOMPATIBILITY_INVALID_INCOMPATIBILITY_MODE = 5004；
  • SHIPMENT_TYPE_INCOMPATIBILITY_TOO_MANY_INCOMPATIBILITIES = 5005；
• SHIPMENT_TYPE_REQUIREMENT_ERROR = 52；
  • SHIPMENT_TYPE_REQUIREMENT_NO_REQUIRED_TYPE = 52001；
  • SHIPMENT_TYPE_REQUIREMENT_NO_DEPENDENT_TYPE = 52002；
  • SHIPMENT_TYPE_REQUIREMENT_INVALID_REQUIREMENT_MODE = 52003；
  • SHIPMENT_TYPE_REQUIREMENT_TOO_MANY_REQUIREMENTS = 52004；
  • SHIPMENT_TYPE_REQUIREMENT_EMPTY_REQUIRED_TYPE = 52005；
  • SHIPMENT_TYPE_REQUIREMENT_DUPLICATE_REQUIRED_TYPE = 52006；
  • SHIPMENT_TYPE_REQUIREMENT_NO_REQUIRED_TYPE_FOUND = 52007；
  • SHIPMENT_TYPE_REQUIREMENT_EMPTY_DEPENDENT_TYPE = 52008；
  • SHIPMENT_TYPE_REQUIREMENT_DUPLICATE_DEPENDENT_TYPE = 52009；
  • SHIPMENT_TYPE_REQUIREMENT_SELF_DEPENDENT_TYPE = 52010；
  • SHIPMENT_TYPE_REQUIREMENT_GRAPH_HAS_CYCLES = 52011；
• VEHICLE_OPERATOR_ERROR = 54；
  • VEHICLE_OPERATOR_EMPTY_TYPE = 5400；
  • VEHICLE_OPERATOR_MULTIPLE_START_TIME_WINDOWS = 5401；
  • VEHICLE_OPERATOR_SOFT_START_TIME_WINDOW = 5402；
  • VEHICLE_OPERATOR_MULTIPLE_END_TIME_WINDOWS = 5403；
  • VEHICLE_OPERATOR_SOFT_END_TIME_WINDOW = 5404；
• DURATION_SECONDS_MATRIX_ERROR = 56；
  • DURATION_SECONDS_MATRIX_DURATION_NEGATIVE_OR_NAN = 5600；
  • DURATION_SECONDS_MATRIX_DURATION_EXCEEDS_GLOBAL_DURATION = 5601；

string

錯誤顯示名稱。

FieldReference

錯誤內容可能包含 0、1 (大多數時間) 或多個欄位。舉例來說，參照第 4 號車輛和第 2 批第 2 項取貨方式可按照以下方式完成：

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

不過請注意，特定錯誤代碼不會變更 fields 的基數。

string

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

STABILITY：不穩定：與指定 code 相關聯的錯誤訊息可能會隨時間改變 (希望釐清情況)。請改用 display_name 和 code。

string

可能包含欄位值。您不一定每次都能使用這個代碼。因此，建議您不要仰賴此演算法，並僅用於手動模型偵錯。

string

欄位名稱，例如「車輛」。

FieldReference

視需要以遞迴方式建立子欄位。

int32

欄位的索引 (如果重複)。

string

如果欄位是對應，則傳回 鍵。

DataFormat

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

GcsDestination

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

string

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

VisitRequest

與出貨相關的取貨替代選項組合。如未指定，車輛只需造訪與配送項目對應的地點。

VisitRequest

與出貨相關的提交替代方案。如未指定，車輛只需造訪與上車地點對應的地點。

map<string, Load>

貨物負載 (例如重量、體積、棧板數量等)。圖中的鍵應為用來說明對應負載類型的 ID，最好也包含單位。例如：「weight_kg」、「volume_gallons」、「pallet_count」等。如果指定鍵未顯示在地圖上，則相應的載入項目會視為空值。

int32

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

double

指定每輛車出貨時的運費。指定的變數必須包含 EITHER：

• 等同 costs_per_vehicle_indices 的元素數量。costs_per_vehicle[i] 對應模型的車輛 costs_per_vehicle_indices[i]。
• 與模型中車輛數量相同的元素數量i-th 元素會對應至模型的車輛 #i。

這些費用的單位必須與「penalty_cost」相同，且不得為負數。如果沒有這類費用，請將這個欄位留白。

int32

適用 costs_per_vehicle 的車輛索引。如果為非空白，則元素數量必須與 costs_per_vehicle 相同。車輛索引只能指定一次。如果從costs_per_vehicle_indices中排除車輛，費用為零。

Duration

指定從上車到貨運之間的最短路徑等待時間。若有指定，其必須為非負數，且運送必須包含至少一項取貨和送貨服務。

舉例來說，如果從選定的取貨替代服務直接改為配送至所選配送方式，最早需要多久時間才能處理完畢。接著設定 pickup_to_delivery_absolute_detour_limit 會強制執行：

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

如果同一運送屬性同時指定了相對和絕對限制，則每個取貨/外送組合使用的限制越多。截至 2017 年 10 月 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

指定從自取到貨品送達的最短路徑出發時間的最長相對繞路時間。若有指定，其必須為非負數，且運送必須包含至少一項取貨和送貨服務。

舉例來說，如果從選定的取貨替代服務直接改為配送至所選配送方式，最早需要多久時間才能處理完畢。接著設定 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 月 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。

Shipment

必須在模型中執行的一組貨運組合。

Vehicle

可用來進行造訪的車輛組合。

Timestamp

模型的全球開始時間和結束時間：超出範圍的時間一律視為有效。

模型的時間範圍必須少於一年，即 global_end_time 和 global_start_time 彼此不得超過 31536000 秒。

使用 cost_per_*hour 欄位時，建議您將這個時間範圍設為較短的間隔，藉此提升成效 (例如，如果為一天建立作業，請將全域時間限制設為該日)。如未設定，1970 年 1 月 1 日 00:00:00 (世界標準時間) 將預設為 0，nanos: 0。

Timestamp

如未設定，1971 年 1 月 1 日世界標準時間 00:00:00 (也就是秒數：31536000，nanos: 0) 會做為預設值。

double

「全球時間長度」是指所有車輛最早生效開始時間與最晚有效結束時間之間的差距。舉例來說，使用者可以為該數量設定每小時費用，以針對最快完成的工作進行最佳化。這個費用的單位必須與 Shipment.penalty_cost 相同。

DurationDistanceMatrix

指定模型中使用的持續時間和距離矩陣。如果這個欄位空白，系統會根據 use_geodesic_distances 欄位的值，改用 Google 地圖或測地距離。如果留空，use_geodesic_distances 不得為 true，duration_distance_matrix_src_tags 和 duration_distance_matrix_dst_tags 都不得留空。

使用範例：

• 其中有兩個位置：locA 和 locB。
• 1 輛車從 locA 開始行駛，並於 locA 結束。
• 1 個位於 locB 的取件造訪要求。

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 結束。
• 1 輛車以 locB 開始路線，並於 locB 結束，使用矩陣「慢速」。
• 1 輛車以 locB 起點開始路線，並使用「快速」矩陣於 locB 結束。
• 1 個位於 locC 的取貨要求。

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) 會在矩陣 i 中，定義從代碼 duration_distance_matrix_src_tags(j) 到其他造訪地點的持續時間和距離。

標記會對應至 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)) 矩陣 i. 使用標記 duration_distance_matrix_src_tags(j)，以標記 duration_distance_matrix_dst_tags(k) 的方式，指出行程從造訪到造訪的持續時間 (以距離為準)。

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

TransitionAttributes

已新增至模型的轉場屬性。

ShipmentTypeIncompatibility

不相容的 shipping_types 組合 (請參閱 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 一樣多。

bool

表示是否為「第一個」就是一項外送服務

bool

表示是否為「秒」就是一項外送服務

Duration

「第一個」值之間的偏移和「second」活動。可以是負值。

int32

「第一個」的運送索引活動。必須指定此欄位。

int32

「第二」的運送索引活動。必須指定此欄位。

int32

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

string

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

Timestamp

車輛開始行駛的時間。

Timestamp

車輛完成路線的時間。

Visit

代表路線的已排序造訪序列。Visit [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)，因此抵達 next_visit 的機率可能會晚於目前的時間範圍。此外，交通時間預估值和造訪/休息時間限制都增加，可能因而迫使休息時間與造訪地點重疊。

EncodedPolyline

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

Break

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

AggregatedMetrics

這條路線的時長、距離和載入指標。系統會根據結構定義，為所有 ShipmentRoute.transitions 或 ShipmentRoute.visits 欄位加總 AggregatedMetrics 的欄位。

map<string, double>

路線費用，按照費用相關要求欄位細分。這些鍵是 proto 路徑，相對於輸入的 OptimizeToursRequest，例如：「model.shipments.pickups.cost」和「模型」的值則為相對應費用欄位產生的總費用，並匯總在整條路線上。換句話說，成本 ["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 時，系統才會填入這個欄位。

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.label 副本 (如果在 Shipment 中指定)。

string

對應的 VisitRequest.label 副本 (如果在 VisitRequest 中指定)。

string

不相容類型的清單。兩件出貨各有不同的 shipment_types 為「不相容」。

IncompatibilityMode

模式套用至不相容。

string

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

string

凡是 dependent_shipment_types 欄位中具有類型的運送商品，都必須在同一條路線上運送至少一項 required_shipment_type_alternatives 類型的貨品。

注意：系統不允許 shipment_type 依附於自身的需求鏈結。

RequirementMode

為需求套用的模式。

int32

這個索引對應到來源 ShipmentModel 中的運送索引。

string

對應的 Shipment.label 副本 (如果在 Shipment 中指定)。

Reason

說明略過出貨的原因。請參閱 Reason 上方的註解。

Code

請參閱程式碼的註解。

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

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

TravelMode

交通方式會影響車輛可使用的道路和速度。另請參閱 travel_duration_multiple。

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 中回報的距離，不適用於從 arrival_location 間接行駛到單一 VisitRequest 的 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 字串到時間長度的對應。時間長度除了 VisitRequest.duration 以外，還達到指定 visit_types 時所需的時間長度。若指定 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

可接受的負載量上限。

int64

可接受的最低負載。必須大於 0。如果同時指定兩者，min 值必須 ≤ max。

int64

可接受的負載上限。必須大於 0。如果未指定，則此訊息不會限制載入量上限。如果同時指定兩者，min 值必須 ≤ max。

bool

選用設定。表示這個路線控點的位置是用來指定車輛在特定側面停靠的位置。設定這個值後，路線就會通過位置，這樣車輛就能在道路側停靠，該位置是從道路中心偏離位置。這個選項不適用於「WALKING」交通方式。

Location

使用地理座標指定的點，包含選擇性的方向。

string

與路線控點相關聯的搜尋點地點 ID。