Package google.research.middlemileoptimization.v1

Chỉ mục

MiddleMileOptimization

Dịch vụ quản lý mạng lưới kho vận và định tuyến các lô hàng bên trong. Giao thức này phi trạng thái (thông báo độc lập), mặc dù dịch vụ phía sau nó mang tính trạng thái cao (việc nhận được thông báo có thể làm thay đổi đáng kể tin nhắn trả lời đối với nhiều phương thức, chẳng hạn như việc định tuyến một lô hàng có thể làm thay đổi việc định tuyến các lô hàng khác).

CommitPath

rpc CommitPath(CommitPathRequest) returns (Path)

Thực hiện lộ trình của lô hàng, cho biết rằng hành trình vận chuyển đó không thể thay đổi trong tương lai, ngay cả do người dùng, dành cho trường hợp bất khả kháng/hành động của chúa trời được chỉ định bằng các phương thức Make xeAvailable, MakeHubAvailable, MakeLineUpdated (Không có sẵn). Phương thức này không dùng để gắn thẻ một bản sửa đổi cụ thể của đường dẫn.
CreateHub

rpc CreateHub(CreateHubRequest) returns (Hub)

Tạo một Trung tâm.
CreateLine

rpc CreateLine(CreateLineRequest) returns (Line)

Tạo một đường.
CreateLineRotation

rpc CreateLineRotation(CreateLineRotationRequest) returns (LineRotation)

Tạo LineRotation.
CreateNetwork

rpc CreateNetwork(CreateNetworkRequest) returns (Network)

Tạo một mạng.
CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Tạo một chiếc xe.
DeleteHub

rpc DeleteHub(DeleteHubRequest) returns (Empty)

Xoá một Trung tâm.
DeleteLine

rpc DeleteLine(DeleteLineRequest) returns (Empty)

Xoá một đường.
DeleteLineRotation

rpc DeleteLineRotation(DeleteLineRotationRequest) returns (Empty)

Xoá một LineRotation.
DeleteNetwork

rpc DeleteNetwork(DeleteNetworkRequest) returns (Empty)

Xoá mạng.
DeleteShipment

rpc DeleteShipment(DeleteShipmentRequest) returns (Empty)

Xoá lô hàng.
DeleteVehicle

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

Xoá xe.
GetHub

rpc GetHub(GetHubRequest) returns (Hub)

Lấy thông tin chi tiết về một Trung tâm.
GetLine

rpc GetLine(GetLineRequest) returns (Line)

Lấy thông tin chi tiết về một Đường.
GetLineRotation

rpc GetLineRotation(GetLineRotationRequest) returns (LineRotation)

Lấy thông tin chi tiết về LineRotation.
GetNetwork

rpc GetNetwork(GetNetworkRequest) returns (Network)

Lấy thông tin chi tiết về một mạng.
GetShipment

rpc GetShipment(GetShipmentRequest) returns (Shipment)

Lấy thông tin chi tiết về lô hàng.
GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Lấy thông tin chi tiết về một chiếc xe.
ListHubs

rpc ListHubs(ListHubsRequest) returns (ListHubsResponse)

Liệt kê các Trung tâm.
ListLineRotations

rpc ListLineRotations(ListLineRotationsRequest) returns (ListLineRotationsResponse)

Liệt kê LineRotations.
ListLines

rpc ListLines(ListLinesRequest) returns (ListLinesResponse)

Liệt kê các dòng.
ListNetworks

rpc ListNetworks(ListNetworksRequest) returns (ListNetworksResponse)

Liệt kê mạng.
ListPaths

rpc ListPaths(ListPathsRequest) returns (ListPathsResponse)

Trả về tất cả đường dẫn hiện có sẵn. Phương pháp này hoàn toàn không thay đổi và không có tác dụng phụ.
ListShipments

rpc ListShipments(ListShipmentsRequest) returns (ListShipmentsResponse)

Liệt kê các lô hàng.
ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Liệt kê các phương tiện di chuyển.
MakeHubAvailable

rpc MakeHubAvailable(MakeHubAvailableRequest) returns (MakeHubAvailableResponse)

Cung cấp một trung tâm.
MakeHubUnavailable

rpc MakeHubUnavailable(MakeHubUnavailableRequest) returns (MakeHubUnavailableResponse)

Đặt một trung tâm không hoạt động.
MakeLineAvailable

rpc MakeLineAvailable(MakeLineAvailableRequest) returns (MakeLineAvailableResponse)

Cung cấp một đường dây.
MakeLineUnavailable

rpc MakeLineUnavailable(MakeLineUnavailableRequest) returns (MakeLineUnavailableResponse)

Làm cho một đường truyền không hoạt động.
MakeVehicleAvailable

rpc MakeVehicleAvailable(MakeVehicleAvailableRequest) returns (MakeVehicleAvailableResponse)

Cung cấp phương tiện di chuyển.
MakeVehicleUnavailable

rpc MakeVehicleUnavailable(MakeVehicleUnavailableRequest) returns (MakeVehicleUnavailableResponse)

Làm cho xe không hoạt động.
RouteShipment

rpc RouteShipment(RouteShipmentRequest) returns (RouteShipmentResponse)

