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)

للحصول على تفاصيل الخط.
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)

يسرد الموزعات (Hub).
ListLineRotations

rpc ListLineRotations(ListLineRotationsRequest) returns (ListLineRotationsResponse)

يسرد LineRotations.
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)

يعدِّل LineRotation.
UpdateNetwork

rpc UpdateNetwork(UpdateNetworkRequest) returns (Network)

يعدِّل الشبكة.
UpdatePath

rpc UpdatePath(UpdatePathRequest) returns (Path)

تغيير مسار الشحن: بدلاً من استخدام عملية الشحن المحسوبة بواسطة الخدمة، ستحتوي الحالة على المسار الذي يحدّده المستخدم من خلال هذه المكالمة.
UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

يحدّث مركبة.

AnnotatedPathSegment

يُمثِّل ذلك جزءًا من مسار يتضمّن معلومات أكثر تكرارًا يمكن احتسابها استنادًا إلى "شريحة المسار" و"الشبكة" المتضمّنة. يعرض خادم واجهة برمجة التطبيقات هذه الرسائل عادةً.

الحقول
segment

PathSegment

مطلوبة. الجزء الذي تتم إضافة تعليقات توضيحية إليه
arrival_time

DateTime

النتائج فقط. وقت وصول هذا الجزء
departure_time

DateTime

النتائج فقط. وقت مغادرة هذا الجزء من الرحلة
is_committed

bool

النتائج فقط. ما إذا كان عميل واجهة برمجة التطبيقات قد قرر تنفيذ هذا الجزء من المسار.
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

نطاق الأوقات بين اثنين من التاريخ والوقت. بالنسبة إلى تاريخ ووقت نقاط البيانات، استخدم 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

اختياريّ. وفي حال ضبطها على "صحيح"، احذف الموارد الفرعية.

DeleteLineRotationRequest

رسالة الطلب لطريقة DeleteLineRotation.

الحقول
name

string

مطلوبة. اسم تدوير الخط المراد حذفه. التنسيق: "networks/{network}/lines/{line}/rotations/{rotation}"

DeleteNetworkRequest

رسالة الطلب لطريقة DeleteNetwork.

الحقول
name

string

مطلوبة. اسم الشبكة التي تريد حذفها. التنسيق: "networks/{network}"
force

bool

اختياريّ. وفي حال ضبطها على "صحيح"، احذف الموارد الفرعية.

DeleteShipmentRequest

رسالة الطلب لطريقة DeleteShipment.

الحقول
name

string

مطلوبة. اسم الشحنة المطلوب حذفها التنسيق: "networks/{network}/shipments/{shipment}"

DeleteVehicleRequest

رسالة الطلب لطريقة DeleteVehicle.

الحقول
name

string

مطلوبة. اسم المركبة المطلوب حذفها. التنسيق: "networks/{network}/vehicles/{vehicle}"

DistanceMatrixEntry

المسافة بين الموزع (hub) المصدر والمركز الوجهة.

الحقول
source_hub

string

مطلوبة. مركز المصدر.
destination_hub

string

مطلوبة. مركز الوجهة.
weights[]

ValueDimension

مطلوبة. المسافة بين الموزعات (Hub)، ويتم قياسها بعدة سمات

EarlinessTardiness

تؤدي وظائف التكلفة إلى حدوث وصول/مغادرة الشحنة في وقت أقرب أو متأخر عن الوقت المطلوب (قيود شخصية).

الحقول
maximum_earliness

Duration

اختياريّ. الحد الأقصى المسموح به لمدى الحداثة. مفيد فقط في حدود التكاليف.
maximum_tardiness

Duration

اختياريّ. الحد الأقصى المسموح به للتأخُّر. مفيد فقط في حدود التكاليف.
earliness_cost

Function1D

اختياريّ. تكلفة مدى التوفّر لا يتم تحديد التكلفة إذا كانت المدة قبل ذلك.
tardiness_cost

Function1D

اختياريّ. تكلفة التأخر. يتم إلغاء تحديد قيمة iff بدون تكلفة بسبب التأخر.

الوظيفة1د

دالة وسيطة واحدة

الحقول
حقل الاتحاد function. من المفترض أن تكون وحدة وسيطة الدالة على النحو التالي: - إذا كان الوزن: كجم - إذا كان الوقت: دقيقة - إذا كان عدد المنصات - 1 function هو معيار واحد فقط مما يلي:
constant

double

الدالة هي قيمة ثابتة.
pwl

PieceWiseAffineFunction

الدالة خطية متعدِّدة التعريف.

GeneratedLineAndRotation

عملية تدوير واحدة للسطر الذي يتم إنشاؤه بواسطة واجهة برمجة التطبيقات هذه وليس عميل واجهة برمجة التطبيقات وهي بطبيعتها أقل تقييدًا، ويمكنها استخدام أي مركبة (ما لم يقرر عميل واجهة برمجة التطبيقات خلاف ذلك في الطلبات اللاحقة).

الحقول
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

مطلوبة. اسم الشبكة التي تريد استردادها. التنسيق: "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

اختياريّ. الوقت المستغرق لإجراء عملية تثبيت متقاطع واحدة (لكل مركبة).

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

مطلوبة. الوحدة الرئيسية التي تملك هذه المجموعة من الموزعات (hub) التنسيق: "networks/{network}"
page_size

int32

اختياريّ. الحد الأقصى لعدد الموزعات (hub) المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. في حال عدم تحديده، سيتم عرض 50 موزعًا (hub) كحد أقصى. الحد الأقصى للقيمة هي 1000، وسيتم فرض القيم الأعلى من 1000 على 1000.
page_token

string

اختياريّ. رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "ListHubs". ويمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListHubs مع الاستدعاء الذي قدّم الرمز المميّز للصفحة.

ListHubsResponse

رسالة الردّ على طريقة ListHubs

الحقول
hubs[]

Hub

الموزعات (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

مطلوبة. العنصر الرئيسي الذي يملك هذه المجموعة من الأسطر. التنسيق: "networks/{network}"
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

مطلوبة. اسم الشبكة التي يجب إرسال المسارات إليها. التنسيق: "networks/{network}"
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

مطلوبة. الشركة الرئيسية التي تملك مجموعة الشحنات هذه التنسيق: "networks/{network}"
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

مطلوبة. أحد الوالدَين الذي يملك هذه المجموعة من المركبات التنسيق: "networks/{network}"
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

المسارات التي تم تعديلها

الشبكة

تصف الشبكة الحالية الكاملة التي يمكن استخدامها. قد يمتلك عميل واجهة برمجة تطبيقات معيّن عدة شبكات (مثل الشبكة الرئيسية وتعديل محتمل في المستقبل لتقييمه).

الحقول
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

تمثِّل هذه السمة جزءًا من مسار، سواء تم إرساله من قِبل عميل واجهة برمجة التطبيقات إلى خادم واجهة برمجة التطبيقات (على سبيل المثال، تغيير الحالة) أو من خلال خادم واجهة برمجة التطبيقات إلى عميل واجهة برمجة التطبيقات (مثل توجيه شحنة).

الحقول
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

نهاية المقطع: ص.

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

اختياريّ. تشير اتفاقيات مستوى الخدمة إلى احتمال تجاوز هذا الوقت مع بعض العقوبات. (إذا بعد الحد الأقصى، لن تكون الحزمة أكثر فائدة.) ويتم تحديد العقوبة من خلال دالة التأخير (بالدقائق).
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

قيمة على طول سمة واحدة محدّدة مسبقًا. يجب ضبط الحقل 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

مركز القيد.