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

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

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

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

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

โครงสร้าง

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

• Shipment มีพร็อพเพอร์ตี้ penaltyCost
• 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 ดอลลาร์ ซึ่งหมายความว่าค่าพร็อพเพอร์ตี้โมเดลต้นทุนในคำขอของคุณมีดังนี้

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

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

ในสถานการณ์นี้ ความสมดุลของต้นทุนของเส้นทางทั้ง 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: ต้นทุนทั้งหมดในทุกเส้นทางรวมกัน