Package google.research.middlemileoptimization.v1

색인

MiddleMileOptimization

물류 네트워크를 관리하고 내부로 배송을 라우팅하는 서비스 이 프로토콜은 스테이트리스(Stateless)(메시지는 독립적)이지만 배후의 서비스는 매우 스테이트풀(Stateful)입니다(메시지를 수신하면 배송 경로를 지정하면 다른 배송의 경로가 변경될 수 있는 등 많은 방법의 응답이 크게 변경될 수 있음).

CommitPath

rpc CommitPath(CommitPathRequest) returns (Path)

배송 경로를 커밋하여 향후에도 사용자가 변경할 수 없음을 나타냅니다. 이는 MakeVehicleUnavailable, MakeHubUnavailable, MakeLineUnavailable 메서드로 표시된 불가항력/행위는 예외입니다. 이 메서드는 경로의 특정 버전에 태그를 지정하는 데 사용되지 않습니다.

CreateHub

rpc CreateHub(CreateHubRequest) returns (Hub)

허브를 만듭니다.

CreateLine

rpc CreateLine(CreateLineRequest) returns (Line)

선을 만듭니다.

CreateLineRotation

rpc CreateLineRotation(CreateLineRotationRequest) returns (LineRotation)

LineLine을 만듭니다.

CreateNetwork

rpc CreateNetwork(CreateNetworkRequest) returns (Network)

네트워크를 생성합니다.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

차량을 만듭니다.

DeleteHub

rpc DeleteHub(DeleteHubRequest) returns (Empty)

허브를 삭제합니다.

DeleteLine

rpc DeleteLine(DeleteLineRequest) returns (Empty)

선을 삭제합니다.

DeleteLineRotation

rpc DeleteLineRotation(DeleteLineRotationRequest) returns (Empty)

LineInteraction을 삭제합니다.

DeleteNetwork

rpc DeleteNetwork(DeleteNetworkRequest) returns (Empty)

네트워크를 삭제합니다.

DeleteShipment

rpc DeleteShipment(DeleteShipmentRequest) returns (Empty)

배송을 삭제합니다.

DeleteVehicle

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

차량을 삭제합니다.

GetHub

rpc GetHub(GetHubRequest) returns (Hub)

허브의 세부정보를 가져옵니다.

GetLine

rpc GetLine(GetLineRequest) returns (Line)

선의 세부정보를 가져옵니다.

GetLineRotation

rpc GetLineRotation(GetLineRotationRequest) returns (LineRotation)

LineRound의 세부정보를 가져옵니다.

GetNetwork

rpc GetNetwork(GetNetworkRequest) returns (Network)

네트워크의 세부정보를 가져옵니다.

GetShipment

rpc GetShipment(GetShipmentRequest) returns (Shipment)

배송 세부정보를 확인합니다.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

차량의 세부정보를 가져옵니다.

ListHubs

rpc ListHubs(ListHubsRequest) returns (ListHubsResponse)

허브를 나열합니다.

ListLineRotations

rpc ListLineRotations(ListLineRotationsRequest) returns (ListLineRotationsResponse)

LineRounds를 나열합니다.

ListLines

rpc ListLines(ListLinesRequest) returns (ListLinesResponse)

선을 나열합니다.

ListNetworks

rpc ListNetworks(ListNetworksRequest) returns (ListNetworksResponse)

네트워크를 나열합니다.

ListPaths

rpc ListPaths(ListPathsRequest) returns (ListPathsResponse)

현재 사용 가능한 모든 경로를 반환합니다. 이 메서드는 멱등성이 있으며 부작용이 없습니다.

ListShipments

rpc ListShipments(ListShipmentsRequest) returns (ListShipmentsResponse)

배송 목록을 표시합니다.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

차량을 나열합니다.

MakeHubAvailable

rpc MakeHubAvailable(MakeHubAvailableRequest) returns (MakeHubAvailableResponse)

허브를 사용할 수 있게 합니다.

MakeHubUnavailable

rpc MakeHubUnavailable(MakeHubUnavailableRequest) returns (MakeHubUnavailableResponse)

허브를 사용할 수 없게 합니다.

MakeLineAvailable

rpc MakeLineAvailable(MakeLineAvailableRequest) returns (MakeLineAvailableResponse)

선을 사용할 수 있게 합니다.

MakeLineUnavailable

rpc MakeLineUnavailable(MakeLineUnavailableRequest) returns (MakeLineUnavailableResponse)

노선을 사용할 수 없게 됩니다.

