উদাহরণ: বেসিক পিকআপ এবং ডেলিভারি অপ্টিমাইজেশন

এই উদাহরণটি মৌলিক খরচ পরামিতি সহ একটি গাড়ির জন্য নির্ধারিত স্টপের ক্রমের একটি মৌলিক অপ্টিমাইজেশন দেখায়। এটি নিশ্চিত করে যে সমস্ত স্টপগুলি সবচেয়ে সাশ্রয়ী ক্রমে নির্দিষ্ট সময়সীমার মধ্যে পরিদর্শন করা হয়েছে।

উদাহরণ অনুরোধ

এই উদাহরণ অনুরোধে নিম্নলিখিত মূল পরামিতি রয়েছে:

• populatePolylines এবং populateTransitionPolylines : গাড়ির রুটের জন্য এনকোডেড পলিলাইন পাথ পেতে এগুলিকে true তে সেট করুন।
• globalStartTime এবং globalEndTime : ২৪ ঘন্টার মধ্যে সমস্ত কার্যকলাপ সম্পন্ন করতে হবে তা নির্ধারণ করুন। টাইম উইন্ডো সম্পর্কে আরও জানুন টাইম উইন্ডো কী ধারণায়।
• shipments : তিনটি শিপমেন্ট নির্ধারণ করুন, প্রতিটিতে একটি সাধারণ ডিপো অবস্থান থেকে একটি পিকআপ এবং একটি অনন্য গন্তব্যে ডেলিভারি থাকবে। যেহেতু আপনি একটি penaltyCost সেট করেন না, তাই সমস্ত শিপমেন্ট বাধ্যতামূলক।
• vehicles : একটি সাধারণ শুরু এবং শেষ অবস্থান সহ একটি যানবাহন সংজ্ঞায়িত করুন। সবচেয়ে সস্তা রুট খুঁজে পেতে অপ্টিমাইজারকে গাইড করার জন্য costPerKilometer এবং costPerHour প্রদান করুন। খরচ সম্পর্কে আরও জানুন খরচ মডেল কী ধারণায়।

একটি নমুনা অনুরোধ দেখুন

      {
        "populatePolylines": true,
        "populateTransitionPolylines": true,
        "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"
                }
              ]
            },
            {
              "deliveries": [
                {
                  "arrivalLocation": {
                    "latitude": 37.789116,
                    "longitude": -122.395080
                  },
                  "duration": "250s"
                }
              ],
              "pickups": [
                {
                  "arrivalLocation": {
                    "latitude": 37.794465,
                    "longitude": -122.394839
                  },
                  "duration": "150s"
                }
              ]
            },
            {
              "deliveries": [
                {
                  "arrivalLocation": {
                    "latitude": 37.795242,
                    "longitude": -122.399347
                  },
                  "duration": "250s"
                }
              ],
              "pickups": [
                {
                  "arrivalLocation": {
                    "latitude": 37.794465,
                    "longitude": -122.394839
                  },
                  "duration": "150s"
                }
              ]
            }
          ],
          "vehicles": [
            {
              "endLocation": {
                "latitude": 37.794465,
                "longitude": -122.394839
              },
              "startLocation": {
                "latitude": 37.794465,
                "longitude": -122.394839
              },
              "costPerKilometer": 10.0,
              "costPerHour": 40.0
            }
          ]
        }
      }
    

উদাহরণ প্রতিক্রিয়া

প্রতিক্রিয়াটিতে একটি শীর্ষ-স্তরের routes ক্ষেত্র অন্তর্ভুক্ত রয়েছে যা প্রস্তাবিত রুটগুলিকে প্রতিনিধিত্ব করে, প্রতিটি যানবাহনের জন্য একটি রুট সহ। যেহেতু এই নির্দেশিকায় উদাহরণ অনুরোধে শুধুমাত্র একটি যানবাহন উল্লেখ করা হয়েছে, routes শুধুমাত্র একটি ShipmentRoute বার্তা অন্তর্ভুক্ত রয়েছে।

