Package google.research.middlemileoptimization.v1

索引

MiddleMileOptimization

物流ネットワークを管理し、荷物を配送経路として管理するサービス。このプロトコルはステートレス(メッセージは独立しています)ですが、背後にあるサービスは非常にステートフルです(メッセージを受信すると、配送の経路変更など、多くの方法で返信が大幅に変わる可能性があります)。

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)

LineRotation を作成します。

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)

LineRotation を削除します。

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)

Line の詳細を取得します。

GetLineRotation

rpc GetLineRotation(GetLineRotationRequest) returns (LineRotation)

LineRotation の詳細を取得します。

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)

LineRotations を一覧表示します。

ListLines

rpc ListLines(ListLinesRequest) returns (ListLinesResponse)

Lines を一覧表示します。

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)

LineRotation を更新します。

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>

出力専用。ディメンションごとに 1 つのエントリ。

segment_cost_due_to_departure

double

出力専用。路線のローテーションによる費用: 出発。

segment_cost_due_to_arrival

double

出力専用。線の回転によるコスト: 到着

CommitPathRequest

CommitPath メソッドに対するリクエスト メッセージ。

フィールド
name

string

必須。パスを commit する必要がある配送の名前。形式: 「networks/{network}/shipments/{shipment}」

共用体フィールド path_to_commit。commit するパスまたはパスの部分。path_to_commit は次のいずれかになります。
complete_shipment_path

PathToCommit

送信元から宛先へのパスのセグメント。

segments

IncompletePathToCommit

送信元から宛先へのパスのセグメントのサブセット。

IncompletePathToCommit

commit されているパスの一部(つまり、送信元と宛先の間の一部のセグメント)。

フィールド
segments[]

PathSegment

必須。送信元から宛先へのパスのセグメントのサブセット。

PathToCommit

commit されるソースから宛先までのフルパス。

フィールド
segments[]

PathSegment

必須。セグメントは、ソースから宛先まで順番に含める必要があります。

CreateHubRequest

CreateHub メソッドに対するリクエスト メッセージ。

フィールド
parent

string

必須。このハブが作成される親リソース。形式: networks/{network}

hub_id

string

必須。作成するハブの ID。

hub

Hub

必須。作成するハブ。

CreateLineRequest

CreateLine メソッドに対するリクエスト メッセージ。

フィールド
parent

string

必須。この行が作成される親リソース。形式: networks/{network}

line_id

string

必須。作成する行の ID。

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

必須。作成する車両の ID。

vehicle

Vehicle

必須。作成する車両。

CrossDockingCapacity

ハブの全体的なクロスドッキング容量。

フィールド
capacity_per_hour[]

ValueDimension

省略可。各ディメンションのクロスドッキング容量。

CrossDockingTime

ハブの全体的なクロスドッキング時間。

フィールド
time_constant

Duration

省略可。クロスドッキング操作の定数時間。

time

SeparableNDFunction

省略可。分離可能性は前提条件を単純化したものです。

DateTimeRange

2 つの 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

1 つの引数の関数。

フィールド
共用体フィールド function。関数の引数の単位は、- 重量: kg - 時間: 最小 - パレット数: 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}」

Hub

配送は拠点から別の拠点に搬送する必要があります。

フィールド
name

string

必須。ID。この設定は変更できません。

position

LatLng

省略可。実際の経路を計算する位置。

opening_times[]

DateTimeRange

必須。営業時間。現時点では、ハブが開くたびに 1 つのエントリという非常に大まかな表現を使用します(ワーカーの昼休みがあり、その時間に誰も働いていない場合、その日のエントリは 2 つになります)。

cross_docking_capacity

CrossDockingCapacity

省略可。ハブ全体の容量。

cross_docking_time

CrossDockingTime

省略可。1 回のクロスドッキング操作にかかった時間(車両 1 台あたり)。

IntegerRange

整数の範囲。