Chuyển lô hàng mới. Thao tác này tương tự như thao tác tạo. Thao tác này ngụ ý việc thay đổi trạng thái.
UpdateHub

rpc UpdateHub(UpdateHubRequest) returns (Hub)

Cập nhật một Trung tâm.
UpdateLine

rpc UpdateLine(UpdateLineRequest) returns (Line)

Cập nhật một đường.
UpdateLineRotation

rpc UpdateLineRotation(UpdateLineRotationRequest) returns (LineRotation)

Cập nhật một LineRotation.
UpdateNetwork

rpc UpdateNetwork(UpdateNetworkRequest) returns (Network)

Cập nhật mạng.
UpdatePath

rpc UpdatePath(UpdatePathRequest) returns (Path)

Thay đổi đường dẫn của một lô hàng: thay vì sử dụng giá trị được tính toán theo dịch vụ, trạng thái sẽ chứa giá trị do người dùng đặt thông qua lệnh gọi này.
UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Cập nhật xe.

AnnotatedPathSegment

Biểu thị một phần của đường dẫn có nhiều thông tin thừa có thể tính toán được dựa trên PathSegment (Phân đoạn) chứa và Mạng. Những thông báo này thường được máy chủ API trả về.

Trường
segment

PathSegment

Bắt buộc. Phân đoạn đang được chú thích.
arrival_time

DateTime

Chỉ có đầu ra. Thời gian đến của đoạn đường này.
departure_time

DateTime

Chỉ có đầu ra. Thời gian khởi hành của chặng này.
is_committed

bool

Chỉ có đầu ra. Liệu khách hàng API có quyết định cam kết phần này của lộ trình hay không.
segment_cost_constant

double

Chỉ có đầu ra. Chi phí không đổi cho phân đoạn này.
segment_cost_due_to_vehicle

map<string, double>

Chỉ có đầu ra. Một mục nhập cho mỗi phương diện.
segment_cost_due_to_departure

double

Chỉ có đầu ra. Chi phí do việc xoay vòng tuyến: giờ khởi hành.
segment_cost_due_to_arrival

double

Chỉ có đầu ra. Chi phí do việc xoay vòng tuyến: đến.

CommitPathRequest

Thông báo yêu cầu cho phương thức CommitPath.

Trường
name

string

Bắt buộc. Tên của lô hàng có đường dẫn phải được cam kết. Định dạng: "networks/{network}/shipments/{shipment}"
Trường kết hợp path_to_commit. Đường dẫn hoặc các phần của đường dẫn cần được cam kết. path_to_commit chỉ có thể là một trong những trạng thái sau đây:
complete_shipment_path

PathToCommit

Các đoạn của đường dẫn từ một nguồn đến một đích đến.
segments

IncompletePathToCommit

Một tập hợp con gồm các đoạn của đường dẫn từ một nguồn đến một đích đến.

IncompletePathToCommit

Một phần của đường dẫn đang được cam kết, tức là một số đoạn giữa nguồn và đích đến.

Trường
segments[]

PathSegment

Bắt buộc. Một tập hợp con gồm các đoạn của đường dẫn từ một nguồn đến một đích đến.

PathToCommit

Đường dẫn đầy đủ được cam kết, từ nguồn đến đích.

Trường
segments[]

PathSegment

Bắt buộc. Các phân đoạn phải theo thứ tự, từ một nguồn đến một đích đến.

CreateHubRequest

Thông báo yêu cầu cho phương thức CreateHub.

Trường
parent

string

Bắt buộc. Tài nguyên chính nơi trung tâm này sẽ được tạo. Định dạng: "networks/{network}"
hub_id

string

Bắt buộc. Giá trị nhận dạng của trung tâm cần tạo.
hub

Hub

Bắt buộc. Trung tâm để sáng tạo.

CreateLineRequest

Thông báo yêu cầu cho phương thức CreateLine.

Trường
parent

string

Bắt buộc. Tài nguyên mẹ nơi dòng này sẽ được tạo. Định dạng: "networks/{network}"
line_id

string

Bắt buộc. Giá trị nhận dạng của dòng cần tạo.
line

Line

Bắt buộc. Dòng cần tạo.

CreateLineRotationRequest

Thông báo yêu cầu cho phương thức CreateLineRotation.

Trường
parent

string

Bắt buộc. Tài nguyên mẹ nơi chế độ xoay đường kẻ này sẽ được tạo. Định dạng: "networks/{network}/lines/{line}"
line_rotation_id

string

Bắt buộc. Giá trị nhận dạng của thao tác xoay đường kẻ cần tạo.
line_rotation

LineRotation

Bắt buộc. Xoay đường kẻ để tạo.

CreateNetworkRequest

Thông báo yêu cầu cho phương thức CreateNetwork.

Trường
network_id

string

Bắt buộc. Giá trị nhận dạng của mạng cần tạo.
network

Network

Bắt buộc. Mạng để tạo.

CreateVehicleRequest

Thông báo yêu cầu cho phương thức CreateVehicle.

Trường
parent

string

Bắt buộc. Tài nguyên chính nơi xe này sẽ được tạo. Định dạng: "networks/{network}"
vehicle_id

string