নমুনা অনুরোধের একটি প্রতিক্রিয়া দেখুন

    {
      "routes": [
        {
          "vehicleStartTime": "2023-01-14T00:00:00Z",
          "vehicleEndTime": "2023-01-14T00:36:41Z",
          "visits": [
            {
              "shipmentIndex": 2,
              "isPickup": true,
              "startTime": "2023-01-14T00:00:00Z",
              "detour": "0s"
            },
            {
              "shipmentIndex": 1,
              "isPickup": true,
              "startTime": "2023-01-14T00:02:30Z",
              "detour": "150s"
            },
            {
              "isPickup": true,
              "startTime": "2023-01-14T00:05:00Z",
              "detour": "300s"
            },
            {
              "startTime": "2023-01-14T00:11:25Z",
              "detour": "0s"
            },
            {
              "shipmentIndex": 1,
              "startTime": "2023-01-14T00:19:29Z",
              "detour": "503s"
            },
            {
              "shipmentIndex": 2,
              "startTime": "2023-01-14T00:29:02Z",
              "detour": "1324s"
            }
          ],
          "transitions": [
            {
              "travelDuration": "0s",
              "waitDuration": "0s",
              "totalDuration": "0s",
              "startTime": "2023-01-14T00:00:00Z",
              "routePolyline": {}
            },
            {
              "travelDuration": "0s",
              "waitDuration": "0s",
              "totalDuration": "0s",
              "startTime": "2023-01-14T00:02:30Z",
              "routePolyline": {}
            },
            {
              "travelDuration": "0s",
              "waitDuration": "0s",
              "totalDuration": "0s",
              "startTime": "2023-01-14T00:05:00Z",
              "routePolyline": {}
            },
            {
              "travelDuration": "235s",
              "travelDistanceMeters": 795,
              "waitDuration": "0s",
              "totalDuration": "235s",
              "startTime": "2023-01-14T00:07:30Z",
              "routePolyline": {
                "points": "kvteFtfjVAA?C?C@C?A?C@AFMj@s@JKb@k@Zc@LSjA}ARWDGdAxAdAvAXa@@k@AsA\\c@FKp@_A\\c@Ze@fA{ALSFGd@o@rAgBB{BZc@"
              }
            },
            {
              "travelDuration": "234s",
              "travelDistanceMeters": 793,
              "waitDuration": "0s",
              "totalDuration": "234s",
              "startTime": "2023-01-14T00:15:35Z",
              "routePolyline": {
                "points": "cwseFti_jVRWj@w@x@eAHLNRHJbApAHLX\\V^?@hA~AT\\PVFFDHDFJNp@~@NRLNNTFFUZIJY^Y^g@p@[`@KP{@fAEFSXe@l@c@h@WZY\\?BELk@v@MNa@l@"
              }
            },
            {
              "travelDuration": "323s",
              "travelDistanceMeters": 1204,
              "waitDuration": "0s",
              "totalDuration": "323s",
              "startTime": "2023-01-14T00:23:39Z",
              "routePolyline": {
                "points": "cuseFhjVSTY`@Yb@GHEDIJEF]f@IJi@r@oAbBeCfDKLaApAKNQVIPKPCDQJIBIBM@iAJeALqBVC@C?A?QBYDI@C?_@Dc@FO@a@FDp@HfAHvABVDl@Dj@PpCQDiALsALAQASKwAOgBEe@COCYEa@Es@Eg@"
              }
            },
            {
              "travelDuration": "209s",
              "travelDistanceMeters": 665,
              "waitDuration": "0s",
              "totalDuration": "209s",
              "startTime": "2023-01-14T00:33:12Z",
              "routePolyline": {
                "points": "{zteFxbajV?CAYEc@AMC_@AOAK?E?CCWAOAKCe@CY?WScDEm@d@EFA\\ENCB?XEVC^E`@EhBUVCNEB?@?\\Er@IMUe@k@k@w@AAMQa@i@SWQWMQi@u@AC?A"
              }
            }
          ],
          "routePolyline": {
            "points": "kvteFtfjVAA?C?C@C?A?C@AFMj@s@JKb@k@Zc@LSjA}ARWDGdAxAdAvAXa@@k@AsA\\c@FKp@_A\\c@Ze@fA{ALSFGd@o@rAgBB{BZc@RWj@w@x@eAHLNRHJbApAHLX\\V^?@hA~AT\\PVFFDHDFJNp@~@NRLNNTFFUZIJY^Y^g@p@[@KP{@fAEFSXe@l@c@h@WZY\\?BELk@v@MNa@l@STY@Yb@GHEDIJEF]f@IJi@r@oAbBeCfDKLaApAKNQVIPKPCDQJIBIBM@iAJeALqBVC@C?A?QBYDI@C?_@Dc@FO@a@FDp@HfAHvABVDl@Dj@PpCQDiALsALAQASKwAOgBEe@COCYEa@Es@Eg@?CAYEc@AMC_@AOAK?E?CCWAOAKCe@CY?WScDEm@d@EFA\\ENCB?XEVC^E`@EhBUVCNEB?@?\\Er@IMUe@k@k@w@AAMQa@i@SWQWMQi@u@AC?A"
          },
          "metrics": {
            "performedShipmentCount": 3,
            "travelDuration": "1001s",
            "waitDuration": "0s",
            "delayDuration": "0s",
            "breakDuration": "0s",
            "visitDuration": "1200s",
            "totalDuration": "2201s",
            "travelDistanceMeters": 3457
          },
          "travelSteps": [
            {
              "duration": "0s",
              "routePolyline": {}
            },
            {
              "duration": "0s",
              "routePolyline": {}
            },
            {
              "duration": "0s",
              "routePolyline": {}
            },
            {
              "duration": "227s",
              "distanceMeters": 794,
              "routePolyline": {
                "points": "kvteFtfjVAA?C?C@C?A?C@AFMj@s@JKb@k@Zc@LSjA}ARWDGdAxAdAvAXa@@k@AsA\\c@FKp@_A\\c@Ze@fA{ALSFGd@o@rAgBB{BZc@"
              }
            },
            {
              "duration": "233s",
              "distanceMeters": 791,
              "routePolyline": {
                "points": "cwseFti_jVRWj@w@x@eAHLNRHJbApAHLX\\V^?@hA~AT\\PVFFDHDFJNp@~@NRLNNTFFUZIJY^Y^g@p@[`@KP{@fAEFSXe@l@c@h@WZY\\?BELk@v@MNa@l@"
              }
            },
            {
              "duration": "322s",
              "distanceMeters": 1205,
              "routePolyline": {
                "points": "cuseFhjVSTY`@Yb@GHEDIJEF]f@IJi@r@oAbBeCfDKLaApAKNQVIPKPCDQJIBIBM@iAJeALqBVC@C?A?QBYDI@C?_@Dc@FO@a@FDp@HfAHvABVDl@Dj@PpCQDiALsALAQASKwAOgBEe@COCYEa@Es@Eg@"
              }
            },
            {
              "duration": "208s",
              "distanceMeters": 666,
              "routePolyline": {
                "points": "{zteFxbajV?CAYEc@AMC_@AOAK?E?CCWAOAKCe@CY?WScDEm@d@EFA\\ENCB?XEVC^E`@EhBUVCNEB?@?\\Er@IMUe@k@k@w@AAMQa@i@SWQWMQi@u@AC?A"
              }
            }
          ],
          "vehicleDetour": "2201s",
          "routeCosts": {
            "model.vehicles.cost_per_hour": 24.455555555555556,
            "model.vehicles.cost_per_kilometer": 34.57
          },
          "routeTotalCost": 59.025555555555556
        }
      ],
      "totalCost": 59.025555555555556,
      "metrics": {
        "aggregatedRouteMetrics": {
          "performedShipmentCount": 3,
          "travelDuration": "1001s",
          "waitDuration": "0s",
          "delayDuration": "0s",
          "breakDuration": "0s",
          "visitDuration": "1200s",
          "totalDuration": "2201s",
          "travelDistanceMeters": 3457
        },
        "usedVehicleCount": 1,
        "earliestVehicleStartTime": "2023-01-14T00:00:00Z",
        "latestVehicleEndTime": "2023-01-14T00:36:41Z",
        "totalCost": 59.025555555555556,
        "costs": {
          "model.vehicles.cost_per_kilometer": 34.57,
          "model.vehicles.cost_per_hour": 24.455555555555556
        }
      }
    }
    