フィールド
start_value

int32

設定されていない場合、間隔は空です。

end_value

int32

設定されていない場合、間隔は空です。

所定の頻度で運行される路線。

フィールド
name

string

必須。ID。この設定は変更できません。

hub_ids[]

string

必須。この回線が発信するハブのリスト(車両が停車する順)。

LineRotation

この路線の運行は特定の時間に始動します。

フィールド
name

string

必須。ID。この設定は変更できません。

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 が車両数に対応する 1 つの値に減った場合、それらの車両はすべてラインの回転に割り当てられます。車両が 1 台もない場合は、すべての車両が販売可能と見なされます。

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 個の LineRotations が返されます。最大値は 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

必須。ID。この設定は変更できません。

dimensions[]

ValueDimension

距離、重量、パレットなどに加えて、スケーリング(浮動小数点数から整数値にマッピングするため)。

pricing

PricingStrategy

省略可。専用ラインを必要としない配送に対して送信者が支払う価格。

currency_code

string

省略可。ネットワーク全体で使用される単一の通貨単位。1 つの API ユーザーは、ネットワークごとに異なる複数のユニットを使用できますが、1 つのネットワークで使用できる通貨単位は 1 つのみです。単位は ISO 4217 でエンコードする必要があります(例: google3/google/type/money.proto)。

time_step

Duration

省略可。時間の離散化。決定はこの精度で時間内に出力されます。内部的には、状態はこの精度で保持されます。

distance_matrix[]

DistanceMatrixEntry

省略可。距離行列(重み付き有向エッジのリストを表す)。

Path

ネットワーク内の配送経路。

フィールド
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

1 つの引数に限定される区分線形関数。https://github.com/google/or-tools/blob/stable/ortools/util/piecewise_linear_function.h に似た設計

フィールド
segments[]

PieceWiseAffineSegment

関数の線形セグメント。

PieceWiseAffineSegment

区分線形関数の 1 つのセグメント。

フィールド
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

配送のルーティングによって変更されたパス。このフィールドには少なくとも 1 つのエントリ(配送先の経路)が含まれています。内部の状態変更を反映して、他の配送のパスが追加されることがあります。

lines[]

GeneratedLineAndRotation

配送のルーティング中に作成されたラインのローテーション。空の状態であるか、内部の状態変更を反映して他の配送のローテーションが含まれる場合があります。

SeparableNDFunction

1 つの引数の関数の合計として表される、N 個の引数の関数。

フィールド
components

map<string, Function1D>

関数のコンポーネント(引数/ディメンションごとに 1 つのエントリ)。

constant_price

double

関数の定数部分。

配送

実施する配送。

フィールド
name

string

必須。ID。この設定は変更できません。

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

必須。ID。この設定は変更できません。

capacities[]

ValueDimension

省略可。車両の特性。

cost

PricingStrategy

必須。車両の使用にかかる費用。これらは 1 つの引数の関数であり、車両の走行距離、輸送する重量、輸送するパレットの数です。これらの機能では、メンテナンス、燃料、処理にかかる費用が考慮されます。これらの費用には、前払い費用が含まれる場合があります(車両の使用後に支払われ、ほとんどの場合は下請け契約にした場合に役立ちます)。

pricing

PricingStrategy

省略可。車両が生成される路線(すなわち入力ネットワークの一部ではない)で使用される場合にのみ、支払い側が支払う価格。

allowed_for_generated_lines

bool

必須。生成されたラインにこの車両を使用できるかどうか。false に設定した場合、車両は事前定義された路線に限定されます。

vehicle_position_constraints[]

VehiclePositionConstraint

省略可。現在の車両の強制位置と時間。たとえば、エントリを使用して、車両が特定のハブで始動または終了するという事実をモデル化します。

VehiclePositionConstraint

車両の位置に対する制約。

フィールド
time

DateTime

制約の時間。

hub_id

string

制約のハブ。