MakeVehicleAvailable

rpc MakeVehicleAvailable(MakeVehicleAvailableRequest) returns (MakeVehicleAvailableResponse)

차량을 사용할 수 있게 합니다.

MakeVehicleUnavailable

rpc MakeVehicleUnavailable(MakeVehicleUnavailableRequest) returns (MakeVehicleUnavailableResponse)

차량을 사용할 수 없게 합니다.

RouteShipment

rpc RouteShipment(RouteShipmentRequest) returns (RouteShipmentResponse)

새 배송을 라우트합니다. 생성과 마찬가지로 이 작업은 상태 변경을 의미합니다.

UpdateHub

rpc UpdateHub(UpdateHubRequest) returns (Hub)

허브를 업데이트합니다.

UpdateLine

rpc UpdateLine(UpdateLineRequest) returns (Line)

줄을 업데이트합니다.

UpdateLineRotation

rpc UpdateLineRotation(UpdateLineRotationRequest) returns (LineRotation)

LineLine을 업데이트합니다.

UpdateNetwork

rpc UpdateNetwork(UpdateNetworkRequest) returns (Network)

네트워크를 업데이트합니다.

UpdatePath

rpc UpdatePath(UpdatePathRequest) returns (Path)

배송 경로 변경: 서비스에서 계산된 경로를 사용하는 대신 사용자가 이 호출을 통해 설정한 경로가 상태에 포함됩니다.

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

차량을 업데이트합니다.

AnnotatedPathSegment

포함된 PathSegment와 네트워크를 기반으로 계산할 수 있는 더욱 중복된 정보가 있는 경로의 일부를 나타냅니다. 이러한 메시지는 일반적으로 API 서버에서 반환됩니다.

입력란
segment

PathSegment

필수 항목입니다. 주석이 추가되고 있는 세그먼트입니다.

arrival_time

DateTime

출력 전용입니다. 이 구간의 도착 시간입니다.

departure_time

DateTime

출력 전용입니다. 이 구간의 출발 시간입니다.

is_committed

bool

출력 전용입니다. API 고객이 경로의 이 부분을 커밋하기로 결정했는지 여부입니다.

segment_cost_constant

double

출력 전용입니다. 이 세그먼트에 대한 지속적인 비용입니다.

segment_cost_due_to_vehicle

map<string, double>

출력 전용입니다. 측정기준당 하나의 항목.

segment_cost_due_to_departure

double

출력 전용입니다. 노선 순환으로 인한 비용: 출발입니다.

segment_cost_due_to_arrival

double

출력 전용입니다. 선 순환으로 인한 비용: 도착

CommitPathRequest

CommitPath 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 경로를 보장해야 하는 배송의 이름입니다. 형식: 'networks/{network}/shipments/{shipment}'

통합 필드 path_to_commit. 커밋해야 하는 경로 또는 경로의 부분입니다. path_to_commit는 다음 중 하나여야 합니다.
complete_shipment_path

PathToCommit

소스에서 대상으로 이어지는 경로의 세그먼트입니다.

segments

IncompletePathToCommit

소스에서 대상으로 이어지는 경로의 구간 하위 집합입니다.

IncompletePathToCommit

커밋되는 경로의 일부(즉, 소스와 대상 사이의 일부 세그먼트)

입력란
segments[]

PathSegment

필수 항목입니다. 소스에서 대상으로 이어지는 경로의 구간 하위 집합입니다.

PathToCommit

소스에서 대상까지 커밋되는 전체 경로입니다.

입력란
segments[]

PathSegment

필수 항목입니다. 세그먼트는 소스에서 대상까지 순서가 있어야 합니다.

CreateHubRequest

CreateHub 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 허브가 생성될 상위 리소스입니다. 형식: 'networks/{network}'

hub_id

string

필수 항목입니다. 생성할 허브의 식별자입니다.

hub

Hub

필수 항목입니다. 만들 허브입니다.

CreateLineRequest

CreateLine 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 줄이 생성될 상위 리소스입니다. 형식: 'networks/{network}'

line_id

string

필수 항목입니다. 생성할 줄의 식별자입니다.

line

Line

필수 항목입니다. 생성할 행입니다.

CreateLineRotationRequest

CreateLineRotation 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 선 순환이 생성될 상위 리소스입니다. 형식: 'networks/{network}/lines/{line}'

line_rotation_id

string

필수 항목입니다. 생성할 선 회전의 식별자입니다.

line_rotation

LineRotation