Bắt buộc. Mã nhận dạng của chiếc xe cần tạo.
vehicle

Vehicle

Bắt buộc. Phương tiện để tạo.

CrossDockingCapacity

Khả năng gắn kết chéo tổng thể của một thiết bị trung tâm.

Trường
capacity_per_hour[]

ValueDimension

Không bắt buộc. Khả năng gắn chéo cho mỗi kích thước.

CrossDockingTime

Tổng thời gian tích hợp chéo cho một thiết bị trung tâm.

Trường
time_constant

Duration

Không bắt buộc. Thời gian không đổi cho hoạt động gắn kết chéo.
time

SeparableNDFunction

Không bắt buộc. Khả năng tách biệt là một giả định đơn giản hoá.

DateTimeRange

Phạm vi thời gian giữa 2 DateTime. Đối với thời gian ngày theo điểm, hãy sử dụng bắt đầu == kết thúc.

google/type/interval.proto cũng có mục đích tương tự, nhưng với thời gian thực tế (chúng tôi chỉ quan tâm đến giờ dân sự).

Trường
first_date

DateTime

Bắt đầu dải ô.
last_date

DateTime

Hết phạm vi

DeleteHubRequest

Thông báo yêu cầu cho phương thức DeleteHub.

Trường
name

string

Bắt buộc. Tên của trung tâm cần xoá. Định dạng: "networks/{network}/hubs/{hub}"

DeleteLineRequest

Thông báo yêu cầu cho phương thức DeleteLine.

Trường
name

string

Bắt buộc. Tên của dòng cần xoá. Định dạng: "networks/{network}/lines/{line}"
force

bool

Không bắt buộc. Nếu bạn đặt chính sách này thành true, hãy xoá các tài nguyên con.

DeleteLineRotationRequest

Thông báo yêu cầu cho phương thức DeleteLineRotation.

Trường
name

string

Bắt buộc. Tên của việc xoay đường kẻ cần xoá. Định dạng: "networks/{network}/lines/{line}/rotations/{rotation}"

DeleteNetworkRequest

Thông báo yêu cầu cho phương thức DeleteNetwork.

Trường
name

string

Bắt buộc. Tên mạng cần xoá. Định dạng: "networks/{network}"
force

bool

Không bắt buộc. Nếu bạn đặt chính sách này thành true, hãy xoá các tài nguyên con.

DeleteShipmentRequest

Thông báo yêu cầu cho phương thức DeleteShipment.

Trường
name

string

Bắt buộc. Tên của lô hàng cần xoá. Định dạng: "networks/{network}/shipments/{shipment}"

DeleteVehicleRequest

Thông báo yêu cầu cho phương thức DeleteVehicle.

Trường
name

string

Bắt buộc. Tên xe cần xoá. Định dạng: "networks/{network}/vehicles/{vehicle}"

DistanceMatrixEntry

Khoảng cách giữa trung tâm nguồn và trung tâm đích.

Trường
source_hub

string

Bắt buộc. Trung tâm nguồn.
destination_hub

string

Bắt buộc. Trung tâm đích.
weights[]

ValueDimension

Bắt buộc. Khoảng cách giữa các trung tâm, được đo theo một số phương diện.

EarlinessTardiness

Các hàm chi phí do một lô hàng đến/di chuyển sớm hơn hoặc muộn hơn yêu cầu (giới hạn mềm).

Trường
maximum_earliness

Duration

Không bắt buộc. Mức độ tai nghe tối đa cho phép. Chỉ hữu ích với chi phí.
maximum_tardiness

Duration

Không bắt buộc. Thời gian trễ tối đa cho phép. Chỉ hữu ích với chi phí.
earliness_cost

Function1D

Không bắt buộc. Chi phí vệ sinh tai nghe. Huỷ đặt nếu không mất phí đối với độ tai nghe.
tardiness_cost

Function1D

Không bắt buộc. Chi phí trễ hạn. Huỷ đặt iff không mất phí cho việc chậm trễ.

Hàm 1D

Hàm của một đối số.

Trường
Trường kết hợp function. Tính thống nhất của đối số của hàm được cho là: - nếu trọng lượng: kg - nếu thời gian: tối thiểu - nếu số lượng pallet: 1 function chỉ có thể là một trong các giá trị sau:
constant

double

Hàm là một hằng số.
pwl

PieceWiseAffineFunction

Hàm này mang tính tuyến tính từng phần.

GeneratedLineAndRotation

Một vòng xoay của một dòng do API này tạo chứ không phải ứng dụng khách API. API này vốn ít bị hạn chế hơn và có thể sử dụng bất kỳ phương tiện nào (trừ phi khách hàng API có quyết định khác trong các lệnh gọi tiếp theo).

Trường
arrival_times

map<string, DateTime>

Chỉ có đầu ra. Liên kết giữa mã trung tâm và thời gian. Bản đồ này phải có cùng các khoá (trừ trung tâm nguồn, không có thời gian đến).
departure_times

map<string, DateTime>

Chỉ có đầu ra. Liên kết giữa mã trung tâm và thời gian. Bản đồ này phải có cùng các khoá (trừ đi trung tâm điểm đến, không có thời gian khởi hành).

