รายการพารามิเตอร์

หน้าต่อไปนี้มีตารางพารามิเตอร์ตามลำดับตัวอักษรสำหรับคอมโพเนนต์ต่อไปนี้ของเมธอด optimizeTours ของ Route Optimization API

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

เนื้อความของคำขอ

โครงสร้างข้อมูลของเนื้อหาคำขอ

เนื้อหาของคำขอประกอบด้วยองค์ประกอบต่อไปนี้ ซึ่งแสดงใน ไดอะแกรมทางด้านขวาและแสดงอยู่ในตารางด้านล่าง

  • OptimizeToursRequest: ออบเจ็กต์คำขอระดับบนสุด ที่มีพารามิเตอร์ของโมเดลและการแก้ปัญหา
    • ShipmentModel: โครงสร้างข้อมูลหลักที่มีการจัดส่ง ยานพาหนะ และข้อจำกัดทั่วโลก
      • Shipment: งานที่มีการรับและนำส่ง
        • VisitRequest: สถานที่และข้อจำกัดสำหรับการ รับสินค้าหรือนำส่ง
      • Vehicle: มียานพาหนะที่พร้อมทำการจัดส่ง
ผู้ปกครอง พารามิเตอร์ ประเภทที่พัก คำอธิบาย
OptimizeToursRequest allowLargeDeadlineDespiteInterruptionRisk บูลีน (true/false) หากเป็น true ระบบจะประมวลผลคำขอแม้ว่าจะตั้งค่าการหมดเวลาเป็นค่าที่มาก (นานกว่า 30 นาที) ซึ่งอาจทำให้เซิร์ฟเวอร์หยุดชะงัก
considerRoadTraffic บูลีน (true/false) หาก true ใช้ข้อมูลการจราจรสำหรับการกำหนดเส้นทาง หากเป็นเท็จ จะใช้ความเร็วของเครือข่ายถนนเท่านั้น
geodesicMetersPerSecond ตัวเลข เมื่อ useGeodesicDistances เป็นจริง ระบบจะใช้ความเร็วนี้ในการคำนวณเวลาเดินทาง
injectedFirstSolutionRoutes[] อาร์เรย์ของออบเจ็กต์ (ShipmentRoute) เส้นทางจากโซลูชันก่อนหน้าเพื่อเริ่มการเพิ่มประสิทธิภาพ
injectedSolutionConstraint ออบเจ็กต์ (InjectedSolutionConstraint) จำกัดโซลูชันให้คล้ายกับเส้นทางที่มีอยู่ โดยระบุว่าต้องคงพร็อพเพอร์ตี้ใดไว้และอาจผ่อนปรนพร็อพเพอร์ตี้ใดได้
interpretInjectedSolutionsUsingLabels บูลีน (true/false) หาก true ตรงกับการจัดส่ง/ยานพาหนะในเส้นทางที่แทรกโดยใช้ label แทนดัชนีอาร์เรย์
label สตริง ป้ายกำกับที่กำหนดเองเพื่อระบุคำขอ ซึ่งจะแสดงในการตอบกลับ
maxValidationErrors จำนวนเต็ม ระบุจำนวนข้อผิดพลาดในการตรวจสอบสูงสุดที่จะแสดง หากไม่ได้ระบุไว้ ระบบจะใช้ขีดจำกัดเริ่มต้น
model ออบเจ็กต์ (ShipmentModel) ต้องระบุ ชุดยานพาหนะและการจัดส่งที่จะเพิ่มประสิทธิภาพ
populatePolylines บูลีน (true/false) หากเป็น true ระบบจะแสดงผลเส้นโพลีไลน์ที่เข้ารหัสสำหรับเส้นทาง
populateTransitionPolylines บูลีน (true/false) หาก true จะแสดงผลเส้นหลายเส้นที่เข้ารหัสสำหรับการเปลี่ยนเส้นทางแต่ละครั้งระหว่างการเข้าชม
refreshDetailsRoutes[] อาร์เรย์ของออบเจ็กต์ (ShipmentRoute) รายการเส้นทางที่จะรีเฟรช ซึ่งจะคำนวณเส้นหลายเส้น ระยะเวลา และระยะทางใหม่สำหรับเส้นทางที่มีอยู่โดยไม่ต้องแก้ไขลำดับการเยี่ยมชม
searchMode enum (SearchMode) RETURN_FAST (ผลลัพธ์รวดเร็ว) หรือ CONSUME_ALL_AVAILABLE_TIME (คุณภาพดีที่สุดภายในระยะหมดเวลา)
solvingMode enum (SolvingMode) DEFAULT_SOLVE (ค่าเริ่มต้น) หรือ VALIDATE_ONLY เพื่อตรวจสอบโมเดลโดยไม่ต้องแก้ปัญหา
timeout ระยะเวลา ระยะเวลาสูงสุดที่ตัวแก้ควรทำงาน (เช่น "30s", "300s")
useGeodesicDistances บูลีน (true/false) หาก true ระบบจะคำนวณระยะทางและเวลาในการเดินทางโดยใช้ระยะทางตามแนวเส้นตรงและใช้ความเร็ว geodesicMetersPerSecond
ShipmentModel
(ส่วนหนึ่งของ OptimizeToursRequest)
durationDistanceMatrices[] อาร์เรย์ของออบเจ็กต์ (DurationDistanceMatrix) ระบุเมทริกซ์ระยะเวลาและระยะทางที่กำหนดเองซึ่งใช้สำหรับการกำหนดเส้นทางระหว่างสถานที่
durationDistanceMatrixDstTags[] อาร์เรย์ของสตริง แท็กที่กำหนดปลายทาง (คอลัมน์) สำหรับเมทริกซ์ระยะเวลาและระยะทางที่กำหนดเอง
durationDistanceMatrixSrcTags[] อาร์เรย์ของสตริง แท็กที่กำหนดแหล่งที่มา (แถว) สำหรับเมทริกซ์ระยะเวลาและระยะทางที่กำหนดเอง
globalDurationCostPerHour ตัวเลข ต้นทุนต่อชั่วโมงของช่วงเวลาทั่วโลกของเส้นทาง ตั้งแต่เวลาเริ่มต้นของยานพาหนะที่เร็วที่สุดไปจนถึงเวลาสิ้นสุดของยานพาหนะที่ช้าที่สุด
globalEndTime การประทับเวลา เวลาสิ้นสุดล่าสุดสำหรับเหตุการณ์ใดๆ ในโมเดล
globalStartTime การประทับเวลา เวลาเริ่มต้นที่เร็วที่สุดสำหรับเหตุการณ์ใดก็ตามในโมเดล
maxActiveVehicles จำนวนเต็ม จำนวนยานพาหนะสูงสุดที่อนุญาตให้ใช้งานในโซลูชัน
precedenceRules[] อาร์เรย์ของออบเจ็กต์ (PrecedenceRule) กฎที่กำหนดข้อจำกัดในการสั่งซื้อระหว่างการจัดส่งที่เฉพาะเจาะจง
shipments[] อาร์เรย์ของออบเจ็กต์ (Shipment) รายการการจัดส่งที่จะให้บริการ
shipmentTypeIncompatibilities[] อาร์เรย์ของออบเจ็กต์ (ShipmentTypeIncompatibility) กฎที่ป้องกันไม่ให้ยานพาหนะคันเดียวกันให้บริการการจัดส่งบางประเภท
shipmentTypeRequirements[] อาร์เรย์ของออบเจ็กต์ (ShipmentTypeRequirement) กฎที่กำหนดให้การจัดส่งบางประเภทต้องใช้ยานพาหนะคันเดียวกัน
transitionAttributes[] อาร์เรย์ของออบเจ็กต์ (TransitionAttributes) ระบุค่าใช้จ่ายเพิ่มเติม ความล่าช้า และขีดจำกัดระยะทางสำหรับการเปลี่ยนเส้นทางระหว่างการเข้าชมที่มีแท็กที่เฉพาะเจาะจง
vehicles[] อาร์เรย์ของออบเจ็กต์ (Vehicle) รายการยานพาหนะที่พร้อมให้บริการสำหรับการจัดส่ง
Shipment
(ส่วนหนึ่งของ ShipmentModel)
allowedVehicleIndices[] อาร์เรย์ของจำนวนเต็ม ดัชนีของยานพาหนะที่ได้รับอนุญาตให้ทำการจัดส่งนี้
costsPerVehicle[] แผนที่ (คีย์: จำนวนเต็ม, ค่า: ตัวเลข) ค่าใช้จ่ายเพิ่มเติมที่เกิดขึ้นหากยานพาหนะเฉพาะให้บริการการจัดส่งนี้
costsPerVehicleIndices[] อาร์เรย์ของจำนวนเต็ม ดัชนีของยานพาหนะที่ใช้ค่า costsPerVehicle
deliveries[] อาร์เรย์ของออบเจ็กต์ (VisitRequest) ทางเลือกในการนำส่งสินค้า
ignore บูลีน (true/false) หากเป็น true ระบบจะไม่สนใจการจัดส่งและจะไม่นำไปใช้ในการเพิ่มประสิทธิภาพ
label สตริง ป้ายกำกับที่ผู้ใช้กำหนดเพื่อระบุการจัดส่ง ซึ่งจะแสดงในคำตอบ
loadDemands map (key: string, value: Load) ความจุที่จำเป็น (เช่น น้ำหนัก ปริมาตร) ในการขนส่งสินค้า
penaltyCost ตัวเลข ค่าใช้จ่ายหากไม่มีการให้บริการจัดส่ง หากไม่ได้ตั้งค่า การจัดส่งถือเป็นสิ่งจำเป็น
pickups[] อาร์เรย์ของออบเจ็กต์ (VisitRequest) ทางเลือกในการรับสินค้าที่จัดส่ง
pickupToDeliveryAbsoluteDetourLimit ระยะเวลา เวลาอ้อมสัมบูรณ์สูงสุดที่อนุญาตระหว่างการรับและการนำส่งเมื่อเทียบกับเส้นทางตรง
pickupToDeliveryRelativeDetourLimit ตัวเลข การอ้อมที่อนุญาตสูงสุดสำหรับการจัดส่ง (เช่น ค่า 2.0 หมายความว่าเวลาทั้งหมดอาจเป็น 2 เท่าของเวลาเดินทางโดยตรง)
pickupToDeliveryTimeLimit ระยะเวลา ระยะเวลาสูงสุดที่อนุญาตตั้งแต่เริ่มการรับสินค้าจนถึงเริ่มการนำส่ง
shipmentType สตริง การแยกประเภทประเภทที่ใช้สำหรับกฎความไม่เข้ากันและกฎข้อกำหนด
VisitRequest
(องค์ประกอบของ pickups และ deliveries ใน Shipment)
arrivalLocation ออบเจ็กต์ (LatLng) สถานที่ตั้งทางภูมิศาสตร์ที่มาถึงเป็นพิกัดละติจูด/ลองจิจูด
arrivalWaypoint ออบเจ็กต์ (Waypoint) สถานที่ที่ยานพาหนะมาถึงเพื่อทำการเยี่ยมชม กำหนดโดยพิกัดหรือรหัสสถานที่
cost ตัวเลข ค่าใช้จ่ายที่เกิดขึ้นหากผู้แก้ปัญหาเลือกคำขอการเข้าชมที่เฉพาะเจาะจงนี้
departureLocation ออบเจ็กต์ (LatLng) สถานที่ออกเดินทางทางภูมิศาสตร์เป็นพิกัดละติจูด/ลองจิจูด
departureWaypoint ออบเจ็กต์ (Waypoint) สถานที่ที่ยานพาหนะออกเดินทางหลังจากเยี่ยมชมเสร็จแล้ว หากไม่ระบุ ระบบจะถือว่าเหมือนกับ arrivalWaypoint
duration ระยะเวลา ระยะเวลาของการเข้าชม (เวลาให้บริการ) เช่น ระยะเวลาที่ใช้ในการโหลด/ขนถ่าย
label สตริง ป้ายกำกับที่ผู้ใช้กำหนดสำหรับคำขอการเข้าชมที่เฉพาะเจาะจงนี้ ซึ่งจะแสดงในคำตอบ
loadDemands map (key: string, value: Load) ดีมานด์ที่ระบุการเปลี่ยนแปลงการโหลดในการเข้าชมนี้ (เช่น -1 เพื่อส่งแพ็กเกจ)
tags[] อาร์เรย์ของสตริง แท็กที่แนบมากับคำขอเข้าชมนี้ ระบบจะใช้ข้อมูลเหล่านี้เพื่อคำนวณเวลาเดินทางระหว่างการเข้าชมนี้กับการเข้าชมอื่นๆ โดยใช้ transitionAttributes
timeWindows[] อาร์เรย์ของออบเจ็กต์ (TimeWindow) ช่วงเวลาที่อนุญาตสำหรับการมาถึงในการเข้าชมนี้
visitTypes[] อาร์เรย์ของสตริง สตริงที่อธิบายประเภทการเข้าชม (เช่น "การนำส่ง" "การติดตั้ง") ใช้เพื่อใช้ extraVisitDurationForVisitType จากรุ่นยานพาหนะ
Vehicle
(ส่วนหนึ่งของ ShipmentModel)
breakRule ออบเจ็กต์ (BreakRule) กำหนดกฎสำหรับการหยุดพัก (เช่น พักรับประทานอาหารกลางวัน)
costPerHour ตัวเลข ค่าใช้จ่ายต่อชั่วโมงของระยะเวลาเส้นทางทั้งหมด
costPerKilometer ตัวเลข ค่าใช้จ่ายต่อกิโลเมตร
costPerTraveledHour ตัวเลข ค่าใช้จ่ายต่อชั่วโมงขณะที่ยานพาหนะเคลื่อนที่
endLocation ออบเจ็กต์ (LatLng) ตำแหน่งปลายทางทางภูมิศาสตร์เป็นพิกัดละติจูด/ลองจิจูด
endTags[] อาร์เรย์ของสตริง แท็กที่กำหนดสถานะสิ้นสุดของยานพาหนะ ซึ่งใช้สำหรับแอตทริบิวต์การเปลี่ยนสถานะ
endTimeWindows[] อาร์เรย์ของออบเจ็กต์ (TimeWindow) ช่วงเวลาที่อนุญาตให้ยานพาหนะสิ้นสุดเส้นทาง
endWaypoint ออบเจ็กต์ (Waypoint) ตำแหน่งสิ้นสุดทางภูมิศาสตร์โดยใช้จุดแวะพัก (พิกัดหรือรหัสสถานที่)
extraVisitDurationForVisitType map (key: string, value: Duration) เพิ่มระยะเวลาพิเศษให้กับการเข้าชมตามvisitType
fixedCost ตัวเลข ต้นทุนคงที่ที่จะเรียกเก็บหากมีการใช้ยานพาหนะ ไม่ว่าเส้นทางจะมีระยะทางหรือระยะเวลานานเท่าใดก็ตาม
ignore บูลีน (true/false) หากเป็น true ระบบจะไม่สนใจยานพาหนะและจะไม่นำไปใช้ในการเพิ่มประสิทธิภาพ
label สตริง ป้ายกำกับที่ผู้ใช้กำหนดสำหรับยานพาหนะ ซึ่งแสดงในคำตอบ
loadLimits map (key: string, value: LoadLimit) ความจุของยานพาหนะ (เช่น น้ำหนักสูงสุด ปริมาตรสูงสุด)
routeDistanceLimit ออบเจ็กต์ (DistanceLimit) ขีดจำกัดแบบเข้มงวดหรือแบบยืดหยุ่นสำหรับระยะทางรวมของเส้นทางยานพาหนะ
routeDurationLimit ออบเจ็กต์ (DurationLimit) ขีดจำกัดแบบเข้มงวดหรือแบบยืดหยุ่นสำหรับระยะเวลาทั้งหมดของเส้นทางยานพาหนะ
routeModifiers ออบเจ็กต์ (RouteModifiers) ข้อจำกัดอย่างน้อย 1 ข้อ เช่น การหลีกเลี่ยงค่าผ่านทาง ทางหลวง หรือเรือข้ามฟาก
startLocation ออบเจ็กต์ (LatLng) ตำแหน่งเริ่มต้นทางภูมิศาสตร์เป็นพิกัดละติจูด/ลองจิจูด
startTags[] อาร์เรย์ของสตริง แท็กที่กำหนดสถานะเริ่มต้นของยานพาหนะ ซึ่งใช้สำหรับแอตทริบิวต์การเปลี่ยนสถานะ
startTimeWindows[] อาร์เรย์ของออบเจ็กต์ (TimeWindow) ช่วงเวลาที่อนุญาตให้ยานพาหนะเริ่มเส้นทาง
startWaypoint ออบเจ็กต์ (Waypoint) ตำแหน่งเริ่มต้นทางภูมิศาสตร์โดยใช้จุดแวะพัก (พิกัดหรือรหัสสถานที่)
travelDurationLimit ออบเจ็กต์ (DurationLimit) ขีดจำกัดแบบเข้มงวดหรือแบบยืดหยุ่นสำหรับระยะเวลาการเดินทางทั้งหมด (ไม่รวมเวลารอ/เวลาให้บริการ) ของยานพาหนะ
travelDurationMultiple ตัวเลข ใช้ตัวคูณกับเวลาเดินทาง (เช่น 1.5 ทำให้การเดินทางช้าลง 50%)
travelMode enum (TravelMode) รูปแบบการเดินทาง (เช่น DRIVING, WALKING) ส่งผลต่อเวลาและระยะทางการเดินทาง
unloadingPolicy enum (UnloadingPolicy) กำหนดลำดับการขนถ่าย (เช่น LIFO หรือ LAST_IN_FIRST_OUT)
usedIfRouteIsEmpty บูลีน (true/false) หากtrue ระบบจะถือว่ามีการใช้ยานพาหนะแม้ว่าจะไม่มีการจัดส่งก็ตาม โดยมีต้นทุนคงที่และเดินทางระหว่างสถานที่เริ่มต้นและสถานที่สิ้นสุด

