รูปแบบต้นทุน

พร็อพเพอร์ตี้ค่าใช้จ่ายจะกำหนดไว้ใน ShipmentModel.shipments.Shipment และ ShipmentModel.vehicles.Vehicle

เป้าหมายหลักของ Route Optimization API คือการค้นหาเส้นทางที่มีต้นทุนต่ำที่สุด ด้วยเหตุนี้ รูปแบบต้นทุนจึงเป็นตัวขับเคลื่อนหลักในการเพิ่มประสิทธิภาพเส้นทาง

โมเดลต้นทุนคือชุดพร็อพเพอร์ตี้ที่ระบุต้นทุนส่วนกลาง ต้นทุนยานพาหนะ และต้นทุนการจัดส่ง

พร็อพเพอร์ตี้รูปแบบต้นทุนรองรับวัตถุประสงค์การเพิ่มประสิทธิภาพประเภทต่อไปนี้

  • การมอบหมายยานพาหนะและเส้นทางที่มีประสิทธิภาพ
  • เวลารับสินค้าและนำส่งที่คุ้มค่า
  • การจัดลำดับความสำคัญของการจัดส่งที่สำคัญ

โครงสร้าง

ดังที่แสดงในแผนภาพ พร็อพเพอร์ตี้ของรูปแบบต้นทุนมีโครงสร้างดังนี้

เอกสารนี้ไฮไลต์เฉพาะพารามิเตอร์โมเดลต้นทุนที่สำคัญ ดูชุดพารามิเตอร์ต้นทุนทั้งหมดได้ในเอกสารอ้างอิง

รายการตรวจสอบ Essentials

รายการตรวจสอบต่อไปนี้อธิบายความรู้ที่จำเป็นซึ่งจะช่วยป้องกันข้อผิดพลาดที่อาจเกิดขึ้นเกี่ยวกับค่าใช้จ่าย รายการนี้จะช่วยคุณตรวจสอบคำขอและแก้ปัญหาการตอบกลับ

พร็อพเพอร์ตี้

ตารางต่อไปนี้แสดงและอธิบายพร็อพเพอร์ตี้ของรูปแบบต้นทุน

ผู้ปกครอง ชื่อพร็อพเพอร์ตี้ ประเภทที่พัก ต้นทุนต่อ คำอธิบายที่พัก
Shipment penaltyCost ตัวเลข ข้ามการจัดส่งแล้ว ค่าใช้จ่ายที่เกิดขึ้นจากการข้ามการจัดส่ง
API จะข้ามการจัดส่งเมื่อต้นทุนในการจัดส่งให้เสร็จสมบูรณ์เกินต้นทุนค่าปรับ
  • การตั้งค่า penaltyCost จะให้ความสำคัญกับการนำส่งพัสดุที่มีค่าใช้จ่ายสูงกว่า
  • การไม่ตั้งค่า penaltyCost ของการจัดส่งจะทำให้การจัดส่งเป็นข้อบังคับ
  • การตั้งค่าการจัดส่ง penaltyCost เป็น 0 อย่างชัดเจนจะทำให้ API ข้ามการจัดส่งเสมอ เว้นแต่จะมีข้อจำกัดอื่นๆ กำหนดไว้
Vehicle fixedCost ตัวเลข การจัดส่ง ต้นทุนคงที่ที่ใช้หากใช้ยานพาหนะนี้เพื่อจัดการการจัดส่ง
costPerHour ตัวเลข ชั่วโมง ค่าใช้จ่ายในการใช้งานยานพาหนะต่อชั่วโมง ซึ่งรวมเวลาเดินทาง เวลารอ เวลาเข้าชม และเวลาพัก
เมื่อค่าใช้จ่ายนี้เพิ่มขึ้น เครื่องมือเพิ่มประสิทธิภาพจะพยายามค้นหาเส้นทางที่เร็วขึ้นซึ่งอาจไม่ใช่เส้นทางที่สั้นที่สุด
พร็อพเพอร์ตี้นี้อาจเป็นต้นทุนต่อยานพาหนะแบบสแตนด์อโลนที่มีประสิทธิภาพเนื่องจากมีความเรียบง่ายและครบถ้วนสมบูรณ์
costPerKilometer ตัวเลข กิโลเมตร ค่าใช้จ่ายต่อกิโลเมตรที่เดินทางโดยยานพาหนะ ซึ่งอาจแสดงถึงค่าเชื้อเพลิงหรือค่าบำรุงรักษายานพาหนะที่ตัดจำหน่าย
costPerTraveledHour ตัวเลข ชั่วโมง ค่าใช้จ่ายในการใช้งานยานพาหนะต่อชั่วโมงเฉพาะขณะเดินทาง โดยไม่รวมเวลารอ เวลาเข้าชม และเวลาพัก ซึ่งจะให้ความสำคัญกับเส้นทางการเดินทางที่เร็วกว่าเส้นทางที่สั้นกว่า

ตัวอย่าง

ส่วนนี้จะครอบคลุมตัวอย่าง 3 ประเภท ได้แก่

  • ตัวอย่างโค้ดที่แสดงโครงสร้างของพร็อพเพอร์ตีรูปแบบค่าใช้จ่าย
  • ตัวอย่างสถานการณ์ที่แสดงวิธีหนึ่งในการใช้พร็อพเพอร์ตีรูปแบบต้นทุนเพื่อบรรลุวัตถุประสงค์ทางธุรกิจ
  • ตัวอย่างคำขอที่มีค่าที่กำหนดไว้ในสถานการณ์ตัวอย่าง

ตัวอย่างโค้ด

ตัวอย่างโค้ดต่อไปนี้แสดงโครงสร้างของพร็อพเพอร์ตี้รูปแบบต้นทุนใน Shipment