GetHubRequest

Thông báo yêu cầu cho phương thức GetHub.

Trường
name

string

Bắt buộc. Tên của trung tâm cần truy xuất. Định dạng: "networks/{network}/hubs/{hub}"

GetLineRequest

Thông báo yêu cầu cho phương thức GetLine.

Trường
name

string

Bắt buộc. Tên mạng cần truy xuất. Định dạng: "networks/{network}/lines/{line}"

GetLineRotationRequest

Thông báo yêu cầu cho phương thức GetLineRotation.

Trường
name

string

Bắt buộc. Tên của việc xoay dòng cần truy xuất. Định dạng: "networks/{network}/lines/{line}/rotations/{rotation}"

GetNetworkRequest

Thông báo yêu cầu cho phương thức GetNetwork.

Trường
name

string

Bắt buộc. Tên mạng cần truy xuất. Định dạng: "networks/{network}"

GetShipmentRequest

Thông báo yêu cầu cho phương thức GetShipment.

Trường
name

string

Bắt buộc. Tên lô hàng cần truy xuất. Định dạng: "networks/{network}/shipments/{shipment}"

GetVehicleRequest

Thông báo yêu cầu cho phương thức GetVehicle.

Trường
name

string

Bắt buộc. Tên xe cần truy xuất. Định dạng: "networks/{network}/vehicles/{vehicle}"

Bổ trợ

Các gói hàng phải được đưa từ một trung tâm này tới một trung tâm khác.

Trường
name

string

Bắt buộc. Giá trị nhận dạng. Không cập nhật được.
position

LatLng

Không bắt buộc. Vị trí để tính toán đường dẫn thực tế.
opening_times[]

DateTimeRange

Bắt buộc. Giờ mở cửa. Hiện tại, hãy sử dụng cách trình bày sơ bộ: một mục nhập mỗi lần trung tâm mở cửa (nếu nhân viên của trung tâm nghỉ trưa và không có ai làm việc vào thời điểm đó, thì sẽ có hai mục nhập cho ngày đó).
cross_docking_capacity

CrossDockingCapacity

Không bắt buộc. Sức chứa của toàn bộ trung tâm.
cross_docking_time

CrossDockingTime

Không bắt buộc. Thời gian thực hiện một thao tác khi lên thuyền chéo (mỗi xe).

IntegerRange

Dải ô số nguyên.

Trường
start_value

int32

Khoảng thời gian sẽ mở nếu bạn không đặt.
end_value

int32

Khoảng thời gian sẽ mở nếu bạn không đặt.

Line

Đường dây hoạt động ở tần suất cụ thể.

Trường
name

string

Bắt buộc. Giá trị nhận dạng. Không cập nhật được.
hub_ids[]

string

Bắt buộc. Danh sách các trung tâm mà tuyến này ghé qua, theo thứ tự các phương tiện dừng tại các trung tâm đó.

LineRotation

Một chiếc xe bắt đầu vận hành đường dây này vào một thời điểm cụ thể.

Trường
name

string

Bắt buộc. Giá trị nhận dạng. Không cập nhật được.
arrival_times

map<string, DateTimeRange>

Không bắt buộc. Phạm vi cho phép khởi hành mà không tính phí (tức là nếu không theo điểm, thì thời gian đến thực tế sẽ do hệ thống quyết định). Bản đồ này phải có cùng các khoá (trừ trung tâm nguồn, không có thời gian đến).
departure_times

map<string, DateTimeRange>

Không bắt buộc. Phạm vi cho phép đến mà không tính phí (tức là nếu không theo điểm, thời gian khởi hành thực tế sẽ do hệ thống quyết định). Bản đồ này phải có cùng các khoá (trừ đi trung tâm điểm đến, không có thời gian khởi hành).
departure_earliness_tardiness_costs

map<string, EarlinessTardiness>

Không bắt buộc. Chi phí bảo trì/thời gian trễ và giới hạn thời gian khởi hành. Bản đồ này phải có cùng các khoá (trừ đi trung tâm điểm đến, không có thời gian khởi hành).
arrival_earliness_tardiness_costs

map<string, EarlinessTardiness>

Không bắt buộc. Chi phí bảo trì/thời gian trễ và giới hạn khi đến nơi. Bản đồ này phải có cùng các khoá (trừ trung tâm nguồn, không có thời gian đến).
vehicles[]

string

Không bắt buộc. Danh sách phương tiện có thể xoay tuyến đường này (tức là danh sách cho phép). Nếu số_xe giảm xuống còn một giá trị tương ứng với số lượng xe, thì tất cả các xe đó sẽ được chỉ định cho vòng xoay đường. Nếu không có xe nào, tất cả đều được coi là có sẵn.
fixed_price

PricingStrategy

Không bắt buộc. Chi phí để bất kỳ xe nào chạy trên tuyến này, bất kể xe là gì (tài xế, bảo dưỡng, v.v.).
maximum_number_vehicles

IntegerRange

