ShipmentModel

string

نام نمایشی تعریف شده توسط کاربر برای محموله. می تواند حداکثر 63 کاراکتر باشد و ممکن است از نویسه های UTF-8 استفاده کند.

object ( VisitRequest )

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

object ( VisitRequest )

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

map (key: string, value: object ( Load ))

نیازهای بار حمل و نقل (به عنوان مثال وزن، حجم، تعداد پالت ها و غیره). کلیدهای نقشه باید شناسه‌هایی باشند که نوع بار مربوطه را توصیف می‌کنند و در حالت ایده‌آل، واحدها را نیز شامل می‌شوند. به عنوان مثال: "weight_kg"، "volume_gallons"، "pallet_count"، و غیره. اگر کلید داده شده در نقشه ظاهر نشود، بار مربوطه به عنوان null در نظر گرفته می شود.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

integer

مجموعه وسایل نقلیه ای که ممکن است این حمل و نقل را انجام دهند. اگر خالی باشد، همه وسایل نقلیه می توانند آن را انجام دهند. وسایل نقلیه با شاخص آنها در لیست vehicles ShipmentModel ارائه می شوند.

number

هزینه ای را که هنگام تحویل این محموله توسط هر وسیله نقلیه متحمل می شود را مشخص می کند. اگر مشخص شده باشد، باید یکی از این موارد را داشته باشد:

• همان تعداد عناصر costsPerVehicleIndices . costsPerVehicle[i] مربوط به costsPerVehicleIndices[i] مدل است.
• همان تعداد عناصری که وسایل نقلیه در مدل وجود دارد. عنصر i با وسیله نقلیه #i مدل مطابقت دارد.

این هزینه ها باید در واحد penaltyCost باشد و نباید منفی باشد. اگر چنین هزینه هایی وجود ندارد، این قسمت را خالی بگذارید.

integer

شاخص های وسایل نقلیه که costsPerVehicle برای آنها اعمال می شود. اگر خالی نباشد، باید همان تعداد عناصر costsPerVehicle را داشته باشد. شاخص خودرو را نمی توان بیش از یک بار مشخص کرد. اگر یک وسیله نقلیه از costsPerVehicleIndices حذف شود، هزینه آن صفر است.

string ( Duration format)

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

برای مثال، اجازه دهید t کوتاه‌ترین زمان برای رفتن مستقیم از جایگزین انتخاب‌شده به جایگزین تحویل انتخاب‌شده باشد. سپس تنظیم pickupToDeliveryAbsoluteDetourLimit اعمال می شود:

startTime(delivery) - startTime(pickup) <=
t + pickupToDeliveryAbsoluteDetourLimit

اگر هر دو محدودیت نسبی و مطلق در یک محموله مشخص شده باشند، از حد محدودتر برای هر جفت تحویل/تحویل ممکن استفاده می شود. از سال ۲۰۱۷/۲۰۱۰، انحراف‌ها فقط زمانی پشتیبانی می‌شوند که مدت زمان سفر به وسایل نقلیه بستگی نداشته باشد.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

string ( Duration format)

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

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

string

رشته غیر خالی که یک "نوع" را برای این محموله مشخص می کند. از این ویژگی می توان برای تعریف ناسازگاری ها یا الزامات بین shipment_types استفاده کرد (به shipmentTypeIncompatibilities و shipmentTypeRequirements در ShipmentModel مراجعه کنید).

با visitTypes که برای یک بازدید مشخص می‌شود متفاوت است: همه تحویل‌ها/تحویل‌های متعلق به یک محموله، shipmentType یکسانی دارند.

string

یک برچسب برای این محموله مشخص می کند. این برچسب در پاسخ در shipmentLabel مربوطه ShipmentRoute.Visit گزارش شده است.

boolean

اگر درست است، از این ارسال صرف نظر کنید، اما penaltyCost اعمال نکنید.

نادیده گرفتن یک محموله منجر به خطای اعتبار سنجی زمانی می شود که در مدل هر گونه shipmentTypeRequirements وجود داشته باشد.

نادیده گرفتن محموله ای که در injectedFirstSolutionRoutes یا injectedSolutionConstraint انجام می شود مجاز است. حل کننده بازدیدهای دریافت/تحویل مربوطه را از مسیر در حال انجام حذف می کند. precedenceRules که به محموله های نادیده گرفته شده ارجاع می دهند نیز نادیده گرفته می شوند.

number

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

مهم : اگر این جریمه مشخص نشده باشد، بی نهایت در نظر گرفته می شود، یعنی حمل و نقل باید تکمیل شود.

number

حداکثر زمان انحراف نسبی را در مقایسه با کوتاه ترین مسیر از تحویل گرفتن تا تحویل مشخص می کند. اگر مشخص شده باشد، باید غیرمنفی باشد و محموله باید حداقل شامل یک تحویل و یک تحویل باشد.

برای مثال، اجازه دهید t کوتاه‌ترین زمان برای رفتن مستقیم از جایگزین انتخاب‌شده به جایگزین تحویل انتخاب‌شده باشد. سپس تنظیم pickupToDeliveryRelativeDetourLimit اعمال می شود:

startTime(delivery) - startTime(pickup) <=
std::ceil(t * (1.0 + pickupToDeliveryRelativeDetourLimit))

اگر هر دو محدودیت نسبی و مطلق در یک محموله مشخص شده باشند، از حد محدودتر برای هر جفت تحویل/تحویل ممکن استفاده می شود. از سال ۲۰۱۷/۲۰۱۰، انحراف‌ها فقط زمانی پشتیبانی می‌شوند که مدت زمان سفر به وسایل نقلیه بستگی نداشته باشد.

object ( LatLng )

مکان جغرافیایی که وسیله نقلیه هنگام انجام این VisitRequest به آنجا می رسد. اگر مدل حمل و نقل دارای ماتریس فاصله مدت باشد، arrivalLocation نباید مشخص شود.

object ( Waypoint )

نقطه ای که وسیله نقلیه هنگام انجام این VisitRequest به آنجا می رسد. اگر مدل حمل‌ونقل دارای ماتریس‌های فاصله مدت باشد، arrivalWaypoint نباید مشخص شود.

object ( LatLng )

موقعیت جغرافیایی که وسیله نقلیه پس از تکمیل این VisitRequest از آنجا حرکت می کند. اگر همان arrivalLocation باشد می توان آن را حذف کرد. اگر مدل حمل و نقل دارای ماتریس های فاصله مدت باشد، departureLocation نباید مشخص شود.

object ( Waypoint )

نقطه ای که وسیله نقلیه پس از تکمیل این VisitRequest حرکت می کند. در صورتی که همان arrivalWaypoint باشد می توان آن را حذف کرد. اگر مدل حمل و نقل دارای ماتریس فاصله مدت زمان باشد، departureWaypoint نباید مشخص شود.

string

برچسب های پیوست شده به درخواست بازدید را مشخص می کند. رشته های خالی یا تکراری مجاز نیستند.

object ( TimeWindow )

پنجره های زمانی که زمان ورود را در یک بازدید محدود می کند. توجه داشته باشید که یک وسیله نقلیه ممکن است خارج از پنجره زمان رسیدن حرکت کند، یعنی زمان ورود + مدت زمان لازم نیست در یک پنجره زمانی باشد. اگر وسیله نقلیه قبل از TimeWindow.start_time برسد، این می تواند منجر به زمان انتظار شود.

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

پنجره های زمانی باید از هم گسسته باشند، یعنی هیچ پنجره زمانی نباید با دیگری همپوشانی داشته باشد یا در مجاورت آن قرار گیرد و باید به ترتیب افزایشی باشند.

costPerHourAfterSoftEndTime و softEndTime فقط در صورتی می توان تنظیم کرد که یک پنجره زمانی واحد وجود داشته باشد.

string ( Duration format)

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

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

number

هزینه سرویس این درخواست بازدید در مسیر وسیله نقلیه. این می تواند برای پرداخت هزینه های مختلف برای هر بار تحویل یا تحویل یک محموله استفاده شود. این هزینه باید همان واحد Shipment.penalty_cost باشد و نباید منفی باشد.

map (key: string, value: object ( Load ))

بارگیری تقاضاهای این درخواست بازدید. این درست مانند فیلد Shipment.load_demands است، با این تفاوت که به جای کل Shipment ، فقط برای این VisitRequest اعمال می شود. درخواست های فهرست شده در اینجا به درخواست های فهرست شده در Shipment.load_demands اضافه می شوند.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

string

انواع بازدید را مشخص می کند. این ممکن است برای اختصاص زمان اضافی مورد نیاز برای یک وسیله نقلیه برای تکمیل این بازدید استفاده شود (به Vehicle.extra_visit_duration_for_visit_type مراجعه کنید).

یک نوع فقط یک بار می تواند ظاهر شود.

string

یک برچسب برای این VisitRequest مشخص می کند. این برچسب در پاسخ به عنوان visitLabel در ShipmentRoute.Visit مربوطه گزارش شده است.

number

عرض جغرافیایی بر حسب درجه باید در محدوده [-90.0، +90.0] باشد.

number

طول جغرافیایی بر حسب درجه باید در محدوده [-180.0، +180.0] باشد.

boolean

