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

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 से, शिपमेंट छोड़ने पर होने वाले खर्च के बारे में पता चलता है.
  • Shipment.VisitRequest.cost, किसी खास पिकअप या डिलीवरी की कीमत दिखाता है. इसका इस्तेमाल मुख्य रूप से, एक शिपमेंट के लिए पिकअप या डिलीवरी के कई विकल्पों के बीच लागत के बदलाव को चालू करने के लिए किया जाता है.

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

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

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

Route Optimization के जवाब में मिलने वाली लागत की प्रॉपर्टी

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] की पेनल्टी की कीमत 5 यूनिट है, जो उदाहरण के जवाब में मौजूद कुल model.shipments.penalty_cost बटन से मेल खाती है. Vehicle के 40.0 costPerHour और 10.0 costPerKilometer की तुलना में, शिपिंग की कम penaltyCost की वजह से, शिपिंग को पूरा करने के बजाय छोड़ना ज़्यादा किफ़ायती है.

बेहतर विषय: लागत और सॉफ्ट कंस्ट्रेंट

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 पाबंदियों के बारे में पूरी जानकारी दी गई है.