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ỏ 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 "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)

Các chỉ số về thời lượng, quãng đường và mức sử dụng cho 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 do cặp (code, displayName) luôn xuất hiện xác định.

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. Giống 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ẽ có trạng thái "nghiêm trọng", nghĩa là khiến toàn bộ quá trình xác thực bị ngừng. Đây là trường hợp của lỗi displayName="UNSPECIFIED", trong số các lỗi khác. 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ĂNG: 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ụ: xem "MULTIPLE ERRORS".
displayName

string

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

object (FieldReference)

Ngữ cảnh lỗi có thể bao gồm 0, 1 (trong hầu hết trường hợp) hoặc nhiều trường. Ví dụ: Khi tham chiếu đến xe số 4 và lần đến lấy hàng đầu tiên của lô hàng số 2, bạn có thể làm như sau:

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

Tuy nhiên, hãy 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. Không phải lúc nào bạn cũng có thể sử dụng những tính năng này. Bạn tuyệt đối không nên dựa vào và chỉ 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 tôi có thể chỉ định phần tử số 2 của startTimeWindows của xe số 5 bằng cách sử dụng:

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

Tuy nhiên, chúng tôi sẽ bỏ qua các thực thể cấp cao nhất như OptimizeToursRequest hoặc ShipmentModel để tránh nhồi nhét 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 của trường, ví dụ: "phương tiện vận chuyển".
subField

object (FieldReference)

Trường phụ lồng nhau theo quy tắc đệ quy, nếu cần.

Trường kết hợp index_or_key.

index_or_key chỉ có thể là một trong những trạng thái sau đây:
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 đường.

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 lượt 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 đã sử dụng. Lưu ý: Nếu tuyến đường của xe trống và Vehicle.used_if_route_is_empty là đúng, thì xe đó sẽ được coi là đã 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 bằng thời gian tối thiểu của tất cả xe đã qua sử dụng là ShipmentRoute.vehicle_start_time.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. 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á này là đường dẫn proto, so với giá trị đầu vào OptimizeChuyếnsRequest (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ừ các 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í.