ShipmentModel

{
  "displayName": string,
  "pickups": [
    {
      object (VisitRequest)
    }
  ],
  "deliveries": [
    {
      object (VisitRequest)
    }
  ],
  "loadDemands": {
    string: {
      object (Load)
    },
    ...
  },
  "allowedVehicleIndices": [
    integer
  ],
  "costsPerVehicle": [
    number
  ],
  "costsPerVehicleIndices": [
    integer
  ],
  "pickupToDeliveryAbsoluteDetourLimit": string,
  "pickupToDeliveryTimeLimit": string,
  "shipmentType": string,
  "label": string,
  "ignore": boolean,
  "penaltyCost": number,
  "pickupToDeliveryRelativeDetourLimit": number
}

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))

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

{
  "arrivalLocation": {
    object (LatLng)
  },
  "arrivalWaypoint": {
    object (Waypoint)
  },
  "departureLocation": {
    object (LatLng)
  },
  "departureWaypoint": {
    object (Waypoint)
  },
  "tags": [
    string
  ],
  "timeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "duration": string,
  "cost": number,
  "loadDemands": {
    string: {
      object (Load)
    },
    ...
  },
  "visitTypes": [
    string
  ],
  "label": string
}

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 مربوطه گزارش شده است.

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "sideOfRoad": boolean,

  // Union field location_type can be only one of the following:
  "location": {
    object (Location)
  },
  "placeId": string
  // End of list of possible types for union field location_type.
}

boolean

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

object ( Location )

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

string

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

{
  "latLng": {
    object (LatLng)
  },
  "heading": integer
}

object ( LatLng )

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

integer

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

{
  "startTime": string,
  "endTime": string,
  "softStartTime": string,
  "softEndTime": string,
  "costPerHourBeforeSoftStartTime": number,
  "costPerHourAfterSoftEndTime": number
}

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 تنظیم شده باشد.

{
  "displayName": string,
  "travelMode": enum (TravelMode),
  "routeModifiers": {
    object (RouteModifiers)
  },
  "startLocation": {
    object (LatLng)
  },
  "startWaypoint": {
    object (Waypoint)
  },
  "endLocation": {
    object (LatLng)
  },
  "endWaypoint": {
    object (Waypoint)
  },
  "startTags": [
    string
  ],
  "endTags": [
    string
  ],
  "startTimeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "endTimeWindows": [
    {
      object (TimeWindow)
    }
  ],
  "unloadingPolicy": enum (UnloadingPolicy),
  "loadLimits": {
    string: {
      object (LoadLimit)
    },
    ...
  },
  "costPerHour": number,
  "costPerTraveledHour": number,
  "costPerKilometer": number,
  "fixedCost": number,
  "usedIfRouteIsEmpty": boolean,
  "routeDurationLimit": {
    object (DurationLimit)
  },
  "travelDurationLimit": {
    object (DurationLimit)
  },
  "routeDistanceLimit": {
    object (DistanceLimit)
  },
  "extraVisitDurationForVisitType": {
    string: string,
    ...
  },
  "breakRule": {
    object (BreakRule)
  },
  "label": string,
  "ignore": boolean,
  "travelDurationMultiple": number
}

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 آن است.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 در زیر ببینید.

{
  "avoidTolls": boolean,
  "avoidHighways": boolean,
  "avoidFerries": boolean,
  "avoidIndoor": boolean
}

boolean

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

boolean

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

boolean

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

boolean

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

{
  "softMaxLoad": string,
  "costPerUnitAboveSoftMax": number,
  "startLoadInterval": {
    object (Interval)
  },
  "endLoadInterval": {
    object (Interval)
  },
  "maxLoad": string
}

string ( int64 format)

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

number

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

object ( Interval )

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

object ( Interval )

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

string ( int64 format)

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

{
  "min": string,
  "max": string
}

string ( int64 format)

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

string ( int64 format)

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

{
  "maxDuration": string,
  "softMaxDuration": string,
  "quadraticSoftMaxDuration": string,
  "costPerHourAfterSoftMax": number,
  "costPerSquareHourAfterQuadraticSoftMax": number
}

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

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

{
  "maxMeters": string,
  "softMaxMeters": string,
  "costPerKilometerBelowSoftMax": number,
  "costPerKilometerAboveSoftMax": number
}

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.

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

{
  "breakRequests": [
    {
      object (BreakRequest)
    }
  ],
  "frequencyConstraints": [
    {
      object (FrequencyConstraint)
    }
  ]
}

object ( BreakRequest )

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

object ( FrequencyConstraint )

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

{
  "earliestStartTime": string,
  "latestStartTime": string,
  "minDuration": string
}

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" .

{
  "minBreakDuration": string,
  "maxInterBreakDuration": string
}

string ( Duration format)

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

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

string ( Duration format)

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

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

{
  "rows": [
    {
      object (Row)
    }
  ],
  "vehicleStartTag": string
}

object ( Row )

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

string

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

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

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

{
  "durations": [
    string
  ],
  "meters": [
    number
  ]
}

string ( Duration format)

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

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

number

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

{
  "srcTag": string,
  "excludedSrcTag": string,
  "dstTag": string,
  "excludedDstTag": string,
  "cost": number,
  "costPerKilometer": number,
  "distanceLimit": {
    object (DistanceLimit)
  },
  "delay": string
}

string

برچسب‌هایی که مجموعه انتقال‌های (src->dst) را تعریف می‌کنند، این ویژگی‌ها برای آنها اعمال می‌شوند.

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

string

srcTag ببینید. دقیقاً یکی از srcTag و excludedSrcTag باید خالی نباشد.

string

بازدید مقصد یا پایان وسیله نقلیه با VisitRequest.tags یا Vehicle.end_tags آن مطابقت دارد یا حاوی dstTag باشد یا حاوی excludedDstTag نباشد (بسته به اینکه کدام یک از این دو قسمت خالی نباشد).

string

dstTag ببینید. دقیقاً یکی از dstTag و excludedDstTag باید خالی نباشد.

number

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

number

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

object ( DistanceLimit )

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

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

string ( Duration format)

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

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

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

{
  "types": [
    string
  ],
  "incompatibilityMode": enum (IncompatibilityMode)
}

string

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

enum ( IncompatibilityMode )

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

{
  "requiredShipmentTypeAlternatives": [
    string
  ],
  "dependentShipmentTypes": [
    string
  ],
  "requirementMode": enum (RequirementMode)
}

string

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

string

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

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

enum ( RequirementMode )

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

{
  "firstIsDelivery": boolean,
  "secondIsDelivery": boolean,
  "offsetDuration": string,
  "firstIndex": integer,
  "secondIndex": integer
}

boolean

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

boolean

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

string ( Duration format)

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

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

integer

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

integer

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