Package google.research.middlemileoptimization.v1

فهرست مطالب

MiddleMile Optimization

خدمات مدیریت شبکه تدارکات و مسیریابی محموله ها در داخل. این پروتکل بدون حالت است (پیام ها مستقل هستند)، اگرچه سرویس پشت آن بسیار حالت دار است (دریافت یک پیام ممکن است پاسخ ها را برای بسیاری از روش ها به شدت تغییر دهد، مانند مسیریابی یک محموله ممکن است مسیریابی محموله های دیگر را تغییر دهد).

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 ایجاد می کند.

ایجاد شبکه

rpc CreateNetwork( CreateNetworkRequest ) returns ( Network )

یک شبکه ایجاد می کند.

Create Vehicle

rpc CreateVehicle( CreateVehicleRequest ) returns ( Vehicle )

یک وسیله نقلیه ایجاد می کند.

DeleteHub

rpc DeleteHub( DeleteHubRequest ) returns ( Empty )

یک هاب را حذف می کند.

DeleteLine

rpc DeleteLine( DeleteLineRequest ) returns ( Empty )

یک خط را حذف می کند.

DeleteLineRotation

rpc DeleteLineRotation( DeleteLineRotationRequest ) returns ( Empty )

یک LineRotation را حذف می کند.

حذف شبکه

rpc DeleteNetwork( DeleteNetworkRequest ) returns ( Empty )

یک شبکه را حذف می کند.

حذف ارسال

rpc DeleteShipment( DeleteShipmentRequest ) returns ( Empty )

یک محموله را حذف می کند.

Delete Vehicle

rpc DeleteVehicle( DeleteVehicleRequest ) returns ( Empty )

یک وسیله نقلیه را حذف می کند.

GetHub

rpc GetHub( GetHubRequest ) returns ( Hub )

جزئیات یک هاب را دریافت می کند.

GetLine

rpc GetLine( GetLineRequest ) returns ( Line )

جزئیات یک خط را دریافت می کند.

GetLineRotation

rpc GetLineRotation( GetLineRotationRequest ) returns ( LineRotation )

جزئیات یک LineRotation را دریافت می کند.

GetNetwork

rpc GetNetwork( GetNetworkRequest ) returns ( Network )

جزئیات یک شبکه را دریافت می کند.

دریافت ارسال

rpc GetShipment( GetShipmentRequest ) returns ( Shipment )

جزئیات یک محموله را دریافت می کند.

GetVehicle

rpc GetVehicle( GetVehicleRequest ) returns ( Vehicle )

جزئیات یک وسیله نقلیه را دریافت می کند.

ListHubs

rpc ListHubs( ListHubsRequest ) returns ( ListHubsResponse )

هاب ها را فهرست می کند.

ListLine Rotations

rpc ListLineRotations( ListLineRotationsRequest ) returns ( ListLineRotationsResponse )

LineRotations را فهرست می کند.

لیست خطوط

rpc ListLines( ListLinesRequest ) returns ( ListLinesResponse )

خطوط را فهرست می کند.

ListNetworks

rpc ListNetworks( ListNetworksRequest ) returns ( ListNetworksResponse )

شبکه را فهرست می کند.

ListPaths

rpc ListPaths( ListPathsRequest ) returns ( ListPathsResponse )

تمام مسیرهایی که در حال حاضر در دسترس هستند را برمی گرداند. این روش بی توان است و عارضه ای ندارد.

فهرست ارسال ها

rpc ListShipments( ListShipmentsRequest ) returns ( ListShipmentsResponse )

محموله ها را فهرست می کند.

ListVehicles

rpc ListVehicles( ListVehiclesRequest ) returns ( ListVehiclesResponse )

وسایل نقلیه را لیست می کند.

MakeHubAvailable

rpc MakeHubAvailable( MakeHubAvailableRequest ) returns ( MakeHubAvailableResponse )

هاب را در دسترس قرار می دهد.

MakeHub Unavailable

rpc MakeHubUnavailable( MakeHubUnavailableRequest ) returns ( MakeHubUnavailableResponse )

هاب را از دسترس خارج می کند.

MakeLineAvailable

rpc MakeLineAvailable( MakeLineAvailableRequest ) returns ( MakeLineAvailableResponse )

یک خط را در دسترس قرار می دهد.

MakeLine Unavailable

rpc MakeLineUnavailable( MakeLineUnavailableRequest ) returns ( MakeLineUnavailableResponse )

یک خط را از دسترس خارج می کند.

Make VehicleAvailable