필수 항목입니다. 생성할 선 회전입니다.

CreateNetworkRequest

CreateNetwork 메서드의 요청 메시지입니다.

입력란
network_id

string

필수 항목입니다. 생성할 네트워크의 식별자입니다.

network

Network

필수 항목입니다. 생성할 네트워크입니다.

CreateVehicleRequest

CreateVehicle 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 차량을 만들 상위 리소스입니다. 형식: 'networks/{network}'

vehicle_id

string

필수 항목입니다. 생성할 차량의 식별자입니다.

vehicle

Vehicle

필수 항목입니다. 생성할 차량입니다.

CrossDockingCapacity

허브의 전반적인 크로스 도킹 용량입니다.

입력란
capacity_per_hour[]

ValueDimension

선택사항입니다. 각 측정기준의 크로스 도킹 용량

CrossDockingTime

허브의 전체 교차 도킹 시간입니다.

입력란
time_constant

Duration

선택사항입니다. 교차 도킹 작업에 대한 지속적인 시간.

time

SeparableNDFunction

선택사항입니다. 분리 가능성은 더 단순한 가정입니다.

DateTimeRange

두 DateTime 사이의 시간 범위입니다. 특정 시점 날짜 시간의 경우 start == end를 사용합니다.

google/type/interval.proto의 용도는 비슷하지만 실제 시간이 있습니다 (상담 시간만 신경 쓰면 됩니다).

입력란
first_date

DateTime

범위의 시작입니다.

last_date

DateTime

범위 끝

DeleteHubRequest

DeleteHub 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 허브의 이름입니다. 형식: 'networks/{network}/hubs/{hub}"

DeleteLineRequest

DeleteLine 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 줄의 이름입니다. 형식: 'networks/{network}/lines/{line}'

force

bool

선택사항입니다. true로 설정하면 하위 리소스를 삭제합니다.

DeleteLineRotationRequest

DeleteLineRotation 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 선 회전의 이름입니다. 형식: 'networks/{network}/lines/{line}/rotations/{rotation}'

DeleteNetworkRequest

DeleteNetwork 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 네트워크의 이름입니다. 형식: 'networks/{network}'

force

bool

선택사항입니다. true로 설정하면 하위 리소스를 삭제합니다.

DeleteShipmentRequest

DeleteShipment 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 배송의 이름입니다. 형식: 'networks/{network}/shipments/{shipment}'

DeleteVehicleRequest

DeleteVehicle 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 삭제할 차량의 이름입니다. 형식: 'networks/{network}/vehicles/{vehicle}'

DistanceMatrixEntry

소스 허브와 대상 허브 간의 거리입니다.

입력란
source_hub

string

필수 항목입니다. 소스 허브

destination_hub

string

필수 항목입니다. 대상 허브입니다.

weights[]

ValueDimension

필수 항목입니다. 여러 치수로 측정된 허브 사이의 거리입니다.

EarlinessTardiness

배송이 필요한 것보다 빨리 또는 늦게 도착/발송되어 발생하는 비용입니다 (유연한 제약 조건).

입력란
maximum_earliness

Duration

선택사항입니다. 최대 허용 조기 성능. 비용이 있는 경우에만 유용합니다.

maximum_tardiness

Duration

선택사항입니다. 최대 허용 지연 시간입니다. 비용이 있는 경우에만 유용합니다.

earliness_cost

Function1D

선택사항입니다. 저렴한 비용. 일찍 즐길 수 있는 혜택이 없는 경우 설정되지 않습니다.

tardiness_cost

Function1D

선택사항입니다. 지체 비용. 지체 비용이 없으면 설정되지 않습니다.

함수1D

하나의 인수에 대한 함수입니다.

입력란
통합 필드 function. 함수의 인수 단위는 다음과 같아야 합니다. - 무게: kg - 시간: min - 팰릿 수인 경우: 1 function는 다음 중 하나여야 합니다.
constant

double

함수는 상수입니다.

pwl

PieceWiseAffineFunction

함수는 부분적 선형입니다.

GeneratedLineAndRotation

API 고객이 아닌 이 API에 의해 생성된 선의 1회 회전입니다. 본질적으로 제한이 적으며 API 고객이 후속 호출에서 달리 결정하지 않는 한 어떤 차량이든 사용할 수 있습니다.

입력란
arrival_times

map<string, DateTime>

출력 전용입니다. 허브 ID와 시간 간의 매핑입니다. 이 맵에는 동일한 키 (도착 시간이 없는 소스 허브 제외)가 있어야 합니다.