Không bắt buộc. Số lượng xe tối đa có thể được chỉ định cho lượt xoay này. Nếu bạn không đặt chính sách này, thì sẽ không có giới hạn về số lượng phương tiện đối với vòng xoay này. Nếu không, giới hạn trên của số lượng phương tiện có thể được phân bổ cho chế độ xoay này (trong danh sách cho phép vehicle_ids). Cụ thể, giá trị 0 sẽ tắt chế độ xoay này (không cho phép xe).

ListHubsRequest

Thông báo yêu cầu cho phương thức ListHubs.

Trường
parent

string

Bắt buộc. Nhà xuất bản mẹ sở hữu bộ sưu tập trung tâm này. Định dạng: "networks/{network}"
page_size

int32

Không bắt buộc. Số lượng thiết bị trung tâm tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 50 trung tâm. Giá trị lớn nhất là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListHubs trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListHubs phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListHubsResponse

Thông báo phản hồi cho phương thức ListHubs.

Trường
hubs[]

Hub

Các trung tâm từ mạng được chỉ định.
next_page_token

string

Mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

ListLineRotationsRequest

Thông báo yêu cầu cho phương thức ListLineRotations.

Trường
parent

string

Bắt buộc. Nhà xuất bản mẹ sở hữu tập hợp xoay vòng dòng này. Định dạng: "networks/{network}/lines/{line}"
page_size

int32

Không bắt buộc. Số vòng xoay đường kẻ tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hàm sẽ trả về tối đa 50 LineRotations. Giá trị lớn nhất là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListLineRotations trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListLineRotations phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListLineRotationsResponse

Thông báo phản hồi cho phương thức ListLineRotations.

Trường
line_rotations[]

LineRotation

Đường thẳng xoay từ mạng và đường được chỉ định.
next_page_token

string

Mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

ListLinesRequest

Thông báo yêu cầu cho phương thức ListLines.

Trường
parent

string

Bắt buộc. Tệp mẹ sở hữu tập hợp các dòng này. Định dạng: "networks/{network}"
page_size

int32

Không bắt buộc. Số dòng tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định thì hệ thống sẽ trả về tối đa 50 dòng. Giá trị lớn nhất là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListLines trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListLines phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListLinesResponse

Thông báo phản hồi cho phương thức ListLines.

Trường
lines[]

Line

Các đường trong mạng được chỉ định.
next_page_token

string

Mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

ListNetworksRequest

Thông báo yêu cầu cho phương thức ListNetworks.

Trường
page_size

int32

Không bắt buộc. Số lượng mạng tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 50 mạng. Giá trị lớn nhất là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListNetworks trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListNetworks phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListNetworksResponse

Thông báo phản hồi cho phương thức ListNetworks.

Trường
networks[]

Network

Danh sách mạng truyền hình.
next_page_token

string

Mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

ListPathsRequest

Thông báo yêu cầu cho phương thức ListPaths.

Trường
parent

string

Bắt buộc. Tên của mạng mà đường dẫn phải được gửi. Định dạng: "networks/{network}"
page_size

int32

Không bắt buộc. Số lượng mạng tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 50 mạng. Giá trị lớn nhất là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListNetworks trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListNetworks phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListPathsResponse

Thông báo phản hồi cho phương thức ListPaths.

Trường
paths[]

Path

Danh sách đường dẫn.
next_page_token

string

Mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

ListShipmentsRequest

Thông báo yêu cầu cho phương thức ListShipments.

Trường
parent

string

Bắt buộc. Nhà xuất bản mẹ sở hữu tập hợp lô hàng này. Định dạng: "networks/{network}"
page_size

int32

Không bắt buộc. Số lượng lô hàng tối đa cần trả lại. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không xác định, đơn hàng sẽ trả lại tối đa 50 kiện hàng. Giá trị lớn nhất là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListShipments trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListShipments phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListShipmentsResponse

Thông báo phản hồi cho phương thức ListShipments.

Trường
shipments[]

Shipment

Các lô hàng từ mạng lưới được chỉ định.
next_page_token

string

Mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

ListVehiclesRequest

Thông báo yêu cầu cho phương thức ListVehicles.

Trường
parent

string

Bắt buộc. Nhà xuất bản mẹ sở hữu bộ sưu tập phương tiện này. Định dạng: "networks/{network}"
page_size

int32

Không bắt buộc. Số lượng phương tiện tối đa cần trả lại. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không xác định, chúng tôi sẽ trả lại tối đa 50 xe. Giá trị lớn nhất là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListVehicles trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListVehicles phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListVehiclesResponse

Thông báo phản hồi cho phương thức ListVehicles.

Trường
vehicles[]

Vehicle

Các phương tiện trong mạng được chỉ định.
next_page_token

string

Mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

MakeHubAvailableRequest

Thông báo yêu cầu cho phương thức MakeHubAvailable.

Trường
name

string

Bắt buộc. Tên của trung tâm sẽ được cung cấp. Định dạng: "networks/{network}/hubs/{hub}"
availability_starts[]

DateTime

Bắt buộc. Khoảng thời gian bắt đầu được cung cấp. Chúng phải là điểm trong thời gian trong tương lai. Nếu không có trường này, thì tình trạng rảnh/bận sẽ bắt đầu khi nhận được tin nhắn.

MakeHubAvailableResponse

