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

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

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

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

ข้อจำกัด

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

  • ความพร้อมให้บริการตามภูมิศาสตร์: การกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่พร้อมให้บริการในสหรัฐอเมริกา 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
      }
    ]
  }
}

ขั้นตอนถัดไป