OptimizeToursResponse

Phản hồi sau khi giải quyết vấn đề tối ưu hoá chuyến đi, trong đó có các tuyến đường mà mỗi xe tuân theo, các lô hàng đã bị bỏ qua và chi phí tổng thể của giải pháp.

Biểu diễn dưới dạng JSON 
{
  "routes": [
    {
      object (ShipmentRoute)
    }
  ],
  "requestLabel": string,
  "skippedShipments": [
    {
      object (SkippedShipment)
    }
  ],
  "validationErrors": [
    {
      object (OptimizeToursValidationError)
    }
  ],
  "metrics": {
    object (Metrics)
  }
}
Trường
routes[]

object (ShipmentRoute)

Các tuyến đường được tính toán cho mỗi xe; tuyến đường thứ i tương ứng với xe thứ i trong mô hình.
requestLabel

string

Bản sao của OptimizeToursRequest.label, nếu bạn đã chỉ định nhãn trong yêu cầu.
skippedShipments[]

object (SkippedShipment)

Danh sách tất cả các lô hàng bị bỏ qua.
validationErrors[]

object (OptimizeToursValidationError)

Danh sách tất cả lỗi xác thực mà chúng tôi có thể phát hiện một cách độc lập. Xem nội dung giải thích "MULTIPLE ERRORS" (Nhiều lỗi) cho thông báo OptimizeToursValidationError. Thay vì lỗi, thông báo này sẽ bao gồm cảnh báo trong trường hợp solvingMode là DEFAULT_SOLVE.
metrics

object (Metrics)

Chỉ số về thời lượng, khoảng cách và mức sử dụng của giải pháp này.

OptimizeToursValidationError

Mô tả lỗi hoặc cảnh báo gặp phải khi xác thực OptimizeToursRequest.

Biểu diễn dưới dạng JSON 
{
  "code": integer,
  "displayName": string,
  "fields": [
    {
      object (FieldReference)
    }
  ],
  "errorMessage": string,
  "offendingValues": string
}
Trường
code

integer

Lỗi xác thực được xác định bằng cặp (code, displayName) luôn xuất hiện.

Các trường sau phần này cung cấp thêm thông tin về lỗi.

MULTIPLE ERRORS (NHIỀU LỖI): Khi có nhiều lỗi, quy trình xác thực sẽ cố gắng xuất ra một số lỗi. Tương tự như trình biên dịch, đây là một quy trình không hoàn hảo. Một số lỗi xác thực sẽ là "lỗi nghiêm trọng", nghĩa là các lỗi này sẽ dừng toàn bộ quá trình xác thực. Đây là trường hợp của các lỗi displayName="UNSPECIFIED", v.v. Một số lỗi có thể khiến quá trình xác thực bỏ qua các lỗi khác.

TÍNH ỔN ĐỊNH: code và displayName phải rất ổn định. Tuy nhiên, các mã và tên hiển thị mới có thể xuất hiện theo thời gian, điều này có thể khiến một yêu cầu (không hợp lệ) nhất định tạo ra một cặp (code, displayName) khác vì lỗi mới đã ẩn lỗi cũ. Ví dụ: hãy xem "MULTIPLE ERRORS" (Nhiều lỗi).
displayName

string

Tên hiển thị lỗi.
fields[]

object (FieldReference)

Ngữ cảnh lỗi có thể liên quan đến 0, 1 (trong hầu hết trường hợp) hoặc nhiều trường. Ví dụ: tham khảo xe #4 và lượt lấy hàng đầu tiên của lô hàng #2 như sau:

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

Tuy nhiên, lưu ý rằng số lượng giá trị riêng biệt của fields không được thay đổi đối với một mã lỗi nhất định.
errorMessage

string

Chuỗi ký tự mà con người đọc được, dùng để mô tả lỗi. Có mối liên kết 1:1 giữa code và errorMessage (khi code != "UNSPECIFIED").

STABILITY (ỔN ĐỊNH): Không ổn định: thông báo lỗi liên kết với một code nhất định có thể thay đổi theo thời gian (hy vọng là để làm rõ thông báo đó). Thay vào đó, vui lòng sử dụng displayName và code.
offendingValues