Thông báo phản hồi cho phương thức MakeHubAvailable.

Trường
name

string

Tên của trung tâm không hoạt động đã được cập nhật. Định dạng: "networks/{network}/hubs/{hub}"
path[]

Path

Các đường dẫn đã được cập nhật.

MakeHubUnavailableRequest

Thông báo yêu cầu cho phương thức MakeHubUnavailable.

Trường
name

string

Bắt buộc. Tên của trung tâm sẽ không hoạt động. Định dạng: "networks/{network}/hubs/{hub}"
unavailability_starts[]

DateTime

Bắt buộc. Khoảng thời gian bắt đầu không có hàng. Chúng phải là điểm trong thời gian trong tương lai. Nếu không có trường này, thì tình trạng không có sẵn sẽ bắt đầu khi nhận được thông báo.

MakeHubUnavailableResponse

Thông báo phản hồi cho phương thức MakeHubUnavailable.

Trường
name

string

Tên của trung tâm không hoạt động đã được cập nhật. Định dạng: "networks/{network}/hubs/{hub}"
path[]

Path

Các đường dẫn đã được cập nhật.

MakeLineAvailableRequest

Thông báo yêu cầu cho phương thức MakeHubAvailable.

Trường
name

string

Bắt buộc. Tên của đường dây mà bạn muốn sử dụng. Định dạng: "networks/{network}/lines/{line}"
availability_starts[]

DateTime

Bắt buộc. Khoảng thời gian bắt đầu được cung cấp. Chúng phải là điểm trong thời gian trong tương lai. Nếu không có trường này, thì tình trạng rảnh/bận sẽ bắt đầu khi nhận được tin nhắn.

MakeLineAvailableResponse

Thông báo phản hồi cho phương thức MakeLineAvailable.

Trường
name

string

Tên của tuyến đường đã ngừng cung cấp dịch vụ. Định dạng: "networks/{network}/lines/{line}"
path[]

Path

Các đường dẫn đã được cập nhật.

MakeLineUnavailableRequest

Thông báo yêu cầu cho phương thức MakeLineUnavailable.

Trường
name

string

Bắt buộc. Tên của đường dây sẽ không sử dụng được. Định dạng: "networks/{network}/lines/{line}"
unavailability_starts[]

DateTime

Bắt buộc. Khoảng thời gian bắt đầu không có hàng. Chúng phải là điểm trong thời gian trong tương lai. Nếu không có trường này, thì tình trạng không có sẵn sẽ bắt đầu khi nhận được thông báo.

MakeLineUnavailableResponse

Thông báo phản hồi cho phương thức MakeLineUnavailable.

Trường
name

string

Tên của tuyến đường đã ngừng cung cấp dịch vụ. Định dạng: "networks/{network}/lines/{line}"
path[]

Path

Các đường dẫn đã được cập nhật.

MakeVehicleAvailableRequest

Thông báo yêu cầu cho phương thức MakeVehicleAvailable.

Trường
name

string

Bắt buộc. Tên của xe cần được cung cấp. Định dạng: "networks/{network}/vehicle/{vehicle}"
availability_starts[]

DateTime

Bắt buộc. Khoảng thời gian bắt đầu được cung cấp. Chúng phải là điểm trong thời gian trong tương lai. Nếu không có trường này, thì tình trạng rảnh/bận sẽ bắt đầu khi nhận được tin nhắn.

MakeVehicleAvailableResponse

Thông báo phản hồi cho phương thức MakeVehicleAvailable.

Trường
name

string

Tên của xe đã được cập nhật tình trạng còn hàng. Định dạng: "networks/{network}/vehicles/{vehicle}"
path[]

Path

Các đường dẫn đã được cập nhật.

MakeVehicleUnavailableRequest

Thông báo yêu cầu cho phương thức MakeVehicleUnavailable.

Trường
name

string

Bắt buộc. Không có tên xe. Định dạng: "networks/{network}/vehicles/{vehicle}"
unavailability_starts[]

DateTime

Bắt buộc. Khoảng thời gian bắt đầu không có hàng. Chúng phải là điểm trong thời gian trong tương lai. Nếu không có trường này, thì tình trạng không có sẵn sẽ bắt đầu khi nhận được thông báo.

MakeVehicleUnavailableResponse

Thông báo phản hồi cho phương thức MakeVehicleUnavailable.

Trường
name

string

Tên của xe không còn hàng đã được cập nhật. Định dạng: "networks/{network}/vehicles/{vehicle}"
path[]

Path

Các đường dẫn đã được cập nhật.

Mạng

Mô tả toàn bộ mạng hiện có có thể sử dụng. Một khách hàng API nhất định có thể có nhiều mạng (ví dụ: mạng chính và một sự sửa đổi có thể có trong tương lai để đánh giá).

Trường
name

string

Bắt buộc. Giá trị nhận dạng. Không cập nhật được.
dimensions[]

ValueDimension

Khoảng cách, trọng lượng, bảng hàng, v.v., cùng với tỷ lệ (để ánh xạ số thực dấu phẩy động tới số nguyên).
pricing

PricingStrategy

Không bắt buộc. Giá do người gửi thanh toán cho việc vận chuyển một lô hàng không yêu cầu có đường kẻ chuyên dụng.
currency_code