সম্পূর্ণ যানবাহনের রুট নিম্নলিখিত ক্ষেত্রগুলি দ্বারা বর্ণনা করা হয়েছে:

• visits : এই অ্যারেতে সমস্ত পিকআপ এবং ডেলিভারি অপ্টিমাইজড ক্রমে তালিকাভুক্ত করা হয়েছে। এই উদাহরণে, অপ্টিমাইজার নির্ধারণ করেছে যে সবচেয়ে কার্যকর ক্রম হল প্রথমে ডিপো থেকে তিনটি শিপমেন্ট তুলে নেওয়া এবং তারপর ডেলিভারি করা।
• transitions : এই অ্যারে প্রতিটি ভিজিটের মধ্যে ভ্রমণের অংশগুলি তালিকাভুক্ত করে। যেহেতু তিনটি পিকআপ একই স্থানে ঘটে, তাই প্রথম তিনটি ট্রানজিশনের travelDuration "0 সেকেন্ড"।
• routePolyline : উপরের স্তরের পলিলাইনটি গাড়ির শুরু থেকে শেষ পর্যন্ত সম্পূর্ণ পথকে প্রতিনিধিত্ব করে। আপনি প্রতিটি transition অবজেক্টের মধ্যে ছোট পলিলাইনও খুঁজে পেতে পারেন যা পৃথক ভ্রমণ অংশগুলিকে প্রতিনিধিত্ব করে। দ্রষ্টব্য: আপনি ইন্টারেক্টিভ পলিলাইন এনকোডার ইউটিলিটি ব্যবহার করে এগুলি এবং অন্য যেকোনো পলিলাইন কল্পনা করতে পারেন।