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

ผลิตภัณฑ์หรือฟีเจอร์นี้เป็นเวอร์ชันทดลอง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจมีการสนับสนุนที่จำกัด และการเปลี่ยนแปลงผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจไม่เข้ากันกับผลิตภัณฑ์และฟีเจอร์เวอร์ชันอื่นๆ ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป ข้อเสนอก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอยู่ภายใต้ Google ข้อกำหนดเฉพาะบริการของ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ใน คำอธิบายระยะการเปิดตัว

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

ตัวอย่างคำขอแบบย่อที่มีต้นทุนการบรรทุก

ต่อไปนี้คือตัวอย่างคำขอแบบบางส่วนที่มีต้นทุนการบรรทุก ในตัวอย่างนี้ ยานพาหนะคันเดียวสามารถบรรทุก 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 จะเพิ่มต้นทุนต่อหน่วยน้ำหนักที่ยานพาหนะบรรทุกจนถึงเกณฑ์ ซึ่งแสดงถึงการใช้เชื้อเพลิงที่เพิ่มขึ้นเมื่อยานพาหนะบรรทุกของมากขึ้น

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

คำถามที่พบบ่อยเกี่ยวกับต้นทุนการบรรทุกมีดังนี้

คำถาม	คำตอบ
ฉันจะระบุต้นทุนการบรรทุกได้ที่ใด	ระบุต้นทุนการบรรทุกใน 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_kilometercost_per_kilometer

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

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

คุณยังส่งคำขอ OptimizeTours ได้โดยใช้ REST หรือ gRPC

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

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

• ตั้งค่า PROJECT_NUMBER_OR_ID เป็นหมายเลขหรือรหัสโปรเจ็กต์ Cloud

  คำสั่งต่อไปนี้จะส่งคำขอ 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

  หมายเหตุ: ตัวอย่างนี้ใช้ --data @- เพื่ออ่านคำขอจากอินพุตมาตรฐาน ใช้ --data @Filename เพื่ออ่านจากไฟล์

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