{
  "model": {
    "shipments": [ ...
      {
        "penaltyCost": PENALTY_COST
      }
    ],
    "vehicles": [ ...
    ]
  }
}

ตัวอย่างโค้ดต่อไปนี้แสดงโครงสร้างของพร็อพเพอร์ตี้รูปแบบต้นทุนใน Vehicle

{
  "model": {
    "shipments": [ ...
    ],
    "vehicles": [ ...
      {
        "fixedCost": FIXED_COST,
        "costPerKilometer": KILOMETER_COST,
        "costPerHour": HOUR_COST,
        "costPerTraveledHour": TRAVELED_HOUR_COST
      }
    ]
  }
}

สถานการณ์ตัวอย่าง

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

สำหรับตัวอย่างนี้ หน่วยต้นทุน 1 หน่วยจะเท่ากับ 1 ดอลลาร์ ซึ่งหมายความว่าค่าพร็อพเพอร์ตี้ของรูปแบบค่าใช้จ่ายในคำขอของคุณมีดังนี้

พร็อพเพอร์ตี้ ค่า สถานการณ์
penaltyCost 10 แสดงค่าปรับที่คุณเรียกเก็บจากลูกค้าที่ไม่มารับสุนัขในวันที่กำหนด เมื่อใดก็ตามที่คุณไม่ไปรับสุนัขในวันที่กำหนด ลูกค้าจะได้รับส่วนลด 40 ดอลลาร์จากยอดรวมค่าบริการ
fixedCost 30 แสดงค่าใช้จ่ายรายวันสำหรับการชำระเงินสินเชื่อรถยนต์ ซึ่งเท่ากับ 30 ดอลลาร์ต่อวัน
costPerKilometer 0.08 แสดงปริมาณน้ำมันที่รถใช้ต่อกิโลเมตร รถของคุณต้องใช้เชื้อเพลิง 0.04 แกลลอนต่อกิโลเมตรในการเคลื่อนที่ และค่าเชื้อเพลิงต่อแกลลอนในภูมิภาคของคุณคือ 2 ดอลลาร์
costPerHour 27 แสดงจำนวนเงินที่คุณจ่ายให้คนขับรถของคุณ คุณจ่ายเงินให้คนขับ 27 ดอลลาร์ต่อชั่วโมง
costPerTraveledHour 2.5 แสดงจำนวนเงินที่คุณต้องจ่ายสำหรับการปรับอากาศของรถยนต์ต่อชั่วโมงสำหรับสุนัขขณะอยู่บนท้องถนน เมื่อรถหยุดนิ่ง คนขับจะเปิดประตูหลังและปิดเครื่องปรับอากาศได้

เครื่องมือเพิ่มประสิทธิภาพอาจทำการแลกเปลี่ยนที่ไม่ชัดเจนสำหรับผู้ใช้ แต่สามารถพบได้ผ่านการเพิ่มประสิทธิภาพ โดยอิงตามพารามิเตอร์ต้นทุน

แผนภาพต่อไปนี้แสดงตัวอย่างที่เครื่องมือเพิ่มประสิทธิภาพสามารถเลือกเส้นทางที่ยาวกว่าแต่เร็วกว่าผ่านเส้นประสีเขียวเพื่อหลีกเลี่ยงการจราจรบนเส้นประสีแดง

ยานพาหนะมีเส้นทางที่เป็นไปได้ 2 เส้นทาง เส้นทางแรกแสดงด้วยเส้นประสีเขียว ซึ่งยาวกว่าแต่ไม่มีเหตุการณ์ใดๆ และอีกเส้นทางหนึ่งแสดงด้วยเส้นประสีแดง ซึ่งสั้นกว่าแต่มีรถชนอยู่ตรงกลาง

ในสถานการณ์นี้ ยอดคงเหลือของค่าใช้จ่ายของทั้ง 2 เส้นทางจะเป็นดังนี้

  • เส้นประสีเขียวมี costPerHour และ costPerTraveledHour ต่ำเนื่องจากเป็นเส้นทางที่รวดเร็วซึ่งหลีกเลี่ยงการจราจรติดขัด ซึ่งคุ้มค่ากว่าแม้ว่า costPerKilometer จะสูงก็ตาม

  • เส้นประสีแดงมี costPerKilometer ต่ำเนื่องจากเป็นเส้นทางตรง แต่ costPerHour และ costPerTraveledHour สูงเกินไปเนื่องจากเวลารอในการจราจร ทำให้เป็นเส้นทางที่มีค่าใช้จ่ายสูงที่สุด

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

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

ตัวอย่างต่อไปนี้แสดงโครงสร้างของคำขอ optimizeTours พื้นฐานที่รวมค่าที่กำหนดไว้ในสถานการณ์ตัวอย่าง

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.8024,
              "longitude": -122.4058
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            }
          }
        ]
        "penaltyCost": 40
      }
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "endLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "fixedCost": 30,
        "costPerKilometer": 0.08,
        "costPerHour": 27,
        "costPerTraveledHour": 2.5
      }
    ]
  }
}

พร็อพเพอร์ตี้การตอบกลับ

ข้อความ OptimizeToursResponse มีพร็อพเพอร์ตี้ค่าใช้จ่ายที่อธิบายค่าใช้จ่ายที่เกิดขึ้นในกระบวนการเดินทางตามเส้นทางจนเสร็จสมบูรณ์ ดังนี้

  • metrics.costs: ค่าใช้จ่ายทั้งหมดในทุกเส้นทางโดยแบ่งตามช่องคำขอที่เกี่ยวข้องกับค่าใช้จ่าย
  • metrics.totalCost: ต้นทุนรวมของทุกเส้นทางรวมกัน