ตัวอย่าง: รูปแบบต้นทุน

ตัวอย่างนี้แสดงวิธีใช้พารามิเตอร์ต้นทุนเพื่อให้ได้เส้นทางที่คุ้มค่า

ดูภาพรวมแนวคิดทั้งหมดได้ที่เอกสารแนวคิดหลักของรูปแบบค่าใช้จ่าย

ตัวอย่างคำขอ

ตัวอย่างต่อไปนี้แสดงสถานการณ์ที่ยานพาหนะ 1 คันต้องนำส่งสินค้า 3 รายการ ยานพาหนะมีค่าใช้จ่ายที่เกี่ยวข้องกับเวลาและระยะทาง และ การจัดส่งแต่ละครั้งจะมีpenaltyCost ที่เกิดขึ้นหากมีการข้ามการจัดส่ง

คำขอตัวอย่างนี้มีพารามิเตอร์ที่เกี่ยวข้องกับต้นทุนต่อไปนี้

ดูตัวอย่างคำขอพร้อมค่าใช้จ่าย

{
  "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
      }
    ]
  }
}
    

ตัวอย่างการตอบกลับ

คำตอบแสดงให้เห็นว่าเครื่องมือเพิ่มประสิทธิภาพสร้างเส้นทางที่ดำเนินการจัดส่ง 2 ใน 3 รายการ ระบบข้ามการจัดส่งครั้งที่ 3 เนื่องจาก penaltyCost ต่ำกว่าต้นทุนยานพาหนะที่คำนวณไว้สำหรับการรับและนำส่ง

ดูการตอบกลับคำขอตัวอย่างพร้อมค่าใช้จ่าย

{
  "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
    }
  }
}
    

ฟิลด์ต่อไปนี้แสดงวิธีคำนวณค่าใช้จ่ายในการตอบกลับ

  • routeCosts จะแสดงรายละเอียดต้นทุนในการดำเนินการสำหรับเส้นทางที่เฉพาะเจาะจง ซึ่งในกรณีนี้คือ
    • model.vehicles.cost_per_kilometer: 33.53.
    • model.vehicles.cost_per_hour: 18.91
  • routeTotalCost (52.44) คือผลรวมของค่าใช้จ่ายที่แสดงใน routeCosts
  • ที่ระดับบนสุดของการตอบกลับ ออบเจ็กต์ costs จะสรุปค่าใช้จ่ายทั้งหมดที่เกิดขึ้นในโซลูชัน ซึ่งรวมถึง ต้นทุนการดำเนินงานจากเส้นทางยานพาหนะทั้งหมด รวมถึงค่าปรับต่างๆ เช่น model.shipments.penalty_cost (5.0) สำหรับการนำส่งที่ข้ามไป
  • totalCost สุดท้าย (57.44) แสดงถึงยอดรวมทั้งหมดของโซลูชัน ซึ่งเป็นผลรวมของrouteTotalCost จากยานพาหนะทั้งหมด และค่าปรับทั้งหมด ในกรณีนี้คือ 52.44 + 5.0