اختیاری. نشان می دهد که مکان این ایستگاه بین راهی برای توقف خودرو در سمت خاصی از جاده ترجیح داده می شود. هنگامی که این مقدار را تنظیم می کنید، مسیر از محل عبور می کند تا وسیله نقلیه بتواند در کنار جاده ای که مکان از مرکز جاده به سمت آن سوگیری دارد، توقف کند. این گزینه برای حالت سفر "WALKING" کار نمی کند.

object ( Location )

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

string

شناسه مکان POI مرتبط با ایستگاه بین راه.

object ( LatLng )

مختصات جغرافیایی نقطه راه.

integer

عنوان قطب نما با جهت جریان ترافیک مرتبط است. این مقدار برای تعیین سمت جاده مورد استفاده برای حمل و نقل استفاده می شود. مقادیر سرفصل می تواند از 0 تا 360 باشد، جایی که 0 یک عنوان شمال را مشخص می کند، 90 عنوان یک عنوان شرق و غیره را مشخص می کند.

string ( Timestamp format)

زمان شروع پنجره زمان سخت. اگر مشخص نباشد روی ShipmentModel.global_start_time تنظیم می شود.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

زمان پایان پنجره زمان سخت. اگر مشخص نشده باشد، روی ShipmentModel.global_end_time تنظیم می شود.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

زمان شروع نرم پنجره زمان.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

زمان پایان نرم پنجره زمانی.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

number

اگر رویداد قبل از softStartTime رخ دهد، یک هزینه در ساعت به سایر هزینه‌های مدل اضافه می‌شود، که به صورت زیر محاسبه می‌شود:

   max(0, softStartTime - t.seconds)
                          * costPerHourBeforeSoftStartTime / 3600,
t being the time of the event.

این هزینه باید مثبت باشد و فقط در صورتی می توان فیلد را تنظیم کرد که softStartTime تنظیم شده باشد.

number

اگر رویداد پس از softEndTime اتفاق بیفتد، یک هزینه در ساعت به سایر هزینه‌های مدل اضافه می‌شود که به صورت زیر محاسبه می‌شود:

   max(0, t.seconds - softEndTime.seconds)
                    * costPerHourAfterSoftEndTime / 3600,
t being the time of the event.

این هزینه باید مثبت باشد و فقط در صورتی می توان فیلد را تنظیم کرد که softEndTime تنظیم شده باشد.

string

نام نمایشی تعریف شده توسط کاربر برای وسیله نقلیه. می تواند حداکثر 63 کاراکتر باشد و ممکن است از نویسه های UTF-8 استفاده کند.

enum ( TravelMode )

حالت سفر که بر جاده های قابل استفاده وسیله نقلیه و سرعت آن تأثیر می گذارد. همچنین travelDurationMultiple ببینید.

object ( RouteModifiers )

مجموعه ای از شرایط برای برآوردن که بر نحوه محاسبه مسیرها برای وسیله نقلیه معین تأثیر می گذارد.

object ( LatLng )

موقعیت جغرافیایی که وسیله نقلیه قبل از تحویل گرفتن محموله از آنجا شروع می شود. اگر مشخص نشده باشد، وسیله نقلیه در اولین پیکاپ خود استارت می خورد. اگر مدل حمل و نقل دارای ماتریس های مدت و فاصله باشد، startLocation نباید مشخص شود.

object ( Waypoint )

نقطه راه نشان دهنده یک موقعیت جغرافیایی است که وسیله نقلیه قبل از تحویل گرفتن محموله از آنجا شروع می شود. اگر نه startWaypoint و نه startLocation مشخص شده باشد، وسیله نقلیه در اولین بار استارت می خورد. اگر مدل حمل و نقل دارای ماتریس های مدت و فاصله باشد، startWaypoint نباید مشخص شود.

object ( LatLng )

موقعیت جغرافیایی جایی که وسیله نقلیه پس از تکمیل آخرین VisitRequest خود به پایان می رسد. اگر مشخص نشده باشد، ShipmentRoute وسیله نقلیه بلافاصله پس از تکمیل آخرین VisitRequest خود به پایان می رسد. اگر مدل حمل و نقل دارای ماتریس های مدت و فاصله باشد، endLocation نباید مشخص شود.

object ( Waypoint )

نقطه راه نشان دهنده یک مکان جغرافیایی است که خودرو پس از تکمیل آخرین VisitRequest خود در آن به پایان می رسد. اگر نه endWaypoint و نه endLocation مشخص نشده باشد، ShipmentRoute وسیله نقلیه بلافاصله پس از تکمیل آخرین VisitRequest خود به پایان می رسد. اگر مدل حمل و نقل دارای ماتریس های مدت و فاصله باشد، endWaypoint نباید مشخص شود.

string

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

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

string

برچسب های متصل به انتهای مسیر وسیله نقلیه را مشخص می کند.

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

object ( TimeWindow )

پنجره های زمانی که در طی آن وسیله نقلیه ممکن است محل شروع خود را ترک کند. آنها باید در محدوده زمانی جهانی باشند (به فیلدهای ShipmentModel.global_* مراجعه کنید). اگر نامشخص باشد، هیچ محدودیتی در کنار آن محدودیت های زمانی جهانی وجود ندارد.

پنجره‌های زمانی متعلق به یک فیلد تکراری باید جدا باشند، یعنی هیچ پنجره زمانی نمی‌تواند با دیگری همپوشانی داشته باشد یا مجاور آن باشد و باید به ترتیب زمانی باشند.

costPerHourAfterSoftEndTime و softEndTime فقط در صورتی می توان تنظیم کرد که یک پنجره زمانی واحد وجود داشته باشد.

object ( TimeWindow )

پنجره های زمانی که در طی آن وسیله نقلیه ممکن است به مکان پایانی خود برسد. آنها باید در محدوده زمانی جهانی باشند (به فیلدهای ShipmentModel.global_* مراجعه کنید). اگر نامشخص باشد، هیچ محدودیتی در کنار آن محدودیت های زمانی جهانی وجود ندارد.

پنجره‌های زمانی متعلق به یک فیلد تکراری باید جدا باشند، یعنی هیچ پنجره زمانی نمی‌تواند با دیگری همپوشانی داشته باشد یا مجاور آن باشد و باید به ترتیب زمانی باشند.

costPerHourAfterSoftEndTime و softEndTime فقط در صورتی می توان تنظیم کرد که یک پنجره زمانی واحد وجود داشته باشد.

enum ( UnloadingPolicy )

سیاست تخلیه بار در خودرو اعمال شده است.

map (key: string, value: object ( LoadLimit ))