string

Có thể chứa(các) giá trị của(các) trường. Tính năng này không phải lúc nào cũng có. Bạn tuyệt đối không nên dựa vào tính năng này và chỉ nên sử dụng tính năng này để gỡ lỗi mô hình theo cách thủ công.

FieldReference

Chỉ định ngữ cảnh cho lỗi xác thực. FieldReference luôn tham chiếu đến một trường nhất định trong tệp này và tuân theo cùng một cấu trúc phân cấp. Ví dụ: chúng ta có thể chỉ định phần tử #2 của startTimeWindows của xe #5 bằng cách sử dụng:

name: "vehicles" index: 5 subField { name: "endTimeWindows" index: 2 }

Tuy nhiên, chúng ta bỏ qua các thực thể cấp cao nhất như OptimizeToursRequest hoặc ShipmentModel để tránh làm rối thông báo.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "subField": {
    object (FieldReference)
  },

  // Union field index_or_key can be only one of the following:
  "index": integer,
  "key": string
  // End of list of possible types for union field index_or_key.
}
Trường
name

string

Tên trường, ví dụ: "vehicles".
subField

object (FieldReference)

Trường con lồng nhau đệ quy, nếu cần.

Trường hợp hợp nhất index_or_key.

index_or_key chỉ có thể là một trong những loại sau:
index

integer

Chỉ mục của trường nếu lặp lại.
key

string

Khoá nếu trường là một bản đồ.

Chỉ số

Chỉ số tổng thể, được tổng hợp trên tất cả các tuyến.

Biểu diễn dưới dạng JSON 
{
  "aggregatedRouteMetrics": {
    object (AggregatedMetrics)
  },
  "skippedMandatoryShipmentCount": integer,
  "usedVehicleCount": integer,
  "earliestVehicleStartTime": string,
  "latestVehicleEndTime": string,
  "costs": {
    string: number,
    ...
  },
  "totalCost": number
}
Trường
aggregatedRouteMetrics

object (AggregatedMetrics)

Tổng hợp trên các tuyến đường. Mỗi chỉ số là tổng (hoặc tối đa, đối với tải) trên tất cả các trường ShipmentRoute.metrics có cùng tên.
skippedMandatoryShipmentCount

integer

Số lượng lô hàng bắt buộc bị bỏ qua.
usedVehicleCount

integer

Số lượng xe được sử dụng. Lưu ý: nếu tuyến xe trống và Vehicle.used_if_route_is_empty là true, thì xe được coi là đã qua sử dụng.
earliestVehicleStartTime

string (Timestamp format)

Thời gian bắt đầu sớm nhất của một xe đã qua sử dụng, được tính là giá trị tối thiểu trên tất cả xe đã qua sử dụng của ShipmentRoute.vehicle_start_time.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
latestVehicleEndTime

string (Timestamp format)

Thời gian kết thúc mới nhất của một xe đã qua sử dụng, được tính là giá trị tối đa trên tất cả xe đã qua sử dụng của ShipmentRoute.vehicle_end_time.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
costs

map (key: string, value: number)

Chi phí của giải pháp, được phân tích theo các trường yêu cầu liên quan đến chi phí. Các khoá là đường dẫn proto, tương ứng với OptimizeToursRequest đầu vào, ví dụ: "model.shipments.pickups.cost" và các giá trị là tổng chi phí do trường chi phí tương ứng tạo ra, được tổng hợp trên toàn bộ giải pháp. Nói cách khác, costs["model.shipments.pickups.cost"] là tổng chi phí lấy hàng trên giải pháp. Tất cả chi phí được xác định trong mô hình đều được báo cáo chi tiết tại đây, ngoại trừ chi phí liên quan đến TransitionAttributes chỉ được báo cáo theo cách tổng hợp kể từ ngày 1/1/2022.
totalCost

number

Tổng chi phí của giải pháp. Tổng của tất cả các giá trị trong bản đồ chi phí.