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