rpc MakeVehicleAvailable( MakeVehicleAvailableRequest ) returns ( MakeVehicleAvailableResponse )

وسیله نقلیه را در دسترس قرار می دهد.

Make VehicleUnavailable

rpc MakeVehicleUnavailable( MakeVehicleUnavailableRequest ) returns ( MakeVehicleUnavailableResponse )

وسیله نقلیه را از دسترس خارج می کند.

ارسال مسیر

rpc RouteShipment( RouteShipmentRequest ) returns ( RouteShipmentResponse )

مسیر یک محموله جدید مشابه ایجاد، این عملیات متضمن تغییر حالت است.

UpdateHub

rpc UpdateHub( UpdateHubRequest ) returns ( Hub )

یک هاب را به روز می کند.

UpdateLine

rpc UpdateLine( UpdateLineRequest ) returns ( Line )

یک خط را به روز می کند.

UpdateLineRotation

rpc UpdateLineRotation( UpdateLineRotationRequest ) returns ( LineRotation )

یک LineRotation را به روز می کند.

به روز رسانی شبکه

rpc UpdateNetwork( UpdateNetworkRequest ) returns ( Network )

یک شبکه را به روز می کند.

UpdatePath

rpc UpdatePath( UpdatePathRequest ) returns ( Path )

مسیر یک محموله را تغییر می‌دهد: به جای استفاده از سرویس محاسبه‌شده، حالت شامل مسیری می‌شود که کاربر از طریق این تماس تنظیم کرده است.

Update Vehicle

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

ضروری. نام محموله ای که مسیر آن باید متعهد باشد. قالب: "شبکه/{شبکه}/محموله/{حمل و نقل}"

path_to_commit فیلد اتحادیه. مسیر یا قسمت هایی از مسیری که باید انجام شود. path_to_commit تنها می تواند یکی از موارد زیر باشد:
complete_shipment_path

PathToCommit

بخش های یک مسیر از مبدا به مقصد.

segments

IncompletePathToCommit

زیرمجموعه‌ای از بخش‌های یک مسیر از مبدا به مقصد.

IncompletePathToCommit

بخشی از مسیر متعهد شده است، یعنی برخی از بخش های بین مبدا و مقصد.

زمینه های
segments[]

PathSegment

ضروری. زیرمجموعه‌ای از بخش‌های یک مسیر از مبدا به مقصد.

PathToCommit

مسیر کامل در حال انجام، از مبدا تا مقصد.

زمینه های
segments[]

PathSegment

ضروری. بخش ها باید به ترتیب باشند، از منبع تا مقصد.

CreateHubRequest

پیام درخواست متد CreateHub .

زمینه های
parent

string

ضروری. منبع والد که در آن این مرکز ایجاد خواهد شد. قالب: "شبکه/{شبکه}"

hub_id

string

ضروری. شناسه هاب برای ایجاد.

hub

Hub

ضروری. هاب برای ایجاد.

CreateLineRequest

پیام درخواست متد CreateLine .

زمینه های
parent

string

ضروری. منبع والد که در آن این خط ایجاد خواهد شد. قالب: "شبکه/{شبکه}"

line_id

string

ضروری. شناسه خط برای ایجاد.

line

Line

ضروری. خط برای ایجاد.

CreateLineRotationRequest

پیام درخواست متد CreateLineRotation .

زمینه های
parent

string

ضروری. منبع والد که در آن این چرخش خط ایجاد خواهد شد. قالب: "networks/{network}/lines/{line}"

line_rotation_id

string

ضروری. شناسه چرخش خط برای ایجاد.

line_rotation

LineRotation

ضروری. چرخش خط برای ایجاد.

ایجاد درخواست شبکه

پیام درخواست برای متد CreateNetwork .

زمینه های
network_id

string

ضروری. شناسه شبکه برای ایجاد.

network

Network

ضروری. شبکه برای ایجاد.

CreateVehicleRequest

پیام درخواست متد CreateVehicle .

زمینه های
parent

string

ضروری. منبع اصلی که این وسیله نقلیه در آن ایجاد خواهد شد. قالب: "شبکه/{شبکه}"

vehicle_id

string

ضروری. شناسه وسیله نقلیه برای ایجاد.

vehicle

Vehicle

ضروری. وسیله نقلیه برای ایجاد.

CrossDockingCapacity

ظرفیت کلی کراس داک برای یک هاب.

زمینه های
capacity_per_hour[]

ValueDimension

اختیاری. ظرفیت اتصال متقابل برای هر بعد.

CrossDockingTime

زمان کلی کراس داک برای یک هاب.