departure_times

map<string, DateTime>

출력 전용입니다. 허브 ID와 시간 간의 매핑입니다. 이 지도에는 동일한 키 (출발 시간이 없는 목적지 허브 제외)가 있어야 합니다.

GetHubRequest

GetHub 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 허브의 이름입니다. 형식: 'networks/{network}/hubs/{hub}"

GetLineRequest

GetLine 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 네트워크의 이름입니다. 형식: 'networks/{network}/lines/{line}'

GetLineRotationRequest

GetLineRotation 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 선 회전의 이름입니다. 형식: 'networks/{network}/lines/{line}/rotations/{rotation}'

GetNetworkRequest

GetNetwork 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 네트워크의 이름입니다. 형식: 'networks/{network}'

GetShipmentRequest

GetShipment 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 배송의 이름입니다. 형식: 'networks/{network}/shipments/{shipment}'

GetVehicleRequest

GetVehicle 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 검색할 차량의 이름입니다. 형식: 'networks/{network}/vehicles/{vehicle}'

허브

한 허브에서 다른 허브로 배송을 가져와야 합니다.

입력란
name

string

필수 항목입니다. 식별자. 이 설정은 업데이트할 수 없습니다.

position

LatLng

선택사항입니다. 실제 경로를 계산할 위치입니다.

opening_times[]

DateTimeRange

필수 항목입니다. 영업시간 지금은 허브가 열릴 때마다 항목을 하나씩 매우 대략적인 표현으로 사용합니다 (직원이 점심시간에 근무하는 직원이 없고 그 시간에 근무하는 사람이 없는 경우 그 날에는 항목이 두 개임).

cross_docking_capacity

CrossDockingCapacity

선택사항입니다. 전체 허브의 용량입니다.

cross_docking_time

CrossDockingTime

선택사항입니다. 크로스 도킹 작업 1개를 실행하는 데 걸리는 시간 (차량 1대당)

IntegerRange

정수 범위입니다.

입력란
start_value

int32

설정되지 않은 경우 간격이 열립니다.

end_value

int32

설정되지 않은 경우 간격이 열립니다.

특정 주파수로 운행되는 선입니다.

입력란
name

string

필수 항목입니다. 식별자. 이 설정은 업데이트할 수 없습니다.

hub_ids[]

string

필수 항목입니다. 이 노선에서 호출하는 허브의 목록으로, 차량이 정차하는 순서입니다.

LineRotation

차량이 특정 시간에 이 노선을 운행하기 시작합니다.

입력란
name

string

필수 항목입니다. 식별자. 이 설정은 업데이트할 수 없습니다.

arrival_times

map<string, DateTimeRange>

선택사항입니다. 비용 없이 출발이 허용되는 범위입니다. 즉, 지점이 아닌 경우 실제 도착 시간은 시스템에서 결정합니다. 이 맵에는 동일한 키 (도착 시간이 없는 소스 허브 제외)가 있어야 합니다.

departure_times

map<string, DateTimeRange>

선택사항입니다. 비용 없이 도착이 허용되는 범위입니다 (예: 특정 지점이 아닌 경우 시스템에서 실제 출발 시간을 결정합니다). 이 지도에는 동일한 키 (출발 시간이 없는 목적지 허브 제외)가 있어야 합니다.

departure_earliness_tardiness_costs

map<string, EarlinessTardiness>

선택사항입니다. 출발 지연/지연 비용 및 경계 이 지도에는 동일한 키 (출발 시간이 없는 목적지 허브 제외)가 있어야 합니다.

arrival_earliness_tardiness_costs

map<string, EarlinessTardiness>

선택사항입니다. 도착의 지연/지연 비용 및 한도 이 맵에는 동일한 키 (도착 시간이 없는 소스 허브 제외)가 있어야 합니다.

vehicles[]

string

선택사항입니다. 이 노선 순환을 수행할 수 있는 차량의 목록입니다 (예: 허용 목록). number_vehicles가 차량 대수에 해당하는 하나의 값으로 감소하면 모든 차량이 노선 순환에 할당됩니다. 차량이 없는 경우 모두 이용 가능한 것으로 간주됩니다.

fixed_price

PricingStrategy

선택사항입니다. 차량 (운전자, 유지보수 등)과 관계없이 이 노선을 운행하는 모든 차량의 비용

maximum_number_vehicles

IntegerRange

