การกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่

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

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

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

ข้อจำกัด

ก่อนเริ่มต้น คุณต้องทราบข้อจำกัดและข้อกำหนดต่อไปนี้

  • ความพร้อมใช้งานตามตำแหน่งทางภูมิศาสตร์: การกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่พร้อมให้บริการใน สหรัฐอเมริกา 48 รัฐที่อยู่ติดกัน เท่านั้น
  • คำแนะนำและความปลอดภัยสำหรับผู้ขับขี่: ผู้ขับขี่ต้องไม่พึ่งพาเส้นทาง ที่ API นี้แสดงผลเพียงอย่างเดียวว่าปลอดภัยหรือถูกกฎหมาย เราไม่รับประกันว่าเส้นทางจะเหมาะสมกับยานพาหนะ และการขับตามเส้นทางอาจทำให้ผู้ขับขี่พบกับอันตราย เช่น สะพานต่ำหรือถนนที่ห้ามยานพาหนะขนาดใหญ่สัญจร
  • เส้นทางที่พยายามอย่างเต็มที่: ในบางกรณี API อาจไม่พบเส้นทางที่ เป็นไปตามข้อจำกัดในการเดินทางอย่างครบถ้วน แต่จะแสดงผลเส้นทางที่ "พยายามอย่างเต็มที่" ซึ่งอาจยังคงผ่านพื้นที่ที่มีข้อจำกัด
  • ฟีเจอร์ที่ไม่รองรับ: การกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่ไม่รองรับสิ่งต่อไปนี้:
    • ราคาค่าผ่านทางสำหรับรถบรรทุก
    • ขีดจำกัดความเร็ว
    • การกำหนดเส้นทางสำหรับวัตถุอันตรายที่เป็นกัมมันตรังสี
  • การเรียกเก็บเงิน: Google จะเรียกเก็บเงินคำขอ optimizeTours ทั้งหมดในอัตราเดียวกัน ไม่ว่าคำขอจะกำหนดค่าพร็อพเพอร์ตี้การกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่ หรือไม่ก็ตาม
  • เส้นทางระยะไกล: เส้นทางรถบรรทุกระยะไกลที่มีระยะทาง 500 กิโลเมตรขึ้นไปต้องใช้เวลาในการคำนวณมากกว่าเส้นทางที่สั้นกว่า และอาจแสดงผลข้อมูลเส้นทางที่มีคุณภาพต่ำกว่า จำกัดระยะทางระหว่างการจัดส่ง สถานที่เริ่มต้นของยานพาหนะ และสถานที่สิ้นสุดของยานพาหนะเพื่อรักษาคุณภาพเส้นทาง หากต้องการเส้นทางยาวๆ ให้เพิ่มกำหนดเวลาของคำขอเพื่อลดโอกาสที่จะเกิดข้อผิดพลาด DEADLINE_EXCEEDED

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

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

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้ระดับบนสุดสำหรับการกำหนดค่าการกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่

พร็อพเพอร์ตี้ ประเภท ข้อกำหนด คำอธิบาย
travelMode สตริง ต้องระบุ ระบุโหมดการเดินทางของยานพาหนะ หากต้องการเปิดใช้พร็อพเพอร์ตี้การกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่ ให้ตั้งค่านี้เป็น TRUCK
routeModifiers ออบเจ็กต์ ต้องระบุ มีข้อมูลการกำหนดค่าเฉพาะเส้นทาง รวมถึง vehicleInfo

vehicleInfo

ออบเจ็กต์ vehicleInfo มีข้อมูลจำเพาะทางกายภาพของ ยานพาหนะ กำหนดออบเจ็กต์นี้ภายในพร็อพเพอร์ตี้ routeModifiers คุณต้องระบุออบเจ็กต์ vehicleInfo หากตั้งค่า travelMode เป็น TRUCK

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้ที่ใช้ได้ภายในออบเจ็กต์ vehicleInfo

พร็อพเพอร์ตี้ ประเภท ข้อกำหนด คำอธิบาย
totalHeightMm จำนวนเต็ม ต้องระบุ ระบุความสูงรวมของยานพาหนะเป็นมิลลิเมตร ค่านี้ต้องเป็นจำนวนเต็มบวก
totalWidthMm จำนวนเต็ม ต้องระบุ ระบุความกว้างรวมของยานพาหนะเป็นมิลลิเมตร ค่านี้ต้องเป็นจำนวนเต็มบวก
totalWeightKg จำนวนเต็ม ต้องระบุ ระบุน้ำหนักรวมของยานพาหนะเป็นกิโลกรัม ค่านี้ต้องเป็นจำนวนเต็มบวก
totalLengthMm จำนวนเต็ม ต้องระบุ ระบุความยาวรวมของยานพาหนะเป็นมิลลิเมตร ค่านี้ต้องเป็นจำนวนเต็มบวก
trailerInfo อาร์เรย์ ไม่บังคับ มีอาร์เรย์ของข้อมูลจำเพาะของรถพ่วง ซึ่งรวมถึงพร็อพเพอร์ตี้ lengthMm เพื่อระบุความยาวของรถพ่วงแต่ละคันเป็นมิลลิเมตร
totalAxleCount จำนวนเต็ม ต้องระบุ ระบุจำนวนเพลารวมของยานพาหนะ ค่านี้ต้องเป็นจำนวนเต็มตั้งแต่ 2 ขึ้นไป

ตัวอย่าง

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

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

ตัวอย่างต่อไปนี้แสดงโครงสร้างของพร็อพเพอร์ตี้ที่ใช้สำหรับการกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่

"vehicles": [
  {
    "travelMode": "TRUCK",
    "routeModifiers": {
      "vehicleInfo": {
        "totalHeightMm": TOTAL_HEIGHT_MM,
        "totalWidthMm": TOTAL_WIDTH_MM,
        "totalWeightKg": TOTAL_WEIGHT_KG,
        "totalLengthMm": TOTAL_LENGTH_MM,
        "trailerInfo": [
          {
            "lengthMm": TRAILER_LENGTH_MM
          }
        ],
        "totalAxleCount": TOTAL_AXLE_COUNT
      }
    }
  }
]

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

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

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 40.953523,
              "longitude": -72.2277846
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 40.9546673,
              "longitude": -72.2580151
            }
          }
        ]
      }
    ],
    "vehicles": [
      {
        "travelMode": "TRUCK",
        "routeModifiers": {
          "vehicleInfo": {
            "totalHeightMm": 4000,
            "totalWidthMm": 2500,
            "totalWeightKg": 9000,
            "totalLengthMm": 20000,
            "trailerInfo": [
              {
                "lengthMm": 15000
              }
            ],
            "totalAxleCount": 5
          }
        },
        "costPerKilometer": 1.0
      }
    ]
  }
}