ส่งคำขอที่มีต้นทุนการโหลด

ส่งคําขอพร้อมต้นทุนการบรรทุกเพื่อให้เครื่องมือเพิ่มประสิทธิภาพพิจารณาน้ำหนักบรรทุกของยานพาหนะระหว่างการเข้าชม ค่าใช้จ่ายที่เกิดขึ้นจะขึ้นอยู่กับทั้งปริมาณ ShipmentRoute.VehicleLoad ที่ส่งและระยะทางหรือระยะเวลาของการเปลี่ยน (โดยใช้ cost_per_kilometer หรือ cost_per_traveled_hour ตามลำดับ)

ตัวอย่างคำขอขั้นต่ำที่มีค่าใช้จ่ายในการโหลด

ต่อไปนี้คือตัวอย่างบางส่วนของคำขอที่มีต้นทุนการโหลด ในตัวอย่างนี้ ยานพาหนะ 1 คันสามารถบรรทุกweightKgได้ไม่เกิน 1,000 กก. ซึ่งจะเสียค่าใช้จ่าย 1 หน่วยต่อกิโลเมตรเมื่อบรรทุกweightKgเกิน 500 กก.

  {
    "model": {
      "vehicles": [{
        "loadLimits": {
          "weightKg": {
            "maxLoad": "1000",
            "costPerKilometer": {
              "loadThreshold": "500",
              "costPerUnitAboveThreshold": 1
            }
          }
        }
      }]
    }
  }
  

การคำนวณต้นทุนการโหลดของตัวอย่างนี้จะเป็นดังนี้

cost = max(carried load - load threshold, 0) * distance * cost per unit above threshold

ดังนั้นหากยานพาหนะบรรทุกweightKgน้ำหนัก 600 กิโลกรัมในระยะทาง 10 กิโลเมตร การคำนวณจะออกมาดังนี้

(600 - 500) * 10 * 1 = 1000 cost units

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

คําขอตัวอย่างอีกรายการที่มีค่าใช้จ่ายในการโหลด

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

  {
    "model": {
      "vehicles": [{
        "loadLimits": {
          "weightLbs": {
            "maxLoad": "1000",
            "costPerTraveledHour": {
              "loadThreshold": "900",
              "costPerUnitAboveThreshold": 10,
              "costPerUnitBelowThreshold": 1
            },
          },
        }
      }]
    }
  }
  

การคำนวณต้นทุนการโหลดสำหรับตัวอย่างนี้จะเป็นดังนี้

cost = max(carried load - load threshold, 0) * time * cost per unit above threshold
  + min(carried load, load threshold) * time * cost per unit below threshold

ดังนั้นหากยานพาหนะบรรทุกweightLbs 950 เป็นเวลา 5 ชั่วโมง การคำนวณจะออกมาดังนี้

max(950 - 900, 0) * 5 * 10 + min(950, 900) * 5 * 1 = 7000

ในตัวอย่างนี้ load_threshold สำหรับต้นทุนการโหลด weightLbs อยู่ใกล้กับ max_load cost_per_unit_above_threshold จะมีต้นทุนสูงต่อชั่วโมงที่เดินทางเมื่อยานพาหนะบรรทุกน้ำหนักมากเป็นพิเศษ โดยจะหักคะแนนเส้นทางที่อาจทำให้ยานพาหนะสึกหรอหรือสิ้นเปลืองเชื้อเพลิงมากเกินไป cost_per_unit_below_threshold จะเพิ่มต้นทุนต่อน้ำหนัก 1 หน่วยที่ยานพาหนะบรรทุกจนถึงเกณฑ์ ซึ่งแสดงถึงปริมาณการใช้เชื้อเพลิงที่เพิ่มขึ้นเมื่อยานพาหนะบรรทุกน้ำหนักมากขึ้น

คำถามที่พบบ่อย

ต่อไปนี้คือคำถามที่พบบ่อยเกี่ยวกับต้นทุนการโหลด