선택사항입니다. 이 순환게재에 할당할 수 있는 최대 차량 수입니다. 설정되지 않은 경우: 이 회전을 위한 차량 제한이 없습니다. 그 외의 경우에는 이 회전에 할당할 수 있는 차량 수의 상한선 (허용 목록 vehicle_ids 중)입니다. 특히 값이 0이면 이 회전이 사용 중지됩니다 (차량 허용되지 않음).

ListHubsRequest

ListHubs 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 허브 컬렉션을 소유하는 상위 요소입니다. 형식: 'networks/{network}'

page_size

int32

선택사항입니다. 반환할 최대 허브 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 허브가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListHubs 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListHubs에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListHubsResponse

ListHubs 메서드의 응답 메시지입니다.

입력란
hubs[]

Hub

지정된 네트워크의 허브입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListLineRotationsRequest

ListLineRotations 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 선 회전 모음을 소유하는 상위 요소입니다. 형식: 'networks/{network}/lines/{line}'

page_size

int32

선택사항입니다. 반환할 선 회전의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 LineLines가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListLineRotations 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListLineRotations에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListLineRotationsResponse

ListLineRotations 메서드의 응답 메시지입니다.

입력란
line_rotations[]

LineRotation

지정된 네트워크와 선에서 선의 방향이 바뀝니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListLinesRequest

ListLines 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 선 모음을 소유하는 상위 요소입니다. 형식: 'networks/{network}'

page_size

int32

선택사항입니다. 반환할 최대 줄 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50줄이 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListLines 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListLines에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListLinesResponse

ListLines 메서드의 응답 메시지입니다.

입력란
lines[]

Line

지정된 네트워크의 행입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListNetworksRequest

ListNetworks 메서드의 요청 메시지입니다.

입력란
page_size

int32

선택사항입니다. 반환할 네트워크의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 네트워크가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListNetworks 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListNetworks에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListNetworksResponse

ListNetworks 메서드의 응답 메시지입니다.

입력란
networks[]

Network

네트워크 목록입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListPathsRequest

ListPaths 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 경로를 전송해야 하는 네트워크의 이름입니다. 형식: 'networks/{network}'

page_size

int32

선택사항입니다. 반환할 네트워크의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 네트워크가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListNetworks 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListNetworks에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListPathsResponse

ListPaths 메서드의 응답 메시지입니다.

입력란
paths[]

Path

경로 목록입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListShipmentsRequest

ListShipments 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 배송 컬렉션을 소유한 상위 항목입니다. 형식: 'networks/{network}'

page_size

int32

선택사항입니다. 반환할 최대 배송 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 배송 상품이 반품됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListShipments 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListShipments에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListShipmentsResponse

ListShipments 메서드의 응답 메시지입니다.

입력란
shipments[]

Shipment

지정된 네트워크에서 보낸 배송 수입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

ListVehiclesRequest

ListVehicles 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 이 차량 컬렉션을 소유하는 상위 요소입니다. 형식: 'networks/{network}'

page_size

int32

선택사항입니다. 반환할 최대 차량 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50대의 차량이 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.

page_token

string

선택사항입니다. 이전 ListVehicles 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListVehicles에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListVehiclesResponse

ListVehicles 메서드의 응답 메시지입니다.

입력란
vehicles[]

Vehicle

지정된 네트워크의 차량입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

MakeHubAvailableRequest

MakeHubAvailable 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 제공할 허브의 이름입니다. 형식: 'networks/{network}/hubs/{hub}"

availability_starts[]

DateTime

필수 항목입니다. 이용이 시작되는 기간입니다. 미래의 특정 시점이어야 합니다. 이 필드가 없으면 메시지가 수신된 시점에 가용성이 시작됩니다.

MakeHubAvailableResponse

MakeHubAvailable 메서드의 응답 메시지입니다.

입력란
name

string

사용 불가 상태가 업데이트된 허브의 이름입니다. 형식: 'networks/{network}/hubs/{hub}"

path[]

Path

업데이트된 경로입니다.

MakeHubUnavailableRequest

MakeHubUnavailable 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 사용할 수 없는 허브의 이름입니다. 형식: 'networks/{network}/hubs/{hub}"

unavailability_starts[]

DateTime

필수 항목입니다. 이용 불가 상태가 시작되는 기간입니다. 미래의 특정 시점이어야 합니다. 이 필드가 없으면 메시지를 수신할 때 비가용성이 시작됩니다.

MakeHubUnavailableResponse

MakeHubUnavailable 메서드의 응답 메시지입니다.