ظرفیت های وسیله نقلیه (به عنوان مثال وزن، حجم، # پالت). کلیدهای موجود در نقشه، شناسه‌های نوع بار هستند که با کلیدهای فیلد Shipment.load_demands مطابقت دارند. اگر یک کلید مشخص در این نقشه وجود نداشته باشد، ظرفیت مربوطه نامحدود در نظر گرفته می شود.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

number

هزینه های خودرو: همه هزینه ها جمع می شوند و باید در همان واحد Shipment.penalty_cost باشند.

هزینه هر ساعت مسیر وسیله نقلیه این هزینه برای کل زمان طی شده توسط مسیر اعمال می شود و شامل زمان سفر، زمان انتظار و زمان بازدید می شود. استفاده از costPerHour به جای costPerTraveledHour ممکن است باعث تاخیر بیشتر شود.

number

هزینه هر ساعت پیموده شده مسیر وسیله نقلیه. این هزینه فقط برای زمان سفر طی مسیر اعمال می شود (یعنی آنچه در ShipmentRoute.transitions گزارش شده است)، و زمان انتظار و زمان بازدید را شامل نمی شود.

number

هزینه هر کیلومتر مسیر وسیله نقلیه این هزینه برای مسافت گزارش شده در ShipmentRoute.transitions اعمال می شود و برای هیچ مسافتی که بطور ضمنی از arrivalLocation تا departureLocation یک VisitRequest طی شده اعمال نمی شود.

number

اگر از این وسیله نقلیه برای حمل و نقل استفاده شود، هزینه ثابت اعمال می شود.

boolean

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

اگر درست باشد، وسیله نقلیه از شروع به مکان پایانی خود می‌رود، حتی اگر هیچ محموله‌ای را ارائه ندهد، و هزینه‌های زمان و مسافت ناشی از سفر شروع --> پایان آن در نظر گرفته می‌شود.

در غیر این صورت، از ابتدا تا مکان پایانی خود حرکت نمی کند و هیچ breakRule یا تاخیری (از TransitionAttributes ) برای این وسیله نقلیه برنامه ریزی نشده است. در این مورد، ShipmentRoute وسیله نقلیه هیچ اطلاعاتی به جز فهرست و برچسب خودرو ندارد.

object ( DurationLimit )

محدودیت برای کل مدت مسیر وسیله نقلیه اعمال می شود. در OptimizeToursResponse معین، طول مدت مسیر یک وسیله نقلیه، تفاوت بین خودروی vehicleEndTime و vehicleStartTime است.

object ( DurationLimit )

محدودیت اعمال شده برای مدت سفر در مسیر وسیله نقلیه. در OptimizeToursResponse معین، مدت زمان سفر مسیر مجموع تمام transitions.travel_duration آن است.

object ( DistanceLimit )

محدودیت در کل مسافت مسیر وسیله نقلیه اعمال می شود. در OptimizeToursResponse معین، مسافت مسیر مجموع تمام transitions.travel_distance_meters آن است.

map (key: string, value: string ( Duration format))

یک نقشه از رشته های visitTypes تا مدت زمان را مشخص می کند. مدت زمانی است که علاوه بر VisitRequest.duration باید در بازدیدهایی با visitTypes مشخص شده گرفته شود. این مدت بازدید اضافی در صورتی که costPerHour مشخص شده باشد، هزینه را اضافه می کند. کلیدها (به عنوان مثال visitTypes ) نمی توانند رشته های خالی باشند.

اگر درخواست بازدید چندین نوع داشته باشد، مدت زمان برای هر نوع در نقشه اضافه می شود.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( BreakRule )

برنامه استراحتی که باید در این وسیله نقلیه اعمال شود را شرح می دهد. در صورت خالی بودن، هیچ استراحتی برای این وسیله نقلیه در نظر گرفته نمی شود.

string

یک برچسب برای این وسیله نقلیه مشخص می کند. این برچسب در پاسخ به عنوان vehicleLabel ShipmentRoute مربوطه گزارش شده است.

boolean

اگر درست باشد، usedIfRouteIsEmpty باید نادرست باشد، و این وسیله بدون استفاده باقی می‌ماند.

اگر یک محموله توسط وسیله نقلیه نادیده گرفته شده در injectedFirstSolutionRoutes انجام شود، در اولین راه حل نادیده گرفته می شود اما انجام آن در پاسخ رایگان است.

اگر یک محموله توسط یک وسیله نقلیه نادیده گرفته شده در injectedSolutionConstraint انجام شود و هرگونه تحویل/تحویل مرتبط محدود به باقی ماندن در وسیله نقلیه باشد (یعنی تا سطح RELAX_ALL_AFTER_THRESHOLD رها نشده باشد)، در پاسخ صرفنظر می شود. اگر یک محموله دارای یک قسمت غیرخالی allowedVehicleIndices باشد و همه وسایل نقلیه مجاز نادیده گرفته شوند، در پاسخ از آن صرفنظر می شود.

number

یک عامل ضربی را مشخص می کند که می تواند برای افزایش یا کاهش زمان سفر این وسیله نقلیه استفاده شود. به عنوان مثال، تنظیم این مورد روی 2.0 به این معنی است که این وسیله نقلیه کندتر است و زمان سفر دو برابر بیشتر از خودروهای استاندارد است. این چند برابر بر مدت زمان بازدید تأثیری ندارد. اگر costPerHour یا costPerTraveledHour مشخص شده باشد، بر هزینه تأثیر می گذارد. این باید در محدوده [0.001، 1000.0] باشد. اگر تنظیم نشده باشد، خودرو استاندارد است و این مضرب 1.0 در نظر گرفته می شود.

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

همچنین extraVisitDurationForVisitType در زیر ببینید.

boolean

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

boolean

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

boolean

مشخص می‌کند که آیا در صورت لزوم از کشتی‌ها اجتناب شود یا خیر. اولویت با مسیرهایی است که شامل سفر با کشتی نباشد. فقط برای حالت های سفر موتوری اعمال می شود.

boolean

اختیاری. مشخص می کند که آیا از پیمایش در داخل خانه در صورت لزوم اجتناب شود. اولویت به مسیرهایی داده می شود که دارای ناوبری داخلی نیستند. فقط برای حالت سفر WALKING اعمال می شود.

string ( int64 format)

حد نرم از بار. به costPerUnitAboveSoftMax مراجعه کنید.

number

اگر بار در طول مسیر این وسیله نقلیه از softMaxLoad بیشتر شود، جریمه هزینه زیر اعمال می شود (فقط یک بار برای هر وسیله نقلیه): (بار - softMaxLoad ) * costPerUnitAboveSoftMax . همه هزینه‌ها جمع می‌شوند و باید در همان واحد Shipment.penalty_cost باشند.

object ( Interval )

فاصله بار قابل قبول وسیله نقلیه در شروع مسیر.

object ( Interval )

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

string ( int64 format)

حداکثر مقدار قابل قبول بار.

string ( int64 format)

حداقل بار قابل قبول باید ≥ 0 باشد. اگر هر دو مشخص شده اند، min باید max ≤ باشد.

string ( int64 format)

حداکثر بار قابل قبول باید ≥ 0 باشد. اگر مشخص نشده باشد، حداکثر بار توسط این پیام محدود نمی شود. اگر هر دو مشخص شده باشند، min باید max ≤ باشد.

string ( Duration format)

یک محدودیت سخت که مدت زمان را حداکثر حداکثر مدت زمان محدود می کند.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

string ( Duration format)

یک محدودیت نرم که حداکثر مدت زمان را اعمال نمی کند، اما در صورت نقض باعث می شود مسیر متحمل هزینه شود. این هزینه به سایر هزینه های تعریف شده در مدل، با همان واحد اضافه می شود.

در صورت تعریف، softMaxDuration باید غیرمنفی باشد. اگر maxDuration نیز تعریف شده باشد، softMaxDuration باید کمتر از maxDuration باشد.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

string ( Duration format)

یک محدودیت نرم که حداکثر مدت زمان را اعمال نمی کند، اما در صورت نقض، مسیر را متحمل هزینه ای می شود که طول مدت آن درجه دوم است. این هزینه با همان واحد به سایر هزینه های تعریف شده در مدل اضافه می شود.

اگر تعریف شده باشد، quadraticSoftMaxDuration باید غیرمنفی باشد. اگر maxDuration نیز تعریف شده باشد، quadraticSoftMaxDuration باید کمتر از maxDuration باشد و تفاوت نباید بیشتر از یک روز باشد:

maxDuration - quadraticSoftMaxDuration <= 86400 seconds

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

number

هزینه هر ساعت در صورت نقض آستانه softMaxDuration متحمل می شود. اگر مدت زمان زیر آستانه باشد، هزینه اضافی 0 است، در غیر این صورت هزینه به مدت زمان زیر بستگی دارد:

  costPerHourAfterSoftMax * (duration - softMaxDuration)

هزینه باید غیرمنفی باشد.

number

هزینه هر ساعت مربع در صورت نقض آستانه quadraticSoftMaxDuration متحمل می شود.

اگر مدت زمان زیر آستانه باشد، هزینه اضافی 0 است، در غیر این صورت هزینه به مدت زمان زیر بستگی دارد:

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

هزینه باید غیرمنفی باشد.

string ( int64 format)

یک حد سخت که فاصله را حداکثر حداکثر حداکثر متر محدود می کند. حد باید غیرمنفی باشد.

string ( int64 format)

یک حد نرم محدودیت حداکثر فاصله را اعمال نمی کند، اما زمانی که نقض شود منجر به هزینه ای می شود که به هزینه های دیگر تعریف شده در مدل، با همان واحد اضافه می شود.

اگر softMaxMeters تعریف شده باشد باید کمتر از maxMeters باشد و باید غیرمنفی باشد.

number

هزینه هر کیلومتر متحمل شده، افزایش تا softMaxMeters ، با فرمول:

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

این هزینه در routeDistanceLimit پشتیبانی نمی شود.

number

اگر مسافت بالاتر از حد مجاز softMaxMeters باشد، هزینه هر کیلومتر متحمل می شود. هزینه اضافی 0 است اگر فاصله کمتر از حد باشد، در غیر این صورت فرمول مورد استفاده برای محاسبه هزینه به شرح زیر است:

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

هزینه باید غیرمنفی باشد.

object ( BreakRequest )

توالی وقفه ها پیام BreakRequest را ببینید.

object ( FrequencyConstraint )

ممکن است چندین FrequencyConstraint اعمال شود. همه آنها باید توسط BreakRequest های این BreakRule راضی شوند. FrequencyConstraint ببینید.

string ( Timestamp format)

مورد نیاز. کران پایین (شامل) در شروع استراحت.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

مورد نیاز. کران بالا (شامل) در شروع استراحت.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

string ( Duration format)

مورد نیاز. حداقل مدت زمان استراحت. باید مثبت باشد

مدت زمان در ثانیه با حداکثر نه رقم کسری ، که با " s " پایان می یابد. مثال: "3.5s" .

string ( Duration format)

مورد نیاز. حداقل مدت زمان استراحت برای این محدودیت. غیر منفی به توضیحات FrequencyConstraint مراجعه کنید.

مدت زمان در ثانیه با حداکثر نه رقم کسری ، که با " s " پایان می یابد. مثال: "3.5s" .

string ( Duration format)

مورد نیاز. حداکثر طول مجاز از هر بازه زمانی در مسیری که حداقل تا حدی شکستگی duration >= minBreakDuration را شامل نمی شود. باید مثبت باشد

مدت زمان در ثانیه با حداکثر نه رقم کسری ، که با " s " پایان می یابد. مثال: "3.5s" .

object ( Row )

ردیف های ماتریس مدت زمان و فاصله را مشخص می کند. این باید به عنوان عناصر زیادی به عنوان ShipmentModel.duration_distance_matrix_src_tags داشته باشد.

string

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

هر شروع وسیله نقلیه باید دقیقاً با یک ماتریس مطابقت داشته باشد ، یعنی دقیقاً یکی از میدان startTags آنها باید با vehicleStartTag یک ماتریس (و فقط از آن ماتریس) مطابقت داشته باشد.

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

string ( Duration format)

مقادیر مدت زمان برای یک ردیف معین. این باید به عنوان عناصر زیادی به عنوان ShipmentModel.duration_distance_matrix_dst_tags داشته باشد.

مدت زمان در ثانیه با حداکثر نه رقم کسری ، که با " s " پایان می یابد. مثال: "3.5s" .

number

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

string

برچسب هایی که مجموعه ای از انتقال (SRC-> DST) را تعیین می کند ، این ویژگی ها به آن اعمال می شود.

بازدید از منبع یا شروع وسیله نقلیه در صورت بازدید از VisitRequest.tags یا Vehicle.start_tags یا حاوی srcTag است یا حاوی excludedSrcTag نیست (بسته به اینکه کدام یک از این دو زمینه خالی نیست).

string

به srcTag مراجعه کنید. دقیقاً یکی از srcTag و excludedSrcTag باید غیر خالی باشد.

string

بازدید از مقصد یا پایان Vehicle.end_tags در صورتی dstTag که VisitRequest.tags از آن را انجام excludedDstTag دهد.

string

به dstTag مراجعه کنید. دقیقاً یکی از dstTag و excludedDstTag باید غیر خالی باشد.

number

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

number

هزینه ای را برای هر کیلومتر اعمال شده برای مسافت طی شده هنگام انجام این انتقال مشخص می کند. این به هر Vehicle.cost_per_kilometer اضافه می کند. cost_per_kilometer مشخص شده در وسایل نقلیه.

object ( DistanceLimit )

محدودیت در مسافت طی شده هنگام انجام این انتقال را مشخص می کند.

از سال 2021/06 ، فقط از محدودیت های نرم پشتیبانی می شود.

string ( Duration format)

تأخیر ناشی از انجام این انتقال را مشخص می کند.

این تأخیر همیشه پس از اتمام بازدید منبع و قبل از شروع بازدید از مقصد اتفاق می افتد.

مدت زمان در ثانیه با حداکثر نه رقم کسری ، که با " s " پایان می یابد. مثال: "3.5s" .

string

لیست انواع ناسازگار. دو محموله دارای shipment_types مختلف در میان موارد ذکر شده "ناسازگار" هستند.

enum ( IncompatibilityMode )

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

string

لیست انواع جایگزین حمل و نقل مورد نیاز توسط dependentShipmentTypes .

string

کلیه محموله ها با یک نوع در زمینه dependentShipmentTypes حداقل به یک حمل و نقل از نوع requiredShipmentTypeAlternatives نیاز دارند تا در همان مسیر بازدید کنند.

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

enum ( RequirementMode )

حالت اعمال شده برای نیاز.

boolean

نشان می دهد که آیا رویداد "اول" تحویل است.

boolean

نشان می دهد که آیا رویداد "دوم" تحویل است.

string ( Duration format)

جبران بین رویداد "اول" و "دوم". می تواند منفی باشد.

مدت زمان در ثانیه با حداکثر نه رقم کسری ، که با " s " پایان می یابد. مثال: "3.5s" .

integer

شاخص حمل و نقل رویداد "اولین". این قسمت باید مشخص شود.

integer

شاخص حمل و نقل رویداد "دوم". این قسمت باید مشخص شود.

string

نام نمایشگر تعریف شده توسط کاربر. این می تواند تا 63 کاراکتر طول داشته باشد و ممکن است از شخصیت های UTF-8 استفاده کند.

object ( VisitRequest )

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

object ( VisitRequest )

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

map (key: string, value: object ( Load ))

تقاضای بار حمل و نقل (به عنوان مثال وزن ، حجم ، تعداد پالت و غیره). کلیدهای موجود در نقشه باید شناسه هایی باشند که نوع بار مربوطه را توصیف می کنند ، از نظر ایده آل شامل واحدها نیز می شوند. به عنوان مثال: "Peight_kg" ، "Volume_gallons" ، "PALLET_COUNT" و غیره. اگر یک کلید داده شده در نقشه ظاهر نشود ، بار مربوطه به عنوان تهی در نظر گرفته می شود.

یک شیء حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

integer

مجموعه وسایل نقلیه که ممکن است این محموله را انجام دهند. اگر خالی باشد ، ممکن است همه وسایل نقلیه آن را انجام دهند. وسایل نقلیه توسط شاخص آنها در لیست vehicles ShipmentModel داده می شود.

number

هزینه ای را که در هنگام تحویل این حمل و نقل توسط هر وسیله نقلیه متحمل می شود ، مشخص می کند. در صورت مشخص شدن ، باید داشته باشد:

• همان تعداد عناصر به عنوان costsPerVehicleIndices . costsPerVehicle[i] با costsPerVehicleIndices[i] مدل مطابقت دارد.
• همان تعداد عناصر که وسایل نقلیه در مدل وجود دارد. عنصر I-Th با وسیله نقلیه #I مدل مطابقت دارد.

این هزینه ها باید در همان واحد penaltyCost باشد و نباید منفی باشد. اگر چنین هزینه ای وجود نداشته باشد ، این زمینه را خالی بگذارید.

integer

شاخص های وسایل نقلیه که در آن costsPerVehicle اعمال می شود. اگر غیر خالی باشد ، باید همان تعداد عناصر را به عنوان costsPerVehicle داشته باشد. شاخص وسیله نقلیه ممکن است بیش از یک بار مشخص نشود. اگر یک وسیله نقلیه از costsPerVehicleIndices مستثنی باشد ، هزینه آن صفر است.

string ( Duration format)

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

به عنوان مثال ، اجازه دهید T کوتاهترین زمان لازم برای رفتن از جایگزین وانت انتخاب شده به طور مستقیم به گزینه تحویل انتخاب شده باشد. سپس تنظیم pickupToDeliveryAbsoluteDetourLimit :

startTime(delivery) - startTime(pickup) <=
t + pickupToDeliveryAbsoluteDetourLimit

اگر هر دو محدودیت نسبی و مطلق در همان محموله مشخص شوند ، برای هر جفت وانت/تحویل ممکن از محدودیت بیشتر استفاده می شود. از سال 2017/10 ، دوری ها فقط زمانی پشتیبانی می شوند که مدت زمان سفر به وسایل نقلیه وابسته نباشد.

مدت زمان در ثانیه با حداکثر نه رقم کسری ، که با " s " پایان می یابد. مثال: "3.5s" .

string ( Duration format)

حداکثر مدت زمان را از شروع وانت تا شروع تحویل محموله مشخص می کند. در صورت مشخص شدن ، باید غیر منفی باشد و حمل و نقل باید حداقل وانت و تحویل داشته باشد. این بستگی به این ندارد که گزینه های دیگر برای وانت و تحویل و نه به سرعت خودرو انتخاب شده اند. این را می توان در کنار حداکثر محدودیت های دوربرد مشخص کرد: راه حل به هر دو مشخصات احترام می گذارد.

مدت زمان در ثانیه با حداکثر نه رقم کسری ، که با " s " پایان می یابد. مثال: "3.5s" .

string

رشته غیر خالی که "نوع" برای این محموله را مشخص می کند. این ویژگی را می توان برای تعریف ناسازگاری ها یا الزامات بین shipment_types ( shipmentTypeIncompatibilities shipmentTypeRequirements در ShipmentModel مراجعه کنید) استفاده کرد.

با visitTypes مختلف که برای یک بازدید واحد مشخص شده است متفاوت است: کلیه وانت/تحویل های متعلق به همان حمل و نقل با همان shipmentType مشترک هستند.

string

یک برچسب برای این محموله مشخص می کند. این برچسب در پاسخ در shipmentLabel از ShipmentRoute.Visit مربوطه. visit گزارش شده است.

boolean

اگر درست است ، از این محموله پرش کنید ، اما یک penaltyCost اعمال نکنید.

نادیده گرفتن حمل و نقل منجر به خطای اعتبار سنجی در صورت وجود هرگونه shipmentTypeRequirements در مدل می شود.

نادیده گرفتن محموله ای که در injectedFirstSolutionRoutes انجام می شود یا injectedSolutionConstraint مجاز است. حل کننده بازدیدهای وانت/تحویل مربوط را از مسیر عملکرد حذف می کند. precedenceRules که مرجع نادیده گرفته شده از محموله ها نیز نادیده گرفته می شوند.

number

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

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

number

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

به عنوان مثال ، اجازه دهید T کوتاهترین زمان لازم برای رفتن از جایگزین وانت انتخاب شده به طور مستقیم به گزینه تحویل انتخاب شده باشد. سپس تنظیم pickupToDeliveryRelativeDetourLimit :

startTime(delivery) - startTime(pickup) <=
std::ceil(t * (1.0 + pickupToDeliveryRelativeDetourLimit))

اگر هر دو محدودیت نسبی و مطلق در همان محموله مشخص شوند ، برای هر جفت وانت/تحویل ممکن از محدودیت بیشتر استفاده می شود. از سال 2017/10 ، دوری ها فقط زمانی پشتیبانی می شوند که مدت زمان سفر به وسایل نقلیه وابسته نباشد.

object ( LatLng )

مکان جغرافیایی که در آن وسیله نقلیه هنگام انجام این VisitRequest آن وارد می شود. اگر مدل حمل و نقل دارای ماتریس فاصله با مدت زمان باشد ، نباید arrivalLocation مشخص شود.

object ( Waypoint )

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

object ( LatLng )

مکان جغرافیایی که در آن وسیله نقلیه پس از اتمام این VisitRequest از آن خارج می شود. اگر همان arrivalLocation باشد ، می تواند حذف شود. اگر مدل حمل و نقل دارای ماتریس از فاصله زمانی باشد ، نباید departureLocation را مشخص کرد.

object ( Waypoint )

ایستگاه راه که در آن وسیله نقلیه پس از اتمام این VisitRequest از آنجا خارج می شود. اگر همان arrivalWaypoint باشد ، می توان حذف شد. اگر مدل حمل و نقل دارای ماتریس فاصله با مدت زمان باشد ، نباید departureWaypoint مشخص شود.

string

برچسب های پیوست شده به درخواست بازدید را مشخص می کند. رشته های خالی یا کپی مجاز نیستند.

object ( TimeWindow )

ویندوزهای زمانی که زمان ورود را در یک بازدید محدود می کند. توجه داشته باشید که یک وسیله نقلیه ممکن است خارج از پنجره زمان ورود حرکت کند ، یعنی زمان ورود + مدت زمان لازم نیست در یک پنجره زمانی باشد. اگر وسیله نقلیه قبل از TimeWindow.start_time وارد شود ، می تواند به زمان انتظار منجر شود.

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

ویندوزهای زمانی باید از هم جدا شوند ، یعنی هیچ پنجره زمانی نباید با دیگری همپوشانی داشته باشد یا در مجاورت دیگری باشد و باید در حال افزایش باشد.

در صورت وجود یک پنجره زمانی واحد ، costPerHourAfterSoftEndTime و softEndTime فقط قابل تنظیم است.

string ( Duration format)

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

مدت زمان در ثانیه با حداکثر نه رقم کسری ، که با " s " پایان می یابد. مثال: "3.5s" .

number

هزینه خدمات این درخواست بازدید در مسیر وسیله نقلیه. این می تواند برای پرداخت هزینه های مختلف برای هر وانت جایگزین یا تحویل حمل و نقل استفاده شود. این هزینه باید در همان واحد Shipment.penalty_cost باشد. penalty_cost و نباید منفی باشد.

map (key: string, value: object ( Load ))

تقاضای بار این درخواست بازدید. این دقیقاً مانند زمینه Shipment.load_demands است. bload_demands ، به جز این که فقط به جای کل Shipment VisitRequest صدق می کند. مطالبات ذکر شده در اینجا به خواسته های ذکر شده در Shipment.load_demands اضافه می شود. bload_demands.

یک شیء حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

string

انواع بازدید را مشخص می کند. این ممکن است برای تخصیص زمان اضافی مورد نیاز وسیله نقلیه برای تکمیل این بازدید استفاده شود (به Vehicle.extra_visit_duration_for_visit_type مراجعه کنید.

یک نوع فقط یک بار ظاهر می شود.

string

یک برچسب برای این VisitRequest را مشخص می کند. این برچسب در پاسخ به عنوان visitLabel در ShipmentRoute.Visit مربوطه. Visit گزارش شده است.

number

عرض جغرافیایی در درجه. این باید در محدوده باشد [-90.0 ، +90.0].

number

طول جغرافیایی در درجه. این باید در محدوده باشد [-180.0 ، +180.0].

boolean

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

object ( Location )

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

string

شناسه Poi Place در ارتباط با نقطه راه.

object ( LatLng )

مختصات جغرافیایی Waypoint.

integer

عنوان قطب نما همراه با جهت جریان ترافیک. این مقدار برای مشخص کردن سمت جاده برای استفاده برای وانت و کشویی استفاده می شود. مقادیر عنوان می تواند از 0 تا 360 باشد ، جایی که 0 عنوان از شمال را مشخص می کند ، 90 عنوان یک عنوان شرق و غیره را مشخص می کند.

string ( Timestamp format)

زمان شروع پنجره زمان سخت. اگر نامشخص باشد ، آن را به ShipmentModel.global_start_time تنظیم می شود.

Timestamp در قالب RFC3339 UTC "Zulu" ، با وضوح نانو ثانیه و حداکثر نه رقم کسری. مثال: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

زمان پایان پنجره زمان سخت. اگر نامشخص باشد ، آن را به ShipmentModel.global_end_time تنظیم می شود.

Timestamp در قالب RFC3339 UTC "Zulu" ، با وضوح نانو ثانیه و حداکثر نه رقم کسری. مثال: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

زمان شروع نرم پنجره زمان.

Timestamp در قالب RFC3339 UTC "Zulu" ، با وضوح نانو ثانیه و حداکثر نه رقم کسری. مثال: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

زمان پایان نرم پنجره زمان.

Timestamp در قالب RFC3339 UTC "Zulu" ، با وضوح نانو ثانیه و حداکثر نه رقم کسری. مثال: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

number

هزینه در هر ساعت به سایر هزینه های مدل اضافه می شود اگر این رویداد قبل از SoftStartTime رخ دهد ، محاسبه شده است:

   max(0, softStartTime - t.seconds)
                          * costPerHourBeforeSoftStartTime / 3600,
t being the time of the event.

این هزینه باید مثبت باشد و در صورت تنظیم SoftStartTime ، زمینه فقط قابل تنظیم است.

number

در صورت وقوع این رویداد پس از softEndTime ، محاسبه شده به عنوان: محاسبه شده در هر ساعت به سایر هزینه ها در مدل اضافه می شود:

   max(0, t.seconds - softEndTime.seconds)
                    * costPerHourAfterSoftEndTime / 3600,
t being the time of the event.

این هزینه باید مثبت باشد و در صورت تنظیم softEndTime ، می توان زمینه را تنظیم کرد.

string

نام نمایشگر تعریف شده توسط کاربر. این می تواند تا 63 کاراکتر طول داشته باشد و ممکن است از شخصیت های UTF-8 استفاده کند.

enum ( TravelMode )

حالت سفر که بر جاده های قابل استفاده توسط وسیله نقلیه و سرعت آن تأثیر می گذارد. همچنین به travelDurationMultiple مراجعه کنید.

object ( RouteModifiers )

مجموعه ای از شرایط برای برآورده کردن تأثیرگذاری بر نحوه محاسبه مسیرها برای وسیله نقلیه داده شده.

object ( LatLng )

موقعیت جغرافیایی که در آن وسیله نقلیه قبل از انتخاب هرگونه محموله شروع می شود. اگر مشخص نشده باشد ، وسیله نقلیه در اولین وانت خود شروع می شود. اگر مدل حمل و نقل دارای ماتریس مدت و فاصله باشد ، startLocation نباید مشخص شود.

object ( Waypoint )

Waypoint نمایانگر یک مکان جغرافیایی است که در آن وسیله نقلیه قبل از انتخاب هرگونه محموله شروع می شود. اگر نه startWaypoint و نه startLocation مشخص نشده باشد ، وسیله نقلیه در اولین وانت خود شروع می شود. اگر مدل حمل و نقل دارای ماتریس مدت و فاصله باشد ، نباید startWaypoint مشخص شود.

object ( LatLng )

موقعیت جغرافیایی که پس از اتمام آخرین VisitRequest خود ، وسیله نقلیه به پایان می رسد. اگر مشخص نشده باشد ShipmentRoute وسیله نقلیه بلافاصله با پایان یافتن آخرین VisitRequest خود به پایان می رسد. اگر مدل حمل و نقل دارای مدت زمان و ماتریس فاصله باشد ، باید endLocation مشخص شود.

object ( Waypoint )

Waypoint نمایانگر یک مکان جغرافیایی است که وسیله نقلیه پس از اتمام آخرین VisitRequest خود به پایان می رسد. اگر نه endWaypoint و نه endLocation مشخص نشده باشد ، ShipmentRoute وسیله نقلیه بلافاصله با پایان یافتن آخرین VisitRequest خود به پایان می رسد. اگر مدل حمل و نقل دارای ماتریس مدت و فاصله باشد ، نباید endWaypoint مشخص شود.

string

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

رشته های خالی یا کپی مجاز نیستند.

string

برچسب های متصل به انتهای مسیر وسیله نقلیه را مشخص می کند.

رشته های خالی یا کپی مجاز نیستند.

object ( TimeWindow )

ویندوزهای زمانی که در طی آن وسیله نقلیه ممکن است محل شروع خود را ترک کند. آنها باید در محدوده زمان جهانی باشند (به زمینه های ShipmentModel.global_* مراجعه کنید). اگر نامشخص باشد ، علاوه بر محدودیت های زمان جهانی ، هیچ محدودیتی وجود ندارد.

ویندوزهای زمانی متعلق به همان زمینه مکرر باید از هم جدا شوند ، یعنی هیچ پنجره زمانی نمی تواند با دیگری همپوشانی داشته باشد یا در مجاورت دیگری باشد و باید به ترتیب زمانی باشد.

در صورت وجود یک پنجره زمانی واحد costPerHourAfterSoftEndTime و softEndTime فقط قابل تنظیم است.

object ( TimeWindow )

ویندوزهای زمانی که در طی آن وسیله نقلیه ممکن است به محل انتها برسد. آنها باید در محدوده زمان جهانی باشند (به زمینه های ShipmentModel.global_* مراجعه کنید). اگر نامشخص باشد ، علاوه بر محدودیت های زمان جهانی ، هیچ محدودیتی وجود ندارد.

ویندوزهای زمانی متعلق به همان زمینه مکرر باید از هم جدا شوند ، یعنی هیچ پنجره زمانی نمی تواند با دیگری همپوشانی داشته باشد یا در مجاورت دیگری باشد و باید به ترتیب زمانی باشد.

در صورت وجود یک پنجره زمانی واحد costPerHourAfterSoftEndTime و softEndTime فقط قابل تنظیم است.

enum ( UnloadingPolicy )

خط مشی تخلیه شده روی وسیله نقلیه.

map (key: string, value: object ( LoadLimit ))

ظرفیت وسیله نقلیه (وزن ، حجم ، # پالت به عنوان مثال). کلیدهای موجود در نقشه شناسه های نوع بار هستند ، مطابق با کلیدهای قسمت Shipment.load_demands . bload_demands. اگر یک کلید معین از این نقشه غایب باشد ، ظرفیت مربوطه بی حد و حصر در نظر گرفته می شود.

یک شیء حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

number

هزینه های وسیله نقلیه: تمام هزینه ها اضافه می شوند و باید در واحد Shipment.penalty_cost قرار داشته باشند. PENATTY_COST.

هزینه در هر ساعت مسیر وسیله نقلیه. این هزینه برای کل زمان که در طول مسیر گرفته شده اعمال می شود و شامل زمان سفر ، زمان انتظار و زمان بازدید است. استفاده از costPerHour به جای فقط costPerTraveledHour ممکن است منجر به تأخیر اضافی شود.

number

هزینه هر ساعت سفر از مسیر وسیله نقلیه. این هزینه فقط برای زمان سفر گرفته شده توسط مسیر (یعنی گزارش شده در حمل و نقل در ShipmentRoute.transitions ) اعمال می شود ، و زمان انتظار و زمان بازدید را حذف نمی کند.

number

هزینه هر کیلومتر مسیر وسیله نقلیه. این هزینه برای مسافت گزارش شده در حمل arrivalLocation نقل departureLocation ShipmentRoute.transitions VisitRequest می شود.

number

در صورت استفاده از این وسیله نقلیه برای رسیدگی به محموله ، هزینه ثابت اعمال می شود.

boolean

این زمینه فقط در مورد وسایل نقلیه اعمال می شود که مسیر آنها در خدمت هیچ محموله ای نباشد. این نشان می دهد که آیا وسیله نقلیه باید در این مورد استفاده شود یا خیر.

اگر درست باشد ، وسیله نقلیه از شروع خود به محل پایان خود می رود حتی اگر در خدمت هیچ محموله ای نباشد ، و هزینه های زمان و مسافت ناشی از شروع آن -> سفر پایان در نظر گرفته می شود.

در غیر این صورت ، از شروع آن به محل پایان خود سفر نمی کند ، و هیچگونه breakRule یا تأخیر (از TransitionAttributes ) برای این وسیله نقلیه برنامه ریزی نشده است. در این حالت ، ShipmentRoute وسیله نقلیه هیچ اطلاعاتی به جز شاخص و برچسب وسیله نقلیه ندارد.

object ( DurationLimit )

حد اعمال شده در کل مدت زمان مسیر وسیله نقلیه. در یک OptimizeToursResponse بهینه ، مدت زمان مسیر یک وسیله نقلیه تفاوت بین vehicleEndTime آن و vehicleStartTime است.

object ( DurationLimit )

محدودیت اعمال شده در طول سفر مسیر وسیله نقلیه. در یک OptimizeToursResponse بهینه ، مدت زمان سفر ، مجموع تمام transitions.travel_duration آن است. travel_duration.

object ( DistanceLimit )

حد اعمال شده در فاصله کل مسیر وسیله نقلیه. در یک OptimizeToursResponse بهینه ، فاصله مسیر مجموع کل transitions.travel_distance_meters آن است. travel_distance_meters.

map (key: string, value: string ( Duration format))

نقشه را از رشته های Visittypes گرفته تا مدت زمان مشخص می کند. مدت زمان علاوه بر VisitRequest.duration است. در بازدیدها با visitTypes مشخص شده انجام می شود. این مدت بازدید اضافی در صورت مشخص شدن costPerHour هزینه را اضافه می کند. کلیدها (یعنی visitTypes ) نمی توانند رشته های خالی باشند.

اگر درخواست بازدید از انواع مختلفی داشته باشد ، مدت زمان دیگری برای هر نوع نقشه اضافه می شود.

یک شیء حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( BreakRule )

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

string

برچسب این وسیله نقلیه را مشخص می کند. این برچسب در پاسخ به عنوان vehicleLabel ShipmentRoute مربوطه گزارش شده است.

boolean

اگر درست باشد ، usedIfRouteIsEmpty باید نادرست باشد و این وسیله نقلیه بلااستفاده باقی می ماند.

اگر حمل و نقل توسط یک وسیله نقلیه نادیده گرفته شده در injectedFirstSolutionRoutes انجام شود ، در راه حل اول پرش می شود اما در پاسخ رایگان است.

اگر یک حمل و نقل توسط یک وسیله نقلیه نادیده گرفته شده در injectedSolutionConstraint انجام شود و هرگونه وانت/تحویل مربوط به آن محدود شود که روی وسیله نقلیه باقی بماند (به عنوان مثال ، آرامش برای سطح RELAX_ALL_AFTER_THRESHOLD ) ، در پاسخ رد می شود. اگر یک محموله دارای یک قسمت غیر خالی allowedVehicleIndices باشد و تمام وسایل نقلیه مجاز نادیده گرفته شود ، در پاسخ رد می شود.

number

یک عامل چند برابر را مشخص می کند که می تواند برای افزایش یا کاهش زمان سفر این وسیله نقلیه استفاده شود. For example, setting this to 2.0 means that this vehicle is slower and has travel times that are twice what they are for standard vehicles. This multiple does not affect visit durations. It does affect cost if costPerHour or costPerTraveledHour are specified. This must be in the range [0.001, 1000.0]. If unset, the vehicle is standard, and this multiple is considered 1.0.

WARNING: Travel times will be rounded to the nearest second after this multiple is applied but before performing any numerical operations, thus, a small multiple may result in a loss of precision.

See also extraVisitDurationForVisitType below.

boolean

Specifies whether to avoid toll roads where reasonable. Preference will be given to routes not containing toll roads. Applies only to motorized travel modes.

boolean

Specifies whether to avoid highways where reasonable. Preference will be given to routes not containing highways. Applies only to motorized travel modes.

boolean

Specifies whether to avoid ferries where reasonable. Preference will be given to routes not containing travel by ferries. Applies only to motorized travel modes.

boolean

اختیاری. Specifies whether to avoid navigating indoors where reasonable. Preference will be given to routes not containing indoor navigation. Applies only to the WALKING travel mode.

string ( int64 format)

A soft limit of the load. See costPerUnitAboveSoftMax .

number

If the load ever exceeds softMaxLoad along this vehicle's route, the following cost penalty applies (only once per vehicle): (load - softMaxLoad ) * costPerUnitAboveSoftMax . All costs add up and must be in the same unit as Shipment.penalty_cost .

object ( Interval )

The acceptable load interval of the vehicle at the start of the route.

object ( Interval )

The acceptable load interval of the vehicle at the end of the route.

string ( int64 format)

The maximum acceptable amount of load.

string ( int64 format)

A minimum acceptable load. Must be ≥ 0. If they're both specified, min must be ≤ max .

string ( int64 format)

A maximum acceptable load. Must be ≥ 0. If unspecified, the maximum load is unrestricted by this message. If they're both specified, min must be ≤ max .

string ( Duration format)

A hard limit constraining the duration to be at most maxDuration.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

A soft limit not enforcing a maximum duration limit, but when violated makes the route incur a cost. This cost adds up to other costs defined in the model, with the same unit.

If defined, softMaxDuration must be nonnegative. If maxDuration is also defined, softMaxDuration must be less than maxDuration.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

A soft limit not enforcing a maximum duration limit, but when violated makes the route incur a cost, quadratic in the duration. This cost adds up to other costs defined in the model, with the same unit.

If defined, quadraticSoftMaxDuration must be nonnegative. If maxDuration is also defined, quadraticSoftMaxDuration must be less than maxDuration , and the difference must be no larger than one day:

maxDuration - quadraticSoftMaxDuration <= 86400 seconds

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

number

Cost per hour incurred if the softMaxDuration threshold is violated. The additional cost is 0 if the duration is under the threshold, otherwise the cost depends on the duration as follows:

  costPerHourAfterSoftMax * (duration - softMaxDuration)

The cost must be nonnegative.

number

Cost per square hour incurred if the quadraticSoftMaxDuration threshold is violated.

The additional cost is 0 if the duration is under the threshold, otherwise the cost depends on the duration as follows:

  costPerSquareHourAfterQuadraticSoftMax *
  (duration - quadraticSoftMaxDuration)^2

The cost must be nonnegative.

string ( int64 format)

A hard limit constraining the distance to be at most maxMeters. The limit must be nonnegative.

string ( int64 format)

A soft limit not enforcing a maximum distance limit, but when violated results in a cost which adds up to other costs defined in the model, with the same unit.

If defined softMaxMeters must be less than maxMeters and must be nonnegative.

number

Cost per kilometer incurred, increasing up to softMaxMeters , with formula:

  min(distanceMeters, softMaxMeters) / 1000.0 *
  costPerKilometerBelowSoftMax.

This cost is not supported in routeDistanceLimit .

number

Cost per kilometer incurred if distance is above softMaxMeters limit. The additional cost is 0 if the distance is under the limit, otherwise the formula used to compute the cost is the following:

  (distanceMeters - softMaxMeters) / 1000.0 *
  costPerKilometerAboveSoftMax.

The cost must be nonnegative.

object ( BreakRequest )

Sequence of breaks. See the BreakRequest message.

object ( FrequencyConstraint )

Several FrequencyConstraint may apply. They must all be satisfied by the BreakRequest s of this BreakRule . See FrequencyConstraint .

string ( Timestamp format)

مورد نیاز. Lower bound (inclusive) on the start of the break.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

مورد نیاز. Upper bound (inclusive) on the start of the break.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z" .

string ( Duration format)

مورد نیاز. Minimum duration of the break. Must be positive.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

مورد نیاز. Minimum break duration for this constraint. Nonnegative. See description of FrequencyConstraint .

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

مورد نیاز. Maximum allowed span of any interval of time in the route that does not include at least partially a break of duration >= minBreakDuration . Must be positive.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

object ( Row )

Specifies the rows of the duration and distance matrix. It must have as many elements as ShipmentModel.duration_distance_matrix_src_tags .

string

Tag defining to which vehicles this duration and distance matrix applies. If empty, this applies to all vehicles, and there can only be a single matrix.

Each vehicle start must match exactly one matrix, ie exactly one of their startTags field must match the vehicleStartTag of a matrix (and of that matrix only).

All matrices must have a different vehicleStartTag .

string ( Duration format)

Duration values for a given row. It must have as many elements as ShipmentModel.duration_distance_matrix_dst_tags .

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

number

Distance values for a given row. If no costs or constraints refer to distances in the model, this can be left empty; otherwise it must have as many elements as durations .

string

Tags defining the set of (src->dst) transitions these attributes apply to.

A source visit or vehicle start matches iff its VisitRequest.tags or Vehicle.start_tags either contains srcTag or does not contain excludedSrcTag (depending on which of these two fields is non-empty).

string

See srcTag . Exactly one of srcTag and excludedSrcTag must be non-empty.

string

A destination visit or vehicle end matches iff its VisitRequest.tags or Vehicle.end_tags either contains dstTag or does not contain excludedDstTag (depending on which of these two fields is non-empty).

string

See dstTag . Exactly one of dstTag and excludedDstTag must be non-empty.

number

Specifies a cost for performing this transition. This is in the same unit as all other costs in the model and must not be negative. It is applied on top of all other existing costs.

number

Specifies a cost per kilometer applied to the distance traveled while performing this transition. It adds up to any Vehicle.cost_per_kilometer specified on vehicles.

object ( DistanceLimit )

Specifies a limit on the distance traveled while performing this transition.

As of 2021/06, only soft limits are supported.

string ( Duration format)

Specifies a delay incurred when performing this transition.

This delay always occurs after finishing the source visit and before starting the destination visit.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string

List of incompatible types. Two shipments having different shipment_types among those listed are "incompatible".

enum ( IncompatibilityMode )

Mode applied to the incompatibility.

string

List of alternative shipment types required by the dependentShipmentTypes .

string

All shipments with a type in the dependentShipmentTypes field require at least one shipment of type requiredShipmentTypeAlternatives to be visited on the same route.

NOTE: Chains of requirements such that a shipmentType depends on itself are not allowed.

enum ( RequirementMode )

Mode applied to the requirement.

boolean

Indicates if the "first" event is a delivery.

boolean

Indicates if the "second" event is a delivery.

string ( Duration format)

The offset between the "first" and "second" event. می تواند منفی باشد.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

integer

Shipment index of the "first" event. This field must be specified.

integer

Shipment index of the "second" event. This field must be specified.

string

The user-defined display name of the shipment. It can be up to 63 characters long and may use UTF-8 characters.

object ( VisitRequest )

Set of pickup alternatives associated to the shipment. If not specified, the vehicle only needs to visit a location corresponding to the deliveries.

object ( VisitRequest )

Set of delivery alternatives associated to the shipment. If not specified, the vehicle only needs to visit a location corresponding to the pickups.

map (key: string, value: object ( Load ))

Load demands of the shipment (for example weight, volume, number of pallets etc). The keys in the map should be identifiers describing the type of the corresponding load, ideally also including the units. For example: "weight_kg", "volume_gallons", "pallet_count", etc. If a given key does not appear in the map, the corresponding load is considered as null.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

integer

The set of vehicles that may perform this shipment. If empty, all vehicles may perform it. Vehicles are given by their index in the ShipmentModel 's vehicles list.

number

Specifies the cost that is incurred when this shipment is delivered by each vehicle. If specified, it must have EITHER:

• the same number of elements as costsPerVehicleIndices . costsPerVehicle[i] corresponds to vehicle costsPerVehicleIndices[i] of the model.
• the same number of elements as there are vehicles in the model. The i-th element corresponds to vehicle #i of the model.

These costs must be in the same unit as penaltyCost and must not be negative. Leave this field empty, if there are no such costs.

integer

Indices of the vehicles to which costsPerVehicle applies. If non-empty, it must have the same number of elements as costsPerVehicle . A vehicle index may not be specified more than once. If a vehicle is excluded from costsPerVehicleIndices , its cost is zero.

string ( Duration format)

Specifies the maximum absolute detour time compared to the shortest path from pickup to delivery. If specified, it must be nonnegative, and the shipment must contain at least a pickup and a delivery.

For example, let t be the shortest time taken to go from the selected pickup alternative directly to the selected delivery alternative. Then setting pickupToDeliveryAbsoluteDetourLimit enforces:

startTime(delivery) - startTime(pickup) <=
t + pickupToDeliveryAbsoluteDetourLimit

If both relative and absolute limits are specified on the same shipment, the more constraining limit is used for each possible pickup/delivery pair. As of 2017/10, detours are only supported when travel durations do not depend on vehicles.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string ( Duration format)

Specifies the maximum duration from start of pickup to start of delivery of a shipment. If specified, it must be nonnegative, and the shipment must contain at least a pickup and a delivery. This does not depend on which alternatives are selected for pickup and delivery, nor on vehicle speed. This can be specified alongside maximum detour constraints: the solution will respect both specifications.

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

string

Non-empty string specifying a "type" for this shipment. This feature can be used to define incompatibilities or requirements between shipment_types (see shipmentTypeIncompatibilities and shipmentTypeRequirements in ShipmentModel ).

Differs from visitTypes which is specified for a single visit: All pickup/deliveries belonging to the same shipment share the same shipmentType .

string

Specifies a label for this shipment. This label is reported in the response in the shipmentLabel of the corresponding ShipmentRoute.Visit .

boolean

If true, skip this shipment, but don't apply a penaltyCost .

Ignoring a shipment results in a validation error when there are any shipmentTypeRequirements in the model.

Ignoring a shipment that is performed in injectedFirstSolutionRoutes or injectedSolutionConstraint is permitted; the solver removes the related pickup/delivery visits from the performing route. precedenceRules that reference ignored shipments will also be ignored.

number

If the shipment is not completed, this penalty is added to the overall cost of the routes. A shipment is considered completed if one of its pickup and delivery alternatives is visited. The cost may be expressed in the same unit used for all other cost-related fields in the model and must be positive.

IMPORTANT : If this penalty is not specified, it is considered infinite, ie the shipment must be completed.

number

Specifies the maximum relative detour time compared to the shortest path from pickup to delivery. If specified, it must be nonnegative, and the shipment must contain at least a pickup and a delivery.

For example, let t be the shortest time taken to go from the selected pickup alternative directly to the selected delivery alternative. Then setting pickupToDeliveryRelativeDetourLimit enforces:

startTime(delivery) - startTime(pickup) <=
std::ceil(t * (1.0 + pickupToDeliveryRelativeDetourLimit))

If both relative and absolute limits are specified on the same shipment, the more constraining limit is used for each possible pickup/delivery pair. As of 2017/10, detours are only supported when travel durations do not depend on vehicles.

object ( LatLng )

The geo-location where the vehicle arrives when performing this VisitRequest . If the shipment model has duration distance matrices, arrivalLocation must not be specified.

object ( Waypoint )

The waypoint where the vehicle arrives when performing this VisitRequest . If the shipment model has duration distance matrices, arrivalWaypoint must not be specified.

object ( LatLng )

The geo-location where the vehicle departs after completing this VisitRequest . Can be omitted if it is the same as arrivalLocation . If the shipment model has duration distance matrices, departureLocation must not be specified.

object ( Waypoint )

The waypoint where the vehicle departs after completing this VisitRequest . Can be omitted if it is the same as arrivalWaypoint . If the shipment model has duration distance matrices, departureWaypoint must not be specified.

string

Specifies tags attached to the visit request. Empty or duplicate strings are not allowed.

object ( TimeWindow )

Time windows which constrain the arrival time at a visit. Note that a vehicle may depart outside of the arrival time window, ie arrival time + duration do not need to be inside a time window. This can result in waiting time if the vehicle arrives before TimeWindow.start_time .

The absence of TimeWindow means that the vehicle can perform this visit at any time.

Time windows must be disjoint, ie no time window must overlap with or be adjacent to another, and they must be in increasing order.

costPerHourAfterSoftEndTime and softEndTime can only be set if there is a single time window.

string ( Duration format)

Duration of the visit, ie time spent by the vehicle between arrival and departure (to be added to the possible waiting time; see timeWindows ).

A duration in seconds with up to nine fractional digits, ending with ' s '. Example: "3.5s" .

number

Cost to service this visit request on a vehicle route. This can be used to pay different costs for each alternative pickup or delivery of a shipment. This cost must be in the same unit as Shipment.penalty_cost and must not be negative.

map (key: string, value: object ( Load ))

Load demands of this visit request. This is just like Shipment.load_demands field, except that it only applies to this VisitRequest instead of the whole Shipment . The demands listed here are added to the demands listed in Shipment.load_demands .

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

string

Specifies the types of the visit. This may be used to allocate additional time required for a vehicle to complete this visit (see Vehicle.extra_visit_duration_for_visit_type ).

A type can only appear once.

string

Specifies a label for this VisitRequest . This label is reported in the response as visitLabel in the corresponding ShipmentRoute.Visit .

number

The latitude in degrees. It must be in the range [-90.0, +90.0].

number

The longitude in degrees. It must be in the range [-180.0, +180.0].

boolean

اختیاری. Indicates that the location of this waypoint is meant to have a preference for the vehicle to stop at a particular side of road. When you set this value, the route will pass through the location so that the vehicle can stop at the side of road that the location is biased towards from the center of the road. This option doesn't work for the 'WALKING' travel mode.

object ( Location )

A point specified using geographic coordinates, including an optional heading.

string

The POI Place ID associated with the waypoint.

object ( LatLng )

The waypoint's geographic coordinates.

integer

The compass heading associated with the direction of the flow of traffic. This value is used to specify the side of the road to use for pickup and drop-off. Heading values can be from 0 to 360, where 0 specifies a heading of due North, 90 specifies a heading of due East, etc.

string ( Timestamp format)

The hard time window start time. If unspecified it will be set to ShipmentModel.global_start_time .

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

The hard time window end time. If unspecified it will be set to ShipmentModel.global_end_time .

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

The soft start time of the time window.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

The soft end time of the time window.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z" .

number

A cost per hour added to other costs in the model if the event occurs before softStartTime, computed as:

   max(0, softStartTime - t.seconds)
                          * costPerHourBeforeSoftStartTime / 3600,
t being the time of the event.

This cost must be positive, and the field can only be set if softStartTime has been set.

number

A cost per hour added to other costs in the model if the event occurs after softEndTime , computed as:

   max(0, t.seconds - softEndTime.seconds)
                    * costPerHourAfterSoftEndTime / 3600,
t being the time of the event.

This cost must be positive, and the field can only be set if softEndTime has been set.

string

The user-defined display name of the vehicle. It can be up to 63 characters long and may use UTF-8 characters.

enum ( TravelMode )

The travel mode which affects the roads usable by the vehicle and its speed. See also travelDurationMultiple .

object ( RouteModifiers )

A set of conditions to satisfy that affect the way routes are calculated for the given vehicle.

object ( LatLng )

Geographic location where the vehicle starts before picking up any shipments. If not specified, the vehicle starts at its first pickup. If the shipment model has duration and distance matrices, startLocation must not be specified.

object ( Waypoint )

Waypoint representing a geographic location where the vehicle starts before picking up any shipments. If neither startWaypoint nor startLocation is specified, the vehicle starts at its first pickup. If the shipment model has duration and distance matrices, startWaypoint must not be specified.

object ( LatLng )

Geographic location where the vehicle ends after it has completed its last VisitRequest . If not specified the vehicle's ShipmentRoute ends immediately when it completes its last VisitRequest . If the shipment model has duration and distance matrices, endLocation must not be specified.

object ( Waypoint )

Waypoint representing a geographic location where the vehicle ends after it has completed its last VisitRequest . If neither endWaypoint nor endLocation is specified, the vehicle's ShipmentRoute ends immediately when it completes its last VisitRequest . If the shipment model has duration and distance matrices, endWaypoint must not be specified.

string

Specifies tags attached to the start of the vehicle's route.

Empty or duplicate strings are not allowed.

string

Specifies tags attached to the end of the vehicle's route.

Empty or duplicate strings are not allowed.

object ( TimeWindow )

Time windows during which the vehicle may depart its start location. They must be within the global time limits (see ShipmentModel.global_* fields). If unspecified, there is no limitation besides those global time limits.

Time windows belonging to the same repeated field must be disjoint, ie no time window can overlap with or be adjacent to another, and they must be in chronological order.

costPerHourAfterSoftEndTime and softEndTime can only be set if there is a single time window.

object ( TimeWindow )

Time windows during which the vehicle may arrive at its end location. They must be within the global time limits (see ShipmentModel.global_* fields). If unspecified, there is no limitation besides those global time limits.

Time windows belonging to the same repeated field must be disjoint, ie no time window can overlap with or be adjacent to another, and they must be in chronological order.

costPerHourAfterSoftEndTime and softEndTime can only be set if there is a single time window.

enum ( UnloadingPolicy )

Unloading policy enforced on the vehicle.

map (key: string, value: object ( LoadLimit ))

Capacities of the vehicle (weight, volume, # of pallets for example). The keys in the map are the identifiers of the type of load, consistent with the keys of the Shipment.load_demands field. If a given key is absent from this map, the corresponding capacity is considered to be limitless.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

number

Vehicle costs: all costs add up and must be in the same unit as Shipment.penalty_cost .

Cost per hour of the vehicle route. This cost is applied to the total time taken by the route, and includes travel time, waiting time, and visit time. Using costPerHour instead of just costPerTraveledHour may result in additional latency.

number

Cost per traveled hour of the vehicle route. This cost is applied only to travel time taken by the route (ie, that reported in ShipmentRoute.transitions ), and excludes waiting time and visit time.

number

Cost per kilometer of the vehicle route. This cost is applied to the distance reported in the ShipmentRoute.transitions and does not apply to any distance implicitly traveled from the arrivalLocation to the departureLocation of a single VisitRequest .

number

Fixed cost applied if this vehicle is used to handle a shipment.

boolean

This field only applies to vehicles when their route does not serve any shipments. It indicates if the vehicle should be considered as used or not in this case.

If true, the vehicle goes from its start to its end location even if it doesn't serve any shipments, and time and distance costs resulting from its start --> end travel are taken into account.

Otherwise, it doesn't travel from its start to its end location, and no breakRule or delay (from TransitionAttributes ) are scheduled for this vehicle. In this case, the vehicle's ShipmentRoute doesn't contain any information except for the vehicle index and label.

object ( DurationLimit )

Limit applied to the total duration of the vehicle's route. In a given OptimizeToursResponse , the route duration of a vehicle is the difference between its vehicleEndTime and vehicleStartTime .

object ( DurationLimit )

Limit applied to the travel duration of the vehicle's route. In a given OptimizeToursResponse , the route travel duration is the sum of all its transitions.travel_duration .

object ( DistanceLimit )

Limit applied to the total distance of the vehicle's route. In a given OptimizeToursResponse , the route distance is the sum of all its transitions.travel_distance_meters .

map (key: string, value: string ( Duration format))

Specifies a map from visitTypes strings to durations. The duration is time in addition to VisitRequest.duration to be taken at visits with the specified visitTypes . This extra visit duration adds cost if costPerHour is specified. Keys (ie visitTypes ) cannot be empty strings.

If a visit request has multiple types, a duration will be added for each type in the map.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( BreakRule )

Describes the break schedule to be enforced on this vehicle. If empty, no breaks will be scheduled for this vehicle.

string

Specifies a label for this vehicle. This label is reported in the response as the vehicleLabel of the corresponding ShipmentRoute .

boolean

If true, usedIfRouteIsEmpty must be false, and this vehicle will remain unused.

If a shipment is performed by an ignored vehicle in injectedFirstSolutionRoutes , it is skipped in the first solution but is free to be performed in the response.

If a shipment is performed by an ignored vehicle in injectedSolutionConstraint and any related pickup/delivery is constrained to remain on the vehicle (ie, not relaxed to level RELAX_ALL_AFTER_THRESHOLD ), it is skipped in the response. If a shipment has a non-empty allowedVehicleIndices field and all of the allowed vehicles are ignored, it is skipped in the response.

number

Specifies a multiplicative factor that can be used to increase or decrease travel times of this vehicle. For example, setting this to 2.0 means that this vehicle is slower and has travel times that are twice what they are for standard vehicles. This multiple does not affect visit durations. It does affect cost if costPerHour or costPerTraveledHour are specified. This must be in the range [0.001, 1000.0]. If unset, the vehicle is standard, and this multiple is considered 1.0.

WARNING: Travel times will be rounded to the nearest second after this multiple is applied but before performing any numerical operations, thus, a small multiple may result in a loss of precision.

See also extraVisitDurationForVisitType below.

boolean

Specifies whether to avoid toll roads where reasonable. Preference will be given to routes not containing toll roads. Applies only to motorized travel modes.

boolean

Specifies whether to avoid highways where reasonable. Preference will be given to routes not containing highways. Applies only to motorized travel modes.

boolean

Specifies whether to avoid ferries where reasonable. Preference will be given to routes not containing travel by ferries. Applies only to motorized travel modes.

boolean

اختیاری. Specifies whether to avoid navigating indoors where reasonable. Preference will be given to routes not containing indoor navigation. Applies only to the WALKING travel mode.

string ( int64 format)

A soft limit of the load. See costPerUnitAboveSoftMax .

number

If the load ever exceeds softMaxLoad along this vehicle's route, the following cost penalty applies (only once per vehicle): (load - softMaxLoad ) * costPerUnitAboveSoftMax . All costs add up and must be in the same unit as Shipment.penalty_cost .