string

Không bắt buộc. Một đơn vị tiền tệ được sử dụng trên toàn mạng. Một khách hàng API nhất định có thể có một số đơn vị khác nhau cho các mạng khác nhau; một mạng chỉ được phép có một đơn vị tiền tệ. Đơn vị này phải được mã hoá theo ISO 4217, như google3/google/type/money.proto.
time_step

Duration

Không bắt buộc. Phân biệt thời gian. Các quyết định được đưa ra với độ chính xác này kịp thời. Trong nội bộ, trạng thái được giữ với độ chính xác này.
distance_matrix[]

DistanceMatrixEntry

Không bắt buộc. Ma trận khoảng cách (biểu thị một danh sách các cạnh có hướng có trọng số).

Đường dẫn

Đường dẫn của lô hàng trong mạng lưới.

Trường
shipment

string

Bắt buộc. Lô hàng có đường đi đang được mô tả.
segments[]

AnnotatedPathSegment

Bắt buộc. Các phân đoạn của đường dẫn.
departure_time

DateTime

Chỉ có đầu ra. Thời gian thực tế xuất phát của lô hàng.
arrival_time

DateTime

Chỉ có đầu ra. Thời gian đến thực tế của lô hàng.
incurred_penalties

double

Chỉ có đầu ra. Không tuân thủ các hình phạt do những quy tắc ràng buộc không bắt buộc.
cost_constant

double

Chỉ có đầu ra. Chi phí không đổi cho lô hàng này.
cost

map<string, double>

Chỉ có đầu ra. Chi phí theo thành phần.

PathSegment

Biểu thị một phần của đường dẫn, được khách hàng API gửi đến máy chủ API (ví dụ: thay đổi trạng thái) hoặc do máy chủ API gửi tới khách hàng API (ví dụ: định tuyến một gói hàng).

Trường
source_hub

string

Bắt buộc. Nguồn của phân khúc.
destination_hub

string

Bắt buộc. Đích đến của phân khúc.
line

string

Bắt buộc. Tuyến đang được theo dõi cho đoạn đường này.
line_rotation

string

Bắt buộc. Đang theo dõi vòng xoay cho phân đoạn này.
vehicle

string

Bắt buộc. Xe mà đoạn đường này chạy theo sau.

PieceWiseAffineFunction

Hàm tuyến tính từng mảnh, giới hạn trong một đối số. Thiết kế tương tự như https://github.com/google/or-tools/blob/stable/ortools/util/piecewise_linear_function.h

Trường
segments[]

PieceWiseAffineSegment

Đoạn tuyến tính của hàm.

PieceWiseAffineSegment

Một phân đoạn của hàm tuyến tính từng mảnh.

Trường
start_x

double

Đầu phân đoạn: x.
start_y

double

Đầu phân đoạn: y.
end_x

double

Kết thúc đoạn: x.
end_y

double

Kết thúc đoạn: y.

PricingStrategy

Chiến lược định giá.

Trường
Trường kết hợp pricing_strategy. Chiến lược định giá. pricing_strategy chỉ có thể là một trong những trạng thái sau đây:
separable

SeparableNDFunction

Chiến lược định giá là một hàm riêng biệt gồm nhiều biến.

RouteShipmentRequest

Thông báo yêu cầu cho phương thức RouteShipment.

Trường
parent

string

Bắt buộc. Mạng mẹ, mạng mà trong đó quá trình vận chuyển phải được chuyển đi. Định dạng: "networks/{network}"
shipment

Shipment

Bắt buộc. Quá trình vận chuyển để chuyển đi.

RouteShipmentResponse

Thông báo phản hồi cho phương thức RouteShipment.

Trường
shipment

Shipment

Lô hàng vừa được tạo.
paths[]

Path

Các lộ trình đã bị thay đổi do việc định tuyến lô hàng. Trường này bao gồm ít nhất một mục nhập, đường dẫn của lô hàng phải được chuyển đi. Dữ liệu này có thể chứa thêm các lộ trình khác cho các gói hàng khác, thể hiện sự thay đổi về trạng thái nội bộ.
lines[]

GeneratedLineAndRotation

Các vòng xoay của tuyến đã được tạo trong khi định tuyến quá trình vận chuyển. Giá trị này có thể trống hoặc chứa chế độ xoay vòng các gói hàng khác, thể hiện sự thay đổi về trạng thái nội bộ.

SeparableNDFunction

Hàm của N đối số được biểu diễn dưới dạng tổng các hàm của một đối số.

Trường
components

map<string, Function1D>

Các thành phần của hàm, với một mục nhập cho mỗi đối số/phương diện.
constant_price

double

Phần hằng của hàm.

Lô hàng

Lô hàng thực hiện.

Trường
name

string

Bắt buộc. Giá trị nhận dạng. Không cập nhật được.
source_hub

string

Bắt buộc. Trung tâm cung cấp gói hàng.
destination_hub

string

Bắt buộc. Trung tâm mà lô hàng phải được giao đến.
departure_time

DateTime

Bắt buộc. Thời gian khởi hành.
arrival_time

DateTimeRange