입력란
name

string

사용 불가 상태가 업데이트된 허브의 이름입니다. 형식: 'networks/{network}/hubs/{hub}"

path[]

Path

업데이트된 경로입니다.

MakeLineAvailableRequest

MakeHubAvailable 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 사용할 줄의 이름입니다. 형식: 'networks/{network}/lines/{line}'

availability_starts[]

DateTime

필수 항목입니다. 이용이 시작되는 기간입니다. 미래의 특정 시점이어야 합니다. 이 필드가 없으면 메시지가 수신된 시점에 가용성이 시작됩니다.

MakeLineAvailableResponse

MakeLineAvailable 메서드의 응답 메시지입니다.

입력란
name

string

비가용성이 업데이트된 줄의 이름입니다. 형식: 'networks/{network}/lines/{line}'

path[]

Path

업데이트된 경로입니다.

MakeLineUnavailableRequest

MakeLineUnavailable 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 사용할 수 없게 만들 줄의 이름입니다. 형식: 'networks/{network}/lines/{line}'

unavailability_starts[]

DateTime

필수 항목입니다. 이용 불가 상태가 시작되는 기간입니다. 미래의 특정 시점이어야 합니다. 이 필드가 없으면 메시지를 수신할 때 비가용성이 시작됩니다.

MakeLineUnavailableResponse

MakeLineUnavailable 메서드의 응답 메시지입니다.

입력란
name

string

비가용성이 업데이트된 줄의 이름입니다. 형식: 'networks/{network}/lines/{line}'

path[]

Path

업데이트된 경로입니다.

MakeVehicleAvailableRequest

MakeVehicleAvailable 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 제공할 차량의 이름입니다. 형식: 'networks/{network}/vehicle/{vehicle}'

availability_starts[]

DateTime

필수 항목입니다. 이용이 시작되는 기간입니다. 미래의 특정 시점이어야 합니다. 이 필드가 없으면 메시지가 수신된 시점에 가용성이 시작됩니다.

MakeVehicleAvailableResponse

MakeVehicleAvailable 메서드의 응답 메시지입니다.

입력란
name

string

이용 가능 여부가 업데이트된 차량의 이름입니다. 형식: 'networks/{network}/vehicles/{vehicle}'

path[]

Path

업데이트된 경로입니다.

MakeVehicleUnavailableRequest

MakeVehicleUnavailable 메서드의 요청 메시지입니다.

입력란
name

string

필수 항목입니다. 사용할 수 없는 차량의 이름입니다. 형식: 'networks/{network}/vehicles/{vehicle}'

unavailability_starts[]

DateTime

필수 항목입니다. 이용 불가 상태가 시작되는 기간입니다. 미래의 특정 시점이어야 합니다. 이 필드가 없으면 메시지를 수신할 때 비가용성이 시작됩니다.

MakeVehicleUnavailableResponse

MakeVehicleUnavailable 메서드의 응답 메시지입니다.

입력란
name

string

예약 불가가 업데이트된 차량의 이름입니다. 형식: 'networks/{network}/vehicles/{vehicle}'

path[]

Path

업데이트된 경로입니다.

네트워크

사용할 수 있는 전체 기존 네트워크를 설명합니다. 특정 API 고객은 여러 네트워크를 가질 수 있습니다 (예: 기본 네트워크 및 평가할 향후 수정 가능성).

입력란
name

string

필수 항목입니다. 식별자. 이 설정은 업데이트할 수 없습니다.

dimensions[]

ValueDimension

거리, 무게, 팔레트 등 및 배율 (부동 소수를 정수로 매핑)

pricing

PricingStrategy

선택사항입니다. 전용 회선이 필요 없는 배송에 대해 발송인이 지불하는 가격입니다.

currency_code

string

선택사항입니다. 네트워크 전체에 사용되는 단일 화폐 단위입니다. API 고객은 서로 다른 네트워크에 대해 여러 단위를 가질 수 있습니다. 네트워크 한 곳에서 하나의 화폐 단위만 사용할 수 있습니다. 단위는 google3/google/type/money.proto와 같이 ISO 4217로 인코딩되어야 합니다.

time_step

Duration

선택사항입니다. 시간 이산화. 결정은 시간 단위로 이 정밀도로 출력됩니다. 내부적으로는 이러한 정밀도로 상태가 유지됩니다.

distance_matrix[]

DistanceMatrixEntry

선택사항입니다. 거리 행렬입니다 (가중치가 적용된 방향성 에지의 목록을 나타냄).