คำถาม คำตอบ
ฉันจะระบุค่าบรรทุกได้ที่ใด ระบุค่าบรรทุกใน Vehicle.LoadLimit
ระบบจับคู่ค่าใช้จ่ายในการโหลดกับการจัดส่งอย่างไร ค่าใช้จ่ายในการบรรทุกจะมีผลกับการจัดส่งที่ประเภทดีมานด์การบรรทุกตรงกับประเภทของขีดจำกัดน้ำหนักบรรทุกของยานพาหนะ เช่น น้ำหนักหรือปริมาตร ประเภทการโหลดคือสตริงที่กำหนดเองตามที่อธิบายไว้ในความต้องการและขีดจำกัดของการโหลด
ค่าโหลดแสดงอย่างไร ต้นทุนการโหลดจะแสดงเป็นระยะทางหรือระยะเวลาของการเปลี่ยน ใช้ cost_per_kilometer เพื่อระบุค่าใช้จ่ายตามระยะทาง และ cost_per_traveled_hour เพื่อระบุค่าใช้จ่ายตามระยะเวลา
ระบบจะเรียกเก็บค่าโหลดเมื่อใด น้ำหนักบรรทุกของยานพาหนะจะเปรียบเทียบกับ load_threshold ของต้นทุนการบรรทุก หากระบุ cost_per_unit_above_threshold ระบบจะเพิ่มค่าใช้จ่ายตามสัดส่วนกับน้ำหนักบรรทุกของยานพาหนะที่เกิน load_threshold โดยใช้สูตร max(0, load - load_threshold) หากระบุ cost_per_unit_below_threshold ระบบจะเพิ่มค่าใช้จ่ายตามสัดส่วนน้ำหนักบรรทุกของยานพาหนะต่ำกว่า load_threshold โดยใช้สูตร min(load, load_threshold)
ค่าเริ่มต้นสำหรับพารามิเตอร์ต้นทุนการโหลดคืออะไร load_threshold, cost_per_unit_above_threshold และ cost_per_unit_below_threshold มีค่าเป็น 0 โดยค่าเริ่มต้น
ค่าใช้จ่ายในการโหลดแสดงเป็นสกุลเงินใด ต้นทุนการโหลดจะแสดงในหน่วยที่ไม่มีมิติข้อมูลเดียวกันกับพารามิเตอร์ต้นทุนอื่นๆ ทั้งหมด เช่น global_duration_cost_per_hour หรือ Shipment.penalty_cost
ฉันจะดูค่าโหลดในการตอบกลับได้จากที่ใด ค่าใช้จ่ายในการโหลดที่เกิดขึ้นจะปรากฏในพร็อพเพอร์ตี้ metrics และ route_metrics ของข้อความตอบกลับ เช่น cost_per_kilometer ที่เกิดขึ้นจะปรากฏเป็น model.vehicles.load_limits.cost_per_kilometer

ดูคำอธิบายโดยละเอียดเกี่ยวกับต้นทุนการโหลดได้ที่เอกสารอ้างอิง (REST, gRPC)

ตัวอย่าง: ส่งคำขอ OptimizeTours

นอกจากนี้ คุณยังส่งคําขอ OptimizeTours โดยใช้ REST หรือ gRPC ได้ด้วย

ก่อนส่งคําขอ ให้แทนที่พารามิเตอร์ต่อไปนี้ด้วยค่าที่เหมาะสมกับสภาพแวดล้อมของคุณ

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

    คำสั่งต่อไปนี้จะส่งคําขอ OptimizeTours ไปยัง Route Optimization API และรับการตอบกลับแบบซิงค์

    curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID:optimizeTours' \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    --data @- << EOM
    {
      "model": {
        "shipments": [
          {
            "deliveries": [
              {
                "arrivalLocation": {
                  "latitude": 37.789456,
                  "longitude": -122.390192
                },
                "duration": "250s"
              }
            ],
            "penaltyCost": 100.0,
            "loadDemands": {
              "weightKg": {
                "amount": 50
              }
            }
          },
          {
            "deliveries": [
              {
                "arrivalLocation": {
                  "latitude": 37.789116,
                  "longitude": -122.395080
                },
                "duration": "250s"
              }
            ],
            "penaltyCost": 30.0,
            "loadDemands": {
              "weightKg": {
                "amount": 10
              }
            }
          },
          {
            "deliveries": [
              {
                "arrivalLocation": {
                  "latitude": 37.795242,
                  "longitude": -122.399347
                },
                "duration": "250s"
              }
            ],
            "penaltyCost": 50.0,
            "loadDemands": {
              "weightKg": {
                "amount": 80
              }
            }
          }
        ],
        "vehicles": [
          {
            "endLocation": {
              "latitude": 37.794465,
              "longitude": -122.394839
            },
            "startLocation": {
              "latitude": 37.794465,
              "longitude": -122.394839
            },
            "costPerHour": 40.0,
            "costPerKilometer": 10.0,
            "loadLimits": {
              "weightKg": {
                "maxLoad": "100",
                "costPerKilometer": {
                  "loadThreshold": "15",
                  "costPerUnitAboveThreshold": 1
                }
              }
            }
          }
        ]
      }
    }
    EOM

เมื่อคำขอเสร็จสมบูรณ์แล้ว คุณจะได้รับข้อความตอบกลับ