Bắt buộc. Thời gian đến dự kiến (tức là giới hạn mềm).
arrival_earliness_tardiness_cost

EarlinessTardiness

Không bắt buộc. SLA cho biết rằng thời gian này có thể bị vượt quá với một số hình phạt. (Nếu trễ hơn mức tối đa, thì gói sẽ không còn hữu ích hơn nữa.) Hình phạt được đưa ra bởi hàm độ trễ (tính bằng phút).
size[]

ValueDimension

Không bắt buộc. Dùng với sức chứa của xe và trung tâm.
revenue

double

Không bắt buộc. Doanh thu từ gói này (chỉ dùng để tính phần thưởng), tức là giá do bên thanh toán thanh toán. Nếu bạn không đặt chính sách này, doanh thu sẽ do hệ thống tính (tuỳ thuộc vào việc một dây chuyền sản xuất mới có được tạo cho lô hàng này hay không).

UpdateHubRequest

Thông báo yêu cầu cho phương thức UpdateHub.

Trường
hub

Hub

Bắt buộc. Trung tâm để cập nhật.

Trường name của trung tâm này dùng để xác định trung tâm cần cập nhật. Định dạng: "networks/{network}/hubs/{hub}"
update_mask

FieldMask

Không bắt buộc. Danh sách các trường cần cập nhật.

UpdateLineRequest

Thông báo yêu cầu cho phương thức UpdateLine.

Trường
line

Line

Bắt buộc. Dòng để cập nhật.

Trường name của đường này được dùng để xác định đường cần cập nhật. Định dạng: "networks/{network}/lines/{line}"
update_mask

FieldMask

Không bắt buộc. Danh sách các trường cần cập nhật.

UpdateLineRotationRequest

Thông báo yêu cầu cho phương thức UpdateLineRotation.

Trường
line_rotation

LineRotation

Bắt buộc. Mạng cần cập nhật.

Trường name của chế độ xoay dùng để xác định chế độ xoay cần cập nhật. Định dạng: "networks/{network}/lines/{line}/rotations/{rotation}"
update_mask

FieldMask

Không bắt buộc. Danh sách các trường cần cập nhật.

UpdateNetworkRequest

Thông báo yêu cầu cho phương thức UpdateNetwork.

Trường
network

Network

Bắt buộc. Mạng cần cập nhật.

Trường name của mạng đó được dùng để xác định mạng cần cập nhật. Định dạng: "networks/{network}"
update_mask

FieldMask

Không bắt buộc. Danh sách các trường cần cập nhật.

UpdatePathRequest

Thông báo yêu cầu cho phương thức UpdatePath.

Trường
path

Path

Bắt buộc. Đường dẫn mới để gửi hàng.

UpdateVehicleRequest

Thông báo yêu cầu cho phương thức UpdateVehicle.

Trường
vehicle

Vehicle

Bắt buộc. Xe cần cập nhật.

Trường name của xe dùng để xác định xe cần cập nhật. Định dạng: "networks/{network}/vehicles/{vehicle}"
update_mask

FieldMask

Không bắt buộc. Danh sách các trường cần cập nhật.

ValueDimension

Một giá trị cùng với một phương diện được xác định trước. Bạn phải đặt trường value thành loại tương ứng của dimension.

Trường
value

int64

Không bắt buộc. Giá trị.
dimension

string

Bắt buộc. Phương diện.

Loại xe

Không có tên, dữ liệu này được lưu trữ dưới dạng khoá bản đồ trong Mạng.

Trường
name

string

Bắt buộc. Giá trị nhận dạng. Không cập nhật được.
capacities[]

ValueDimension

Không bắt buộc. Đặc điểm của xe.
cost

PricingStrategy

Bắt buộc. Chi phí sử dụng xe. Đây là các hàm của một đối số: quãng đường xe đi được, trọng lượng xe chuyên chở, số lượng pa-tê mà xe vận chuyển. Các chức năng này tính đến chi phí bảo dưỡng, nhiên liệu và xử lý. Các chi phí này có thể bao gồm chi phí trả trước (thanh toán khi xe được sử dụng, chủ yếu hữu ích cho việc ký hợp đồng phụ).
pricing

PricingStrategy

Không bắt buộc. Giá mà bên thanh toán sẽ thanh toán, chỉ khi xe được sử dụng trong một dòng được tạo (tức là không thuộc mạng đầu vào).
allowed_for_generated_lines

bool

Bắt buộc. Liệu xe này có thể dùng cho các tuyến đường đã tạo hay không. Nếu bạn đặt chính sách này thành false, thì xe sẽ chỉ di chuyển qua các tuyến đường được xác định sẵn mà xe được phép.
vehicle_position_constraints[]

VehiclePositionConstraint

Không bắt buộc. Vị trí bắt buộc của xe hiện tại, cùng với thời gian. Ví dụ: sử dụng các mục nhập để lập mô hình thực tế là một chiếc xe xuất phát hoặc kết thúc tại một trung tâm cụ thể.

VehiclePositionConstraint

Giới hạn vị trí của xe.

Trường
time

DateTime

Thời gian áp dụng quy tắc ràng buộc.
hub_id

string

Trung tâm của quy tắc ràng buộc.