경로

네트워크 내 배송의 경로입니다.

입력란
shipment

string

필수 항목입니다. 경로가 설명된 배송입니다.

segments[]

AnnotatedPathSegment

필수 항목입니다. 경로의 구간입니다.

departure_time

DateTime

출력 전용입니다. 배송의 실제 출발 시간입니다.

arrival_time

DateTime

출력 전용입니다. 배송 상품의 실제 도착 시간입니다.

incurred_penalties

double

출력 전용입니다. 유연한 제약 조건으로 인한 페널티가 적용되지 않습니다.

cost_constant

double

출력 전용입니다. 이 배송에 대한 지속적인 비용입니다.

cost

map<string, double>

출력 전용입니다. 구성요소별 비용입니다.

PathSegment

API 고객이 API 서버로 전송하거나 (예: 상태 변경) API 서버에서 API 고객에게 전송 (예: 배송 라우팅) 경로의 일부를 나타냅니다.

입력란
source_hub

string

필수 항목입니다. 세그먼트의 소스입니다.

destination_hub

string

필수 항목입니다. 세그먼트의 대상입니다.

line

string

필수 항목입니다. 이 구간에서 이어지는 선입니다.

line_rotation

string

필수 항목입니다. 이 구간의 순환을 따르고 있습니다.

vehicle

string

필수 항목입니다. 차량 다음에 이 구간이 오는 구간입니다.

PieceWiseAffineFunction

한 개의 인수로 제한되는 개별 선형 함수입니다. 다음과 유사한 설계를 사용합니다. https://github.com/google/or-tools/blob/stable/ortools/util/piecewise_linear_function.h

입력란
segments[]

PieceWiseAffineSegment

함수의 선형 세그먼트입니다.

PieceWiseAffineSegment

구간별 선형 함수의 한 세그먼트

입력란
start_x

double

세그먼트의 시작: x.

start_y

double

세그먼트의 시작: y.

end_x

double

세그먼트 끝: x.

end_y

double

세그먼트 끝: y.

PricingStrategy

가격 전략

입력란
통합 필드 pricing_strategy. 가격 전략 pricing_strategy는 다음 중 하나여야 합니다.
separable

SeparableNDFunction

가격 전략은 여러 변수를 분리할 수 있는 기능입니다.

RouteShipmentRequest

RouteShipment 메서드의 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 상위 네트워크는 배송이 라우트되어야 하는 네트워크입니다. 형식: 'networks/{network}'

shipment

Shipment

필수 항목입니다. 경로에 배송할 배송입니다.

RouteShipmentResponse

RouteShipment 메서드의 응답 메시지입니다.

입력란
shipment

Shipment

방금 생성된 배송입니다.

paths[]

Path

배송 경로로 인해 변경된 경로입니다. 이 입력란에는 배송되어야 하는 배송의 경로인 항목이 하나 이상 포함됩니다. 내부 상태 변경사항을 반영하기 위해 다른 배송에 대한 추가 경로가 포함될 수 있습니다.

lines[]

GeneratedLineAndRotation

배송 경로를 지정하는 동안 생성된 회선 순환입니다. 내부 상태 변경사항을 반영하기 위해 비어 있거나 다른 배송의 회전이 포함되어 있을 수 있습니다.

SeparableNDFunction

한 인수에 대한 함수의 합으로 표현된 N개 인수의 함수입니다.

입력란
components

map<string, Function1D>

함수의 구성요소로, 인수/차원당 항목이 하나씩 있습니다.

constant_price

double

함수의 상수 부분입니다.

배송

배송을 수행합니다.

입력란
name

string

필수 항목입니다. 식별자. 이 설정은 업데이트할 수 없습니다.

source_hub

string

필수 항목입니다. 배송이 제공되는 허브입니다.

destination_hub

string

필수 항목입니다. 상품을 배송해야 하는 허브입니다.

departure_time

DateTime

필수 항목입니다. 출발 시간입니다.

arrival_time

DateTimeRange

필수 항목입니다. 예상 도착 시간 (즉, 유연한 제약 조건)

arrival_earliness_tardiness_cost

EarlinessTardiness

선택사항입니다. SLA에 따르면 이 시간이 초과될 수 있으며 약간의 불이익이 있을 수 있습니다. 최대값보다 늦으면 패키지가 더 이상 유용하지 않습니다. 페널티는 지연 함수 (분)로 제공됩니다.

size[]

ValueDimension

선택사항입니다. 차량 및 허브 용량과 함께 사용됩니다.