زمینه های
time_constant

Duration

اختیاری. زمان ثابت برای عملیات کراس داک.

time

SeparableNDFunction

اختیاری. تفکیک پذیری یک فرض ساده کننده است.

محدوده تاریخ

محدوده زمان بین دو 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

ضروری. نام شبکه ای که باید حذف شود. قالب: "شبکه/{شبکه}"

force

bool

اختیاری. اگر روی true تنظیم شده است، منابع فرزند را حذف کنید.

DeleteShipmentRequest

پیام درخواست برای روش DeleteShipment .

زمینه های
name

string

ضروری. نام محموله برای حذف. قالب: "شبکه/{شبکه}/محموله/{حمل و نقل}"

DeleteVehicleRequest

پیام درخواست برای روش DeleteVehicle .

زمینه های
name

string

ضروری. نام وسیله نقلیه برای حذف. قالب: "networks/{network}/vehicles/{vehicle}"

DistanceMatrixEntry

فاصله بین یک مرکز منبع و یک مرکز مقصد.

زمینه های
source_hub

string

ضروری. مرکز منبع.

destination_hub

string

ضروری. مرکز مقصد.

weights[]

ValueDimension

ضروری. فاصله بین هاب ها در چند بعد اندازه گیری می شود.

دیررس بودن

تابع هزینه به دلیل رسیدن/خروج محموله زودتر یا دیرتر از زمان مورد نیاز (محدودیت های نرم).

زمینه های
maximum_earliness

Duration

اختیاری. حداکثر زودرسی مجاز فقط با هزینه مفید است.

maximum_tardiness

Duration

اختیاری. حداکثر تاخیر مجاز. فقط با هزینه مفید است.

earliness_cost

Function1D

اختیاری. هزینه زودرس بودن تنظیم اگر هزینه ای برای زودهنگام وجود ندارد.

tardiness_cost

Function1D

اختیاری. هزینه تاخیر اگر برای تاخیر هزینه ای نداشته باشد تنظیم نشود.

تابع 1D

تابع یک آرگومان

زمینه های
function میدان اتحادیه وحدت آرگومان تابع فرض می شود: - اگر یک وزن: کیلوگرم - اگر یک زمان: دقیقه - اگر تعدادی پالت: 1 function می تواند تنها یکی از موارد زیر باشد:
constant

double

تابع یک ثابت است.

pwl

PieceWiseAffineFunction

تابع به صورت تکه ای خطی است.

GeneratedLineAndRotation

یک چرخش یک خط که توسط این API ایجاد می شود و نه مشتری API. ذاتاً محدودیت کمتری دارد و می تواند از هر وسیله نقلیه ای استفاده کند (مگر اینکه مشتری API در تماس های بعدی تصمیم دیگری بگیرد).

زمینه های
arrival_times

map<string, DateTime >

فقط خروجی نقشه بین شناسه هاب و زمان. این نقشه قرار است کلیدهای یکسانی داشته باشد (منهای مرکز منبع، بدون زمان رسیدن).

departure_times

map<string, DateTime >

فقط خروجی نقشه بین شناسه هاب و زمان. این نقشه قرار است کلیدهای یکسانی داشته باشد (منهای هاب مقصد، بدون زمان حرکت).

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

ضروری. نام شبکه ای که باید بازیابی شود. قالب: "شبکه/{شبکه}"

GetShipmentRequest

پیام درخواست برای روش GetShipment .

زمینه های
name

string

ضروری. نام محموله برای بازیابی. قالب: "شبکه/{شبکه}/محموله/{حمل و نقل}"

GetVehicleRequest

پیام درخواست متد GetVehicle .

زمینه های
name

string

ضروری. نام وسیله نقلیه برای بازیابی قالب: "networks/{network}/vehicles/{vehicle}"

هاب

محموله ها باید از یک مرکز به مرکز دیگر منتقل شوند.

زمینه های
name

string

ضروری. مشخص کننده. نمی توان به روز کرد.

position

LatLng

اختیاری. موقعیت برای محاسبه مسیرهای دنیای واقعی.

opening_times[]

DateTimeRange

ضروری. ساعات شروع. در حال حاضر، از یک نمایش بسیار تقریبی استفاده کنید: هر بار که هاب باز می شود یک ورودی (اگر کارگران آن استراحت ناهار داشته باشند و کسی در آن زمان کار نکند، دو ورودی برای آن روز وجود خواهد داشت).

cross_docking_capacity

CrossDockingCapacity

اختیاری. ظرفیت هاب کامل

