रूट ऑप्टिमाइज़ेशन एपीआई, वाहनों के लिए उनसे जुड़े अनुरोध के मुताबिक रास्तों की जानकारी दिखाता है. शिपमेंट, वाहनों के लिए असाइन किए जाते हैं या अनुरोध की प्रॉपर्टी के आधार पर इसे छोड़ा भी जा सकता है.
किसी OptimizeToursResponse
मैसेज (REST, gRPC) में दो मुख्य टॉप-लेवल प्रॉपर्टी होती हैं:
- हर वाहन के लिए,
routes[]
रास्ते हैं. इनके लिए शिपिंग की जगह तय की गई है. हरRoute
में ऐसी मेट्रिक होती हैं जिनमें उस रास्ते की प्रॉपर्टी की जानकारी होती है. metrics
सभी वाहनों और रूट प्लान में मिलने वाले पूरे रिस्पॉन्स के लिए एग्रीगेट की गई मेट्रिक हैं. टॉप-लेवल मेट्रिक में वही प्रॉपर्टी होती हैं जो हर रूट की मेट्रिक में होती हैं. साथ ही, सभी रूट की वैल्यू एग्रीगेट की जाती हैं.
ऑप्टिमाइज़ेशन के नतीजों के आधार पर, हो सकता है कि कुछ प्रॉपर्टी हमेशा अपने-आप न भरे जाएं:
skippedShipments[]
ऐसे शिपमेंट की सूची बनाता है जिन्हें किसी भी वाहन का इस्तेमाल करके नहीं किया जाता. अगर किसी शिपमेंट को तय की गई सीमाओं में पूरा नहीं किया जा सकता या शिपमेंट का शुल्क, पेनल्टी की लागत से ज़्यादा होता है, तो उसे स्किप किया जा सकता है. उदाहरण के लिए, अगर किसी शिपमेंट के पिक अप या डिलीवरी की कीमत काफ़ी कम हैtimeWindow
तो हो सकता है कि यह मुमकिन न हो या किसी वाहन के लिए, ज़रूरी समय अवधि के दौरान यात्रा करना कम कीमत में हो.validationErrors[]
से पता चलता है कि जब अनुरोध केsolvingMode
कोVALIDATE_ONLY
पर सेट किया गया है, तो अनुरोध अमान्य हो जाता है या उसे हल नहीं किया जा सकता. सामान्यDEFAULT_SOLVE
मोड में, पुष्टि से जुड़ी गड़बड़ियां जवाब के मुख्य हिस्से के बजाय गड़बड़ी के मैसेज में दिखेंगी. ध्यान दें किVALIDATE_ONLY
समाधान मोड, एक साथ कई गड़बड़ियों की रिपोर्ट कर सकता है. इससे अनुरोधों को तेज़ी से डीबग करने में मदद मिलती है.
रास्ते की जानकारी
हर routes[]
एंट्री एक ShipmentRoute
मैसेज (REST, gRPC) होती है. हर
ShipmentRoute
, अनुरोध के हिसाब से किसी वाहन के लिए तय किया गया रास्ता दिखाता है. इससे जुड़ी Vehicle
से जुड़ी अहम ShipmentRoute
प्रॉपर्टी में ये शामिल हैं:
vehicleIndex
,Vehicle
का शून्य-आधारित इंडेक्स है. यह इससे जुड़े अनुरोध वाले मैसेज में मौजूद होता है. REST के रिस्पॉन्स में, वैल्यू शून्य होने पर इस प्रॉपर्टी को हटा दिया जाता है.vehicleStartTime
वह समय है जब वाहन को अपना रास्ता शुरू करना होगा.vehicleEndTime
वह समय है जब वाहन का रूट पूरा हो जाना चाहिए.
जवाब में routes
ऐसा दिखेगा:
{
"routes": [
{
"vehicleStartTime": "2024-02-13T00:00:00Z",
"vehicleEndTime": "2024-02-13T00:38:42Z",
"visits": [
...
],
"transitions": [
...
],
"metrics": {
...
},
...
}
],
...
}
हर ShipmentRoute
में visits
की क्रम वाली सूची शामिल होती है, जिसे वाहन पूरा करेगा. हर Visit
(REST, gRPC), उससे जुड़े अनुरोध के VisitRequest
(REST, gRPC) की जानकारी देता है. अहम Visit
प्रॉपर्टी में ये शामिल हैं:
shipmentIndex
, संबंधित अनुरोध में इस विज़िट से संबंधित शिपमेंट का शून्य-आधारित इंडेक्स है.isPickup
सही है, जब किसी विज़िट को पिक अप कहा जाता है. वहीं, जब कोई विज़िट, डिलीवरी होती है, तो वैल्यू गलत होती है. वैल्यू की गलत वैल्यू होने पर, REST के रिस्पॉन्स में इस प्रॉपर्टी को छोड़ दिया जाता है.visitRequestIndex
,Visit
से जुड़े अनुरोध मेंShipment.pickups
याShipment.deliveries
केVisitRequest
का शून्य-आधारित इंडेक्स है. वैल्यू शून्य होने पर, REST रिस्पॉन्स में इस प्रॉपर्टी को छोड़ दिया जाता है.startTime
वह समय है जब विज़िट शुरू होने की उम्मीद है.Visit
को पूरा करने के लिए मांगी गई रकम लोड करने के लिए,loadDemands
मैप लोड टाइप डिलीवरी की कुल रकम, डिलीवरी की संख्या से कम होती है. इससे पता चलता है कि वाहन से लोड होने वाला लोड हटा दिया गया है.
Visit
का एक उदाहरण ऐसा दिखता है:
{
"routes": [
{
...
"visits": [
{
"isPickup": true,
"startTime": "2024-02-13T00:00:00Z",
"detour": "0s"
},
...
],
},
...
],
...
}
हर ShipmentRoute
में, transitions
की क्रम वाली सूची होती है. यह किसी वाहन से visits
के बीच की यात्रा के बारे में जानकारी देती है. अहम Transition
मैसेज
(REST, gRPC) प्रॉपर्टी में ये शामिल हैं:
startTime
वह समय है जब वाहन ट्रांज़िशन शुरू करेगा.travelDuration
वह अवधि है जिसमें ट्रांज़िशन पूरा करने के लिए वाहन को तय करना होगा.- ट्रांज़िशन पूरा करने के लिए, वाहन को जो दूरी तय करनी है, वह
travelDistanceMeters
मीटर में है. trafficInfoUnavailable
से पता चलता है कि ट्रांज़िशन के लिए ट्रैफ़िक डेटा उपलब्ध है या नहीं.waitDuration
से पता चलता है कि कोई गतिविधि न होने पर, वाहन अगलीVisit
को चालू करने से पहले कितनी देर इंतज़ार करता है. ऐसा नीचे दिए गएVisit
केstart_time
की वजह से हो सकता है.- ट्रांज़िशन का कुल समय
totalDuration
है. इसमें यात्रा, इंतज़ार, ब्रेक, और देरी का समय शामिल है. - इस ट्रांज़िशन के दौरान, वाहन में होने वाली जानकारी लोड करने के लिए,
vehicleLoads
मैप लोड टाइप.
Transition
का एक उदाहरण ऐसा दिखता है:
{
"routes": [
{
...
"transitions": [
...
{
"travelDuration": "1171s",
"travelDistanceMeters": 9004,
"waitDuration": "0s",
"totalDuration": "1171s",
"startTime": "2024-02-13T00:00:00Z"
},
...
],
...
}
],
...
}
vists
और transitions
के बीच संबंध के बारे में पिकअप और डिलीवरी स्टॉप ऑर्डर ऑप्टिमाइज़ेशन के साथ-साथ ShipmentRoute
के रेफ़रंस दस्तावेज़ (REST, gRPC) में बताया गया है.
मेट्रिक की प्रॉपर्टी
Metrics
मैसेज (REST, gRPC) में पूरे समाधान की खास जानकारी होती है.
कुछ अहम Metrics
प्रॉपर्टी में ये शामिल हैं:
- रास्तों को पूरा करने में लगने वाला कुल खर्च
totalCost
है. लागत मॉडल के पैरामीटर में लागत के बारे में ज़्यादा पढ़ें. - समाधान में इस्तेमाल किए गए वाहनों की कुल संख्या
usedVehicleCount
है. अगर ऑप्टिमाइज़र को लगता है कि वाहनों का इस्तेमाल ज़रूरी नहीं है, तो उनके रास्ते खाली हो सकते हैं. skippedMandatoryShipmentCount
, स्किप किए गए उन शिपमेंट की संख्या है जो "ज़रूरी" हैं. ज़रूरी शिपमेंट में, उसpenaltyCost
के बारे में नहीं बताया जाता है जो शिपमेंट को स्किप करने पर लागू होता है. अगर तय की गई शर्तों के तहत काम करना मुमकिन नहीं है, तो ज़रूरी शिपमेंट को अब भी छोड़ा जा सकता है. लागत मॉडल के पैरामीटर में लागत के बारे में ज़्यादा पढ़ें.
अन्य मेट्रिक को AggregatedMetrics
मैसेज (REST,
gRPC) के तौर पर रिपोर्ट किया जाता है. AggregatedMetrics
मैसेज टाइप का इस्तेमाल Metrics.aggregatedRouteMetrics
प्रॉपर्टी के लिए और ShipmentRoute.metrics
प्रॉपर्टी Metrics.aggregatedRouteMetrics
के लिए किया जाता है. इसमें OptimizeToursResponse
में मौजूद सभी ShipmentRoute
की मेट्रिक शामिल होती हैं. हर ShipmentRoute.metrics
प्रॉपर्टी में, उस ShipmentRoute
की मेट्रिक शामिल होती हैं.
AggregatedMetrics
की अहम प्रॉपर्टी में ये शामिल हैं:
performedShipmentCount
वाहनों से किए गए शिपमेंट की संख्या है, जो उनके पूरे रास्ते पर हुई है.travelDuration
का मतलब है कि रास्तों को पूरा करने में, वाहनों से लगने वाला कुल समय.waitDuration
वह कुल समय है जो वाहन अपने रूट पूरा करने के दौरान इंतज़ार करते हैं.- वाहनों से होने वाली देरी के लिए
delayDuration
का समय दिया गया है. आम तौर पर, अगर अनुरोध मेंTransitionAttributes
का इस्तेमाल नहीं किया जाता है, तो यह शून्य होता है. breakDuration
का मतलब है कि रास्तों को पूरा करते समय, ब्रेक के दौरान वाहनों से कितना समय बिताया गया.visitDuration
वह कुल समय है जो वाहन अपने रूट पूरे करने के दौरान, वेबसाइट पर आने-जाने में बिताते हैं. यह लागू होने वाले वाहन को असाइन किए गएVisit
से जुड़ेVisitRequest
के लिए सभीVisitRequest.duration
वैल्यू का योग है.totalDuration
, वाहनों के रास्ते पूरे करने के लिए ज़रूरी कुल समय है.travelDistanceMeters
का मतलब है कि वाहनों से तय किए गए कुल रास्ते को पूरा करते हुए, कुल कितनी दूरी तय की गई.maxLoads
मैप में अलग-अलग तरह के कॉन्टेंट को लोड करने की सुविधा मिलती है. इससे यह पता चलता है कि वाहनों के रूट पर, लोड होने में ज़्यादा से ज़्यादा कितना समय लगता है.
Metrics
मैसेज का उदाहरण:
{
"routes": [
...
],
"metrics": {
"aggregatedRouteMetrics": {
"performedShipmentCount": 1,
"travelDuration": "2322s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "0s",
"totalDuration": "2322s",
"travelDistanceMeters": 18603
},
"usedVehicleCount": 1,
"earliestVehicleStartTime": "2024-02-13T00:00:00Z",
"latestVehicleEndTime": "2024-02-13T00:38:42Z",
"totalCost": 18.603,
"costs": {
"model.vehicles.cost_per_kilometer": 18.603
}
}
}
पूरा उदाहरण
अनुरोध करें से मिले अनुरोध के लिए एक पूरा उदाहरण यह दिखता है:
{
"routes": [
{
"vehicleStartTime": "2024-02-13T00:00:00Z",
"vehicleEndTime": "2024-02-13T00:38:42Z",
"visits": [
{
"isPickup": true,
"startTime": "2024-02-13T00:00:00Z",
"detour": "0s"
},
{
"startTime": "2024-02-13T00:19:31Z",
"detour": "0s"
}
],
"transitions": [
{
"travelDuration": "0s",
"waitDuration": "0s",
"totalDuration": "0s",
"startTime": "2024-02-13T00:00:00Z"
},
{
"travelDuration": "1171s",
"travelDistanceMeters": 9004,
"waitDuration": "0s",
"totalDuration": "1171s",
"startTime": "2024-02-13T00:00:00Z"
},
{
"travelDuration": "1151s",
"travelDistanceMeters": 9599,
"waitDuration": "0s",
"totalDuration": "1151s",
"startTime": "2024-02-13T00:19:31Z"
}
],
"metrics": {
"performedShipmentCount": 1,
"travelDuration": "2322s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "0s",
"totalDuration": "2322s",
"travelDistanceMeters": 18603
},
"routeCosts": {
"model.vehicles.cost_per_kilometer": 18.603
},
"routeTotalCost": 18.603
}
],
"metrics": {
"aggregatedRouteMetrics": {
"performedShipmentCount": 1,
"travelDuration": "2322s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "0s",
"totalDuration": "2322s",
"travelDistanceMeters": 18603
},
"usedVehicleCount": 1,
"earliestVehicleStartTime": "2024-02-13T00:00:00Z",
"latestVehicleEndTime": "2024-02-13T00:38:42Z",
"totalCost": 18.603,
"costs": {
"model.vehicles.cost_per_kilometer": 18.603
}
}
}