revenue

double

선택사항입니다. 이 패키지에서 발생한 수익 (리워드 계산에만 사용됨), 즉 결제 당사자가 지불한 가격입니다. 설정하지 않으면 시스템에서 수익을 계산합니다 (이 배송에 새 항목이 생성되는지 여부에 따라 다름).

UpdateHubRequest

UpdateHub 메서드의 요청 메시지입니다.

입력란
hub

Hub

필수 항목입니다. 업데이트할 허브입니다.

허브의 name 필드는 업데이트할 허브를 식별하는 데 사용됩니다. 형식: 'networks/{network}/hubs/{hub}"

update_mask

FieldMask

선택사항입니다. 업데이트할 필드의 목록입니다.

UpdateLineRequest

UpdateLine 메서드의 요청 메시지입니다.

입력란
line

Line

필수 항목입니다. 업데이트할 행입니다.

줄의 name 필드는 업데이트할 줄을 식별하는 데 사용됩니다. 형식: 'networks/{network}/lines/{line}'

update_mask

FieldMask

선택사항입니다. 업데이트할 필드의 목록입니다.

UpdateLineRotationRequest

UpdateLineRotation 메서드의 요청 메시지입니다.

입력란
line_rotation

LineRotation

필수 항목입니다. 업데이트할 네트워크입니다.

회전의 name 필드는 업데이트할 회전을 식별하는 데 사용됩니다. 형식: 'networks/{network}/lines/{line}/rotations/{rotation}'

update_mask

FieldMask

선택사항입니다. 업데이트할 필드의 목록입니다.

UpdateNetworkRequest

UpdateNetwork 메서드의 요청 메시지입니다.

입력란
network

Network

필수 항목입니다. 업데이트할 네트워크입니다.

네트워크의 name 필드는 업데이트할 네트워크를 식별하는 데 사용됩니다. 형식: 'networks/{network}'

update_mask

FieldMask

선택사항입니다. 업데이트할 필드의 목록입니다.

UpdatePathRequest

UpdatePath 메서드의 요청 메시지입니다.

입력란
path

Path

필수 항목입니다. 배송의 새로운 경로입니다.

UpdateVehicleRequest

UpdateVehicle 메서드의 요청 메시지입니다.

입력란
vehicle

Vehicle

필수 항목입니다. 업데이트할 차량입니다.

차량의 name 필드는 업데이트할 차량을 식별하는 데 사용됩니다. 형식: 'networks/{network}/vehicles/{vehicle}'

update_mask

FieldMask

선택사항입니다. 업데이트할 필드의 목록입니다.

ValueDimension

사전 정의된 측정기준 1개에 따른 값 value 필드는 상응하는 dimension 유형으로 설정해야 합니다.

입력란
value

int64

선택사항입니다. 가치.

dimension

string

필수 항목입니다. 측정기준.

차량

이름 없음, 네트워크 내에 맵 키로 저장됩니다.

입력란
name

string

필수 항목입니다. 식별자. 이 설정은 업데이트할 수 없습니다.

capacities[]

ValueDimension

선택사항입니다. 차량 특성.

cost

PricingStrategy

필수 항목입니다. 차량 사용 비용입니다. 이는 차량이 이동하는 거리, 차량이 운반하는 중량, 차량이 운반하는 팰릿의 수라는 한 인수의 함수입니다. 이러한 기능에는 유지보수, 연료, 처리 비용이 반영됩니다. 이 비용에는 선불 비용이 포함될 수 있습니다 (차량을 사용한 후 지불되며 주로 하도급에 유용함).

pricing

PricingStrategy

선택사항입니다. 차량이 생성된 회선 (즉, 입력 네트워크의 일부가 아님)에서 사용되는 경우에만 결제 당사자가 지불하는 가격입니다.

allowed_for_generated_lines

bool

필수 항목입니다. 이 차량을 생성된 노선에 사용할 수 있는지 여부입니다. false로 설정하면 차량이 허용되는 사전 정의된 노선으로 제한됩니다.

vehicle_position_constraints[]

VehiclePositionConstraint

선택사항입니다. 현재 차량의 강제 위치 및 시간입니다. 예를 들어 항목을 사용하여 특정 허브에서 출발하거나 끝나는 차량이 있다는 사실을 모델링합니다.

VehiclePositionConstraint

차량의 위치에 대한 제약 조건입니다.

입력란
time

DateTime

제약조건의 시간입니다.

hub_id

string

제약조건의 허브입니다.