cross_docking_time

CrossDockingTime

اختیاری. زمان انجام یک عملیات کراس داکینگ (در هر وسیله نقلیه).

Integer Range

محدوده اعداد صحیح

زمینه های
start_value

int32

در صورت تنظیم نشدن فاصله باز است.

end_value

int32

در صورت تنظیم نشدن فاصله باز است.

خط

خطی که در فرکانس معینی کار می کند.

زمینه های
name

string

ضروری. مشخص کننده. نمی توان به روز کرد.

hub_ids[]

string

ضروری. فهرست هاب هایی که این خط با آنها تماس می گیرد، به ترتیبی که وسایل نقلیه در آنها توقف می کنند.

چرخش خط

یک وسیله نقلیه در یک زمان خاص شروع به کار با این خط می کند.

زمینه های
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

ضروری. والدینی که مالک این مجموعه هاب هستند. قالب: "شبکه/{شبکه}"

page_size

int32

اختیاری. حداکثر تعداد هاب برای بازگشت. ممکن است سرویس کمتر از این مقدار برگرداند. اگر نامشخص باشد، حداکثر 50 هاب بازگردانده می شود. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 اجباری می شود.

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 برگردانده می شود. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 اجباری می شود.

page_token

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی ListLineRotations . این را برای بازیابی صفحه بعدی ارائه کنید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListLineRotations باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

ListLineRotationsResponse

پیام پاسخ برای روش ListLineRotations .

زمینه های
line_rotations[]

LineRotation

چرخش خط از شبکه و خط مشخص شده.

next_page_token

string

یک نشانه، که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

ListLinesRequest

پیام درخواست متد ListLines .

زمینه های
parent

string

ضروری. والد که مالک این مجموعه خطوط است. قالب: "شبکه/{شبکه}"

page_size

int32

اختیاری. حداکثر تعداد خطوط برای بازگشت. ممکن است سرویس کمتر از این مقدار برگرداند. اگر نامشخص باشد، حداکثر 50 خط برگردانده می شود. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 اجباری می شود.

page_token

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی ListLines . این را برای بازیابی صفحه بعدی ارائه کنید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListLines باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

ListLinesResponse

پیام پاسخ برای متد ListLines .

زمینه های
lines[]

Line

خطوط از شبکه مشخص شده

next_page_token

string

یک نشانه، که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

ListNetworksRequest

پیام درخواست متد ListNetworks .

زمینه های
page_size

int32

اختیاری. حداکثر تعداد شبکه برای بازگشت. ممکن است سرویس کمتر از این مقدار برگرداند. اگر نامشخص باشد، حداکثر 50 شبکه برگردانده می شود. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 اجباری می شود.

page_token

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی ListNetworks . این را برای بازیابی صفحه بعدی ارائه کنید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListNetworks باید با تماسی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

ListNetworksResponse

پیام پاسخ برای متد ListNetworks .

زمینه های
networks[]

Network

لیست شبکه ها

next_page_token

string

یک نشانه، که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

ListPathsRequest

پیام درخواست متد ListPaths .

زمینه های
parent

string

ضروری. نام شبکه ای که مسیرها باید برای آن ارسال شوند. قالب: "شبکه/{شبکه}"

page_size

int32

اختیاری. حداکثر تعداد شبکه برای بازگشت. ممکن است سرویس کمتر از این مقدار برگرداند. اگر نامشخص باشد، حداکثر 50 شبکه برگردانده می شود. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 اجباری می شود.

page_token

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی ListNetworks . این را برای بازیابی صفحه بعدی ارائه کنید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListNetworks باید با تماسی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

ListPathsResponse

پیام پاسخ برای متد ListPaths .

زمینه های
paths[]

Path

لیست مسیرها

next_page_token

string

یک نشانه، که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

ListShipmentsRequest

پیام درخواست برای روش ListShipments .

زمینه های
parent

string

ضروری. والدینی که مالک این مجموعه محموله ها هستند. قالب: "شبکه/{شبکه}"

page_size

int32

اختیاری. حداکثر تعداد محموله برای بازگشت. ممکن است سرویس کمتر از این مقدار برگرداند. اگر نامشخص باشد، حداکثر 50 محموله عودت داده می شود. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 اجباری می شود.

page_token

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی ListShipments . این را برای بازیابی صفحه بعدی ارائه کنید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListShipments باید با تماسی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

ListShipmentsResponse

پیام پاسخ برای روش ListShipments .

زمینه های
shipments[]

Shipment

محموله ها از شبکه مشخص شده

next_page_token

string

یک نشانه، که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

ListVehiclesRequest

پیام درخواست متد ListVehicles .

زمینه های
parent

string

ضروری. پدر و مادری که مالک این مجموعه وسایل نقلیه است. قالب: "شبکه/{شبکه}"

page_size

int32

اختیاری. حداکثر تعداد وسایل نقلیه برای بازگشت. ممکن است سرویس کمتر از این مقدار برگرداند. اگر نامشخص باشد، حداکثر 50 وسیله نقلیه بازگردانده می شود. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 اجباری می شود.

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 معین می تواند چندین واحد مختلف برای شبکه های مختلف داشته باشد. یک شبکه فقط مجاز به داشتن یک واحد پولی است. واحد باید در ISO 4217 مانند google3/google/type/money.proto کدگذاری شود.

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.

استراتژی قیمت گذاری

یک استراتژی قیمت گذاری

زمینه های
pricing_strategy میدان اتحادیه . یک استراتژی قیمت گذاری pricing_strategy تنها می تواند یکی از موارد زیر باشد:
separable

SeparableNDFunction

استراتژی قیمت گذاری تابعی قابل تفکیک از چندین متغیر است.

RouteShipmentRequest

پیام درخواست برای روش RouteShipment .

زمینه های
parent

string

ضروری. والد، شبکه ای که محموله باید در آن مسیریابی شود. قالب: "شبکه/{شبکه}"

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 شبکه برای شناسایی شبکه برای به روز رسانی استفاده می شود. قالب: "شبکه/{شبکه}"

update_mask

FieldMask

اختیاری. لیست فیلدهایی که باید به روز شوند.

UpdatePathRequest

پیام درخواست متد UpdatePath .

زمینه های
path

Path

ضروری. مسیر جدید برای حمل و نقل

Update VehicleRequest

پیام درخواست برای روش UpdateVehicle .

زمینه های
vehicle

Vehicle

ضروری. وسیله نقلیه برای به روز رسانی

فیلد name خودرو برای شناسایی وسیله نقلیه برای به روز رسانی استفاده می شود. قالب: "networks/{network}/vehicles/{vehicle}"

update_mask

FieldMask

اختیاری. لیست فیلدهایی که باید به روز شوند.

ابعاد ارزش

یک مقدار در امتداد یک بعد از پیش تعریف شده. value فیلد باید روی نوع مربوط به dimension تنظیم شود.

زمینه های
value

int64

اختیاری. ارزش.

dimension

string

ضروری. بعد، ابعاد، اندازه.

وسیله نقلیه

بدون نام، به عنوان یک کلید نقشه در شبکه ذخیره می شود.

زمینه های
name

string

ضروری. مشخص کننده. نمی توان به روز کرد.

capacities[]

ValueDimension

اختیاری. مشخصات وسیله نقلیه

cost

PricingStrategy

ضروری. هزینه استفاده از وسیله نقلیه اینها توابع یک استدلال هستند: مسافتی که وسیله نقلیه طی می کند، وزنی که وسیله نقلیه حمل می کند، تعداد پالت هایی که وسیله نقلیه حمل می کند. این توابع هزینه های نگهداری، سوخت و جابجایی را در بر می گیرند. این هزینه ها ممکن است شامل یک هزینه اولیه باشد (که پس از استفاده از وسیله نقلیه پرداخت می شود که بیشتر برای قراردادهای فرعی مفید است).

pricing

PricingStrategy

اختیاری. هزینه ای که باید توسط طرف پرداخت کننده پرداخت شود، تنها در صورتی که وسیله نقلیه در یک خط تولید شده (یعنی بخشی از شبکه ورودی نیست) استفاده شود.

allowed_for_generated_lines

bool

ضروری. اینکه آیا این وسیله نقلیه می تواند برای خطوط تولید شده استفاده شود یا خیر. اگر روی false تنظیم شود، خودرو در جایی که مجاز است به خطوط از پیش تعریف شده محدود می شود.

vehicle_position_constraints[]

VehiclePositionConstraint

اختیاری. موقعیت های اجباری برای وسیله نقلیه فعلی، همراه با زمان. برای مثال، از ورودی‌ها برای مدل‌سازی این واقعیت استفاده کنید که وسیله نقلیه‌ای که در یک هاب مشخص شروع یا به پایان می‌رسد.

محدودیت موقعیت خودرو

محدودیت در موقعیت یک وسیله نقلیه

زمینه های
time

DateTime

زمان محدودیت

hub_id

string

مرکز محدودیت.