เนื้อหาการตอบกลับ

โครงสร้างข้อมูลของเนื้อหาการตอบกลับ

เนื้อหาการตอบกลับประกอบด้วยองค์ประกอบต่อไปนี้ ซึ่งแสดงใน ไดอะแกรมทางด้านขวาและแสดงรายการในตารางด้านล่าง

  • OptimizeToursResponse: ออบเจ็กต์การตอบกลับระดับบนสุด ที่มีเส้นทางและเมตริกที่เพิ่มประสิทธิภาพแล้ว
    • Metrics: สถิติค่าใช้จ่ายและการดำเนินการโดยรวมสำหรับ โซลูชัน
    • ShipmentRoute: ลำดับการเข้าชมและเส้นทางการเดินทาง ที่กำหนดให้กับยานพาหนะคันเดียว
      • Visit: จุดแวะพักในเส้นทางเพื่อรับหรือนำส่ง
      • Transition: เส้นทางการเดินทางและระยะเวลาระหว่างป้ายหยุดรถ 2 ป้าย ในเส้นทาง
      • AggregatedMetrics: ผลรวมของระยะเวลา ระยะทาง และ เมตริกอื่นๆ องค์ประกอบนี้อาจอยู่ในทั้ง Metrics และ ShipmentRoute
ผู้ปกครอง พารามิเตอร์ ประเภทที่พัก คำอธิบาย
OptimizeToursResponse metrics ออบเจ็กต์ (Metrics) เมตริกแบบรวมสำหรับโซลูชัน ซึ่งรวมถึงต้นทุนรวม ระยะทางรวม ระยะเวลารวม และจำนวนการใช้งานยานพาหนะ
requestLabel สตริง ป้ายกำกับที่คัดลอกจากฟิลด์ label ของคำขอ ใช้เพื่อเชื่อมโยงการตอบกลับกับคำขอเดิม
routes[] อาร์เรย์ของออบเจ็กต์ (ShipmentRoute) รายการเส้นทางที่คำนวณสำหรับยานพาหนะแต่ละคัน ประกอบด้วยรายการสำหรับยานพาหนะทุกคัน ไม่ว่าจะมีการใช้งานหรือไม่ก็ตาม
skippedShipments[] อาร์เรย์ของออบเจ็กต์ (SkippedShipment) รายการการจัดส่งที่ข้ามไป (ไม่ได้ให้บริการ) พร้อมเหตุผลที่ข้าม
validationErrors[] อาร์เรย์ของออบเจ็กต์ (OptimizeToursValidationError) รายการข้อผิดพลาดในการตรวจสอบความถูกต้องที่พบในโมเดลอินพุต ระบบจะป้อนข้อมูลนี้หากตั้งค่า solvingMode เป็น VALIDATE_ONLY หรือหากเกิดข้อผิดพลาดระหว่างการแก้ปัญหา
Metrics
(ส่วนหนึ่งของ OptimizeToursResponse)
aggregatedRouteMetrics ออบเจ็กต์ (AggregatedMetrics) สถิติรวมในทุกเส้นทาง เช่น ระยะทางรวมในการเดินทาง ระยะเวลารวม และเวลารอ
costs map (key: string, value: number) รายละเอียดค่าใช้จ่ายตามประเภท (เช่น "model.vehicles.cost_per_kilometer", "model.shipments.penalty_cost")
earliestVehicleStartTime การประทับเวลา เวลาเริ่มต้นที่เร็วที่สุดในบรรดายานพาหนะทั้งหมดที่ใช้
latestVehicleEndTime การประทับเวลา เวลาสิ้นสุดล่าสุดในบรรดายานพาหนะทั้งหมดที่ใช้
skippedMandatoryShipmentCount จำนวนเต็ม จำนวนการจัดส่งที่จำเป็นซึ่งถูกข้าม
totalCost ตัวเลข ต้นทุนรวมของโซลูชัน โดยรวมต้นทุนเส้นทางทั้งหมดและค่าปรับสำหรับการจัดส่งที่ข้าม
usedVehicleCount จำนวนเต็ม จำนวนยานพาหนะที่ใช้ในโซลูชัน
AggregatedMetrics
(ส่วนหนึ่งของ Metrics และ ShipmentRoute)
breakDuration ระยะเวลา ระยะเวลาพักทั้งหมดที่ใช้ในทุกเส้นทาง
costs map (key: string, value: number) รายละเอียดค่าใช้จ่ายตามประเภท (เช่น "model.vehicles.cost_per_kilometer", "model.shipments.penalty_cost")
delayDuration ระยะเวลา ระยะเวลาความล่าช้ารวมในทุกเส้นทาง
earliestVehicleStartTime การประทับเวลา เวลาเริ่มต้นที่เร็วที่สุดในบรรดายานพาหนะทั้งหมดที่ใช้
latestVehicleEndTime การประทับเวลา เวลาสิ้นสุดล่าสุดในบรรดายานพาหนะทั้งหมดที่ใช้
maxLoads map (key: string, value: VehicleLoad) น้ำหนักบรรทุกสูงสุดที่ยานพาหนะใดก็ตามบรรทุก ณ จุดใดก็ตามในโซลูชัน โดยมีคีย์เป็นประเภทน้ำหนักบรรทุก
performedShipmentCount จำนวนเต็ม จำนวนการจัดส่งทั้งหมดที่ดำเนินการในยานพาหนะทั้งหมด
skippedMandatoryShipmentCount จำนวนเต็ม จำนวนการจัดส่งที่จำเป็นซึ่งถูกข้าม
totalCost ตัวเลข ต้นทุนรวมของโซลูชัน โดยรวมต้นทุนเส้นทางทั้งหมดและค่าปรับสำหรับการจัดส่งที่ข้าม
totalDuration ระยะเวลา ระยะเวลาทั้งหมดของเส้นทางทั้งหมด (การเดินทาง + การรอ + ความล่าช้า + การหยุดพัก + การเยี่ยมชม)
travelDistanceMeters ตัวเลข ระยะทางในการเดินทางทั้งหมดเป็นเมตรในทุกเส้นทาง
travelDuration ระยะเวลา ระยะเวลาการเดินทางทั้งหมดในทุกเส้นทาง
usedVehicleCount จำนวนเต็ม จำนวนยานพาหนะที่ใช้ในโซลูชัน
visitDuration ระยะเวลา ระยะเวลาทั้งหมดที่ใช้ในการเข้าชม (โหลด/เลิกโหลด) ในทุกเส้นทาง
waitDuration ระยะเวลา ระยะเวลารอทั้งหมดในทุกเส้นทาง
ShipmentRoute
(ส่วนหนึ่งของ OptimizeToursResponse)
breaks[] อาร์เรย์ของออบเจ็กต์ (Break) รายการช่วงพักที่ยานพาหนะใช้ระหว่างเส้นทาง
hasTrafficInfeasibilities บูลีน (true/false) ระบุว่าเส้นทางมีปัญหาที่เกี่ยวข้องกับการจราจรหรือไม่
metrics ออบเจ็กต์ (AggregatedMetrics) เมตริกที่เฉพาะเจาะจงสำหรับเส้นทางนี้ เช่น ระยะทางรวมและระยะเวลาที่ใช้ในการเดินทาง
routeCosts map (key: string, value: number) รายละเอียดค่าใช้จ่ายสำหรับเส้นทางนี้ คีย์คือประเภทต้นทุน (เช่น "cost_per_hour") และค่าคือจำนวนเงิน
routePolyline ออบเจ็กต์ (EncodedPolyline) เส้นประกอบที่เข้ารหัสซึ่งแสดงเส้นทางทั้งหมดของเส้นทางทางภูมิศาสตร์
routeTotalCost ตัวเลข ต้นทุนรวมของเส้นทาง ซึ่งเป็นผลรวมของต้นทุนทั้งหมดในแผนที่ routeCosts
transitions[] อาร์เรย์ของออบเจ็กต์ (Transition) รายการการเปลี่ยนเส้นทาง (ช่วงการเดินทาง) ที่เชื่อมต่อการเข้าชม
vehicleEndTime การประทับเวลา เวลาที่ยานพาหนะสิ้นสุดเส้นทาง
vehicleIndex จำนวนเต็ม ดัชนีของยานพาหนะในแหล่งที่มา ShipmentModel ที่ดำเนินการเส้นทางนี้
vehicleLabel สตริง ป้ายกำกับที่ผู้ใช้กำหนดของยานพาหนะ ซึ่งคัดลอกจากโมเดลคำขอ
vehicleStartTime การประทับเวลา เวลาที่ยานพาหนะเริ่มเส้นทาง
visits[] อาร์เรย์ของออบเจ็กต์ (Visit) ลำดับการเข้าชม (การรับและการนำส่ง) ที่ยานพาหนะดำเนินการในเส้นทางนี้
Visit
(ส่วนหนึ่งของ ShipmentRoute)
detour ระยะเวลา เวลาอ้อมเพิ่มเติมที่เกิดจากการเข้าชมนี้เมื่อเทียบกับเส้นทางโดยตรงระหว่างการเข้าชมครั้งก่อนหน้าและการเข้าชมครั้งถัดไป
isPickup บูลีน (true/false) หากเป็น true แสดงว่าการเข้าชมนี้เป็นการรับสินค้า หากเป็นเท็จ แสดงว่าเป็นการนำส่ง
loadDemands map (key: string, value: Load) ความต้องการในการโหลดที่การเข้าชมนี้ตอบสนอง (เช่น -1 สำหรับการนำส่ง) นี่คือสำเนาของVisitRequestที่เกี่ยวข้อง
shipmentIndex จำนวนเต็ม ดัชนีของฟิลด์ Shipment ในโมเดลแหล่งที่มาที่การเข้าชมนี้ให้บริการ
shipmentLabel สตริง ป้ายกำกับการจัดส่งที่คัดลอกมาจาก ShipmentModel
startTime การประทับเวลา เวลาที่กำหนดให้การเข้าชมเริ่มต้น
visitLabel สตริง ป้ายกำกับของคำขอเข้าชมที่คัดลอกจาก VisitRequest ในโมเดล
visitRequestIndex จำนวนเต็ม ดัชนีของ VisitRequest ในรายการการรับหรือนำส่งของการจัดส่งที่การเข้าชมนี้สอดคล้องด้วย
Transition
(ส่วนหนึ่งของ ShipmentRoute)
breakDuration ระยะเวลา ระยะเวลาของช่วงพักที่ใช้ในระหว่างการเปลี่ยนผ่านนี้
delayDuration ระยะเวลา ระยะเวลาการหน่วงเวลาที่เกิดขึ้นระหว่างการเปลี่ยนนี้ (เช่น มาถึงก่อนเวลาและรอช่วงเวลา)
routePolyline ออบเจ็กต์ (EncodedPolyline) เส้นหลายเส้นที่เข้ารหัสซึ่งแสดงเส้นทางการเปลี่ยนผ่านที่เฉพาะเจาะจงนี้
routeToken สตริง โทเค็นแบบทึบแสงที่ส่งไปยัง Google Navigation SDK เพื่อสร้างเส้นทางใหม่ในระหว่างการนำทาง
startTime การประทับเวลา เวลาเริ่มต้นของการเปลี่ยนฉากนี้
totalDuration ระยะเวลา ระยะเวลาทั้งหมดของการเปลี่ยนผ่าน ซึ่งรวมถึงการเดินทาง การรอ การหยุดพัก และความล่าช้า
trafficInfoUnavailable บูลีน (true/false) หาก true แสดงว่าข้อมูลการเข้าชมไม่พร้อมใช้งานสำหรับการเปลี่ยนผ่านนี้
travelDistanceMeters ตัวเลข ระยะทางที่เดินทางในช่วงเปลี่ยนผ่านนี้ หน่วยเป็นเมตร
travelDuration ระยะเวลา ระยะเวลาการเดินทางในช่วงเปลี่ยนผ่านนี้
vehicleLoads map (key: string, value: VehicleLoad) น้ำหนักบรรทุกของยานพาหนะในระหว่างการเปลี่ยนผ่านนี้ โดยระบุตามประเภทน้ำหนักบรรทุก (เช่น "weight")
waitDuration ระยะเวลา ระยะเวลาที่ใช้ในการรอให้การเข้าชมครั้งถัดไปเริ่มต้นได้