लागत मॉडल के पैरामीटर

OptimizeToursRequest मैसेज (REST, gRPC) में लागतों से जुड़ी कई प्रॉपर्टी होती हैं. ये लागत पैरामीटर, अनुरोध के लागत मॉडल को दिखाते हैं. लागत मॉडल, अनुरोध के कई हाई-लेवल ऑप्टिमाइज़ेशन लक्ष्यों को कैप्चर करता है. जैसे:

• कम दूरी वाले रास्तों के बजाय, ज़्यादा तेज़ Vehicle रास्तों को प्राथमिकता देना या इसका उल्टा करना
• यह तय करना कि Shipment को डिलीवर करने की लागत, Shipment को पूरा करने की वैल्यू के बराबर है या नहीं
• समयसीमा के अंदर पिकअप और डिलीवरी करना. ऐसा सिर्फ़ तब करना, जब यह किफ़ायती हो

{
  "model": {
    "globalStartTime": "2023-01-13T16:00:00-08:00",
    "globalEndTime": "2023-01-14T16:00:00-08:00",
    "shipments": [
      {
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.789456,
              "longitude": -122.390192
            },
            "duration": "250s"
          }
        ],
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.794465,
              "longitude": -122.394839
            },
            "duration": "150s"
          }
        ],
        "penaltyCost": 100.0
      },
      {
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.789116,
              "longitude": -122.395080
            },
            "duration": "250s"
          }
        ],
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.794465,
              "longitude": -122.394839
            },
            "duration": "150s"
          }
        ],
        "penaltyCost": 5.0
      },
      {
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.795242,
              "longitude": -122.399347
            },
            "duration": "250s"
          }
        ],
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.794465,
              "longitude": -122.394839
            },
            "duration": "150s"
          }
        ],
        "penaltyCost": 50.0
      }
    ],
    "vehicles": [
      {
        "endLocation": {
          "latitude": 37.794465,
          "longitude": -122.394839
        },
        "startLocation": {
          "latitude": 37.794465,
          "longitude": -122.394839
        },
        "costPerHour": 40.0,
        "costPerKilometer": 10.0
      }
    ]
  }
}
    

Vehicle लागत की प्रॉपर्टी

Vehicle मैसेज (REST, gRPC) में लागत की कई प्रॉपर्टी होती हैं:

• Vehicle.cost_per_hour: यह किसी वाहन को एक घंटे तक चलाने का खर्च दिखाता है. इसमें ट्रांज़िट, इंतज़ार, विज़िट, और ब्रेक टाइम शामिल है..
• Vehicle.cost_per_kilometer: इससे पता चलता है कि वाहन से तय की गई दूरी के हिसाब से कितना किराया लगेगा.
• Vehicle.cost_per_traveled_hour: इससे सिर्फ़ यात्रा के दौरान वाहन चलाने की लागत के बारे में पता चलता है. इसमें इंतज़ार, विज़िट, और ब्रेक के समय को शामिल नहीं किया जाता.

लागत से जुड़े इन पैरामीटर की मदद से, ऑप्टिमाइज़र को समय और तय की गई दूरी के बीच समझौता करने की अनुमति मिलती है. बेहतर रास्ते से होने वाला खर्च, जवाब के मैसेज में metrics.costs के तौर पर दिखता है:

costPerHour बढ़ने पर, ऑप्टिमाइज़र ज़्यादा तेज़ रास्ते ढूंढने की कोशिश करता है. हालांकि, ऐसा हो सकता है कि ये रास्ते सबसे छोटे न हों. इस उदाहरण में, सबसे तेज़ रास्ता सबसे छोटा भी है. इसलिए, लागत के पैरामीटर में बदलाव करने से कोई खास फ़र्क़ नहीं पड़ता.

Shipment लागत की प्रॉपर्टी

Shipment मैसेज (REST, gRPC) में भी लागत के कई पैरामीटर होते हैं:

• Shipment.penalty_cost से, शिपमेंट को स्किप करने पर लगने वाले शुल्क के बारे में पता चलता है. शिपमेंट के लिए penalty_cost पैरामीटर सेट न करने पर, शिपमेंट ज़रूरी हो जाता है. इसका मतलब है कि शिपमेंट को सिर्फ़ तब स्किप किया जाएगा, जब तय की गई शर्तों के हिसाब से उसे पूरा नहीं किया जा सकता.
• Shipment.VisitRequest.cost से, पिकअप या डिलीवरी के लिए तय की गई कीमत के बारे में पता चलता है. इसका इस्तेमाल मुख्य रूप से, एक शिपमेंट के लिए पिकअप या डिलीवरी के कई विकल्पों के बीच कीमत के फ़र्क़ को दिखाने के लिए किया जाता है.

Shipment लागत पैरामीटर, Vehicle लागत पैरामीटर की तरह ही डाइमेंशनलेस यूनिट का इस्तेमाल करते हैं. लागत, Shipment के जुर्माने से ज़्यादा है, Shipment को किसी भी Vehicle के रास्ते में शामिल नहीं किया गया है. इसके बजाय, यह जवाब के मैसेज में skipped_shipments सूची में दिखता है.

ShipmentModel लागत की प्रॉपर्टी

ShipmentModel मैसेज (REST, gRPC) में एक ही कीमत प्रॉपर्टी, globalDurationCostPerHour शामिल है. यह लागत, सभी वाहनों को ShipmentRoute पूरा करने में लगने वाले कुल समय के आधार पर तय की जाती है. globalDurationCostPerHour को बढ़ाने से, सभी शिपमेंट को पहले पूरा करने को प्राथमिकता मिलती है.

रास्ते को ऑप्टिमाइज़ करने से जुड़ी प्रतिक्रिया की लागत की प्रॉपर्टी

OptimizeToursResponse मैसेज (REST, gRPC) में लागत की प्रॉपर्टी होती हैं. ये प्रॉपर्टी, ShipmentRoute को पूरा करने की प्रोसेस में होने वाले खर्च को दिखाती हैं. metrics.costs और metrics.totalCost प्रॉपर्टी, जवाब में सभी रास्तों के लिए लागू होने वाली लागत इकाइयों की संख्या दिखाती हैं. हर routes एंट्री में routeCosts और routeTotalCosts प्रॉपर्टी होती हैं. ये प्रॉपर्टी, उस खास रास्ते के लिए किराये की जानकारी दिखाती हैं.

{
  "routes": [
    {
      "vehicleStartTime": "2023-01-14T00:00:00Z",
      "vehicleEndTime": "2023-01-14T00:28:22Z",
      "visits": [
        {
          "isPickup": true,
          "startTime": "2023-01-14T00:00:00Z",
          "detour": "0s"
        },
        {
          "shipmentIndex": 2,
          "isPickup": true,
          "startTime": "2023-01-14T00:02:30Z",
          "detour": "150s"
        },
        {
          "startTime": "2023-01-14T00:08:55Z",
          "detour": "150s"
        },
        {
          "shipmentIndex": 2,
          "startTime": "2023-01-14T00:21:21Z",
          "detour": "572s"
        }
      ],
      "transitions": [
        {
          "travelDuration": "0s",
          "waitDuration": "0s",
          "totalDuration": "0s",
          "startTime": "2023-01-14T00:00:00Z"
        },
        {
          "travelDuration": "0s",
          "waitDuration": "0s",
          "totalDuration": "0s",
          "startTime": "2023-01-14T00:02:30Z"
        },
        {
          "travelDuration": "235s",
          "travelDistanceMeters": 795,
          "waitDuration": "0s",
          "totalDuration": "235s",
          "startTime": "2023-01-14T00:05:00Z"
        },
        {
          "travelDuration": "496s",
          "travelDistanceMeters": 1893,
          "waitDuration": "0s",
          "totalDuration": "496s",
          "startTime": "2023-01-14T00:13:05Z"
        },
        {
          "travelDuration": "171s",
          "travelDistanceMeters": 665,
          "waitDuration": "0s",
          "totalDuration": "171s",
          "startTime": "2023-01-14T00:25:31Z"
        }
      ],
      "metrics": {
        "performedShipmentCount": 2,
        "travelDuration": "902s",
        "waitDuration": "0s",
        "delayDuration": "0s",
        "breakDuration": "0s",
        "visitDuration": "800s",
        "totalDuration": "1702s",
        "travelDistanceMeters": 3353
      },
      "routeCosts": {
        "model.vehicles.cost_per_kilometer": 33.53,
        "model.vehicles.cost_per_hour": 18.911111111111111
      },
      "routeTotalCost": 52.441111111111113
    }
  ],
  "skippedShipments": [
    {
      "index": 1
    }
  ],
  "metrics": {
    "aggregatedRouteMetrics": {
      "performedShipmentCount": 2,
      "travelDuration": "902s",
      "waitDuration": "0s",
      "delayDuration": "0s",
      "breakDuration": "0s",
      "visitDuration": "800s",
      "totalDuration": "1702s",
      "travelDistanceMeters": 3353
    },
    "usedVehicleCount": 1,
    "earliestVehicleStartTime": "2023-01-14T00:00:00Z",
    "latestVehicleEndTime": "2023-01-14T00:28:22Z",
    "totalCost": 57.441111111111113,
    "costs": {
      "model.vehicles.cost_per_kilometer": 33.53,
      "model.vehicles.cost_per_hour": 18.911111111111111,
      "model.shipments.penalty_cost": 5
    }
  }
}
    

जवाब के उदाहरण में, टॉप-लेवल metrics.costs ये हैं:

{
  "metrics": {
    ...
    "costs": {
      "model.vehicles.cost_per_hour": 18.911111111111111,
      "model.vehicles.cost_per_kilometer": 33.53,
      "model.shipments.penalty_cost": 5
    }
  }
}

model.shipments.penalty_cost वैल्यू से पता चलता है कि शिपिंग की सुविधा को स्किप करने की वजह से कितना शुल्क लगा. skippedShipments प्रॉपर्टी से पता चलता है कि कौनसे शिपमेंट स्किप किए गए थे.

इस उदाहरण में, अनुरोध के उदाहरण में मौजूद सिर्फ़ model.shipments[1] को स्किप किया गया है. model.shipments[1] की पेनल्टी की लागत पांच यूनिट है, जो उदाहरण के जवाब में मौजूद कुल model.shipments.penalty_cost कुंजी से मेल खाती है. शिपमेंट का penaltyCost, Vehicle के 40.0 costPerHour और 10.0 costPerKilometer की तुलना में कम है. इसलिए, शिपमेंट को पूरा करने के बजाय उसे छोड़ना ज़्यादा किफ़ायती है.

ऐडवांस विषय: लागत और सामान्य पाबंदियां

कई OptimizeToursRequest मैसेज (REST, gRPC) प्रॉपर्टी, सॉफ़्ट कंस्ट्रेंट को दिखाती हैं. ये ऐसे कंस्ट्रेंट होते हैं जिन्हें पूरा न करने पर, लागत लगती है.

उदाहरण के लिए, वाहन LoadLimit (REST, gRPC) की पाबंदियों में softMaxLoad और costPerUnitAboveSoftMax प्रॉपर्टी होती हैं. इन दोनों की लागत, softMaxLoad से ज़्यादा लोड यूनिट के हिसाब से तय होती है. इसलिए, सीमा को सिर्फ़ तब बढ़ाया जा सकता है, जब ऐसा करना लागत के हिसाब से सही हो.

इसी तरह, TimeWindow की पाबंदियों (REST, gRPC) में soft_start_time और soft_end_time प्रॉपर्टी होती हैं. साथ ही, इनसे जुड़े cost_per_hour_before_soft_start_time और cost_per_hour_after_soft_end_time होते हैं. ये TimeWindow के हिसाब से, पाबंदी वाले इवेंट के जल्दी या देर से होने पर लागू होते हैं.

लागत मॉडल के सभी पैरामीटर की तरह, सॉफ्ट कंस्ट्रेंट की लागत को भी डाइमेंशनलेस यूनिट में दिखाया जाता है. यह यूनिट, लागत के अन्य पैरामीटर की यूनिट के जैसी ही होती है.

LoadLimit की सीमाओं के बारे में ज़्यादा जानकारी लोड की मांग और सीमाएं में दी गई है. TimeWindow से जुड़ी पाबंदियों के बारे में ज़्यादा जानकारी, पिकअप और डिलीवरी के लिए समयसीमा से जुड़ी पाबंदियां में दी गई है.