หน้านี้ได้รับการแปลโดย Cloud Translation API

ตีความคำตอบ

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

Route Optimization API จะแสดงเส้นทางสำหรับยานพาหนะในคำขอที่เกี่ยวข้อง ระบบจะกำหนดการจัดส่งให้กับยานพาหนะ หรืออาจข้ามไปก็ได้ ทั้งนี้ขึ้นอยู่กับพร็อพเพอร์ตี้ของคำขอ

OptimizeToursResponseข้อความ (REST, gRPC) มีพร็อพเพอร์ตี้ระดับบนสุดหลัก 2 รายการดังนี้

routes[] คือเส้นทางของยานพาหนะแต่ละคันพร้อมการจัดส่งที่กำหนด แต่ละ Route จะมีเมตริกที่แสดงถึงคุณสมบัติของเส้นทางนั้นๆ
metrics คือเมตริกที่รวบรวมไว้สําหรับการตอบสนองทั้งหมดในยานพาหนะและแผนเส้นทางทั้งหมด เมตริกระดับบนสุดมีพร็อพเพอร์ตี้เดียวกันกับเมตริกต่อเส้นทาง โดยมีค่าที่รวบรวมไว้ในเส้นทางทั้งหมด

ระบบอาจไม่ป้อนข้อมูลพร็อพเพอร์ตี้บางรายการเสมอไป ทั้งนี้ขึ้นอยู่กับผลการเพิ่มประสิทธิภาพ

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

คุณสมบัติของเส้นทาง

แต่ละroutes[]รายการคือShipmentRouteข้อความ (REST, gRPC) แต่ละรายการ ShipmentRouteแสดงการกำหนดเส้นทางสำหรับยานพาหนะหนึ่งๆ จากคำขอ ShipmentRouteพร็อพเพอร์ตี้Vehicleที่สำคัญซึ่งเกี่ยวข้องกับShipmentRouteพร็อพเพอร์ตี้Vehicleที่สอดคล้องกัน ได้แก่

vehicleIndex คือดัชนีที่อิงตาม 0 ของ Vehicle ในข้อความคำขอที่เกี่ยวข้อง การตอบสนอง REST จะละเว้นคุณสมบัตินี้เมื่อค่าเป็นศูนย์
vehicleStartTime คือเวลาที่ยานพาหนะต้องเริ่มเส้นทาง
vehicleEndTime คือเวลาที่คาดว่ายานพาหนะจะสิ้นสุดเส้นทาง

ในคำตอบ routes จะมีลักษณะดังนี้

{
  "routes": [
    {
      "vehicleStartTime": "2024-02-13T00:00:00Z",
      "vehicleEndTime": "2024-02-13T00:38:42Z",
      "visits": [
        ...
      ],
      "transitions": [
        ...
      ],
      "metrics": {
        ...
      },
      ...
    }
  ],
  ...
}

ShipmentRoute แต่ละรายการจะมีรายการสั่งซื้อ visits ที่ยานพาหนะจะต้องดำเนินการให้เสร็จสมบูรณ์ แต่ละ Visit (REST, gRPC) แสดงถึง VisitRequest (REST, gRPC) จากคำขอที่เกี่ยวข้อง คุณสมบัติที่สำคัญของ Visit ได้แก่:

shipmentIndex คือดัชนีฐานศูนย์ของการจัดส่งที่การเยี่ยมชมครั้งนี้เป็นของคำขอที่เกี่ยวข้อง
isPickup เป็นจริงเมื่อการเข้าชมเป็นการรับสินค้า และเป็นเท็จเมื่อการเข้าชมเป็นการนำส่ง การตอบกลับ REST จะละเว้นพร็อพเพอร์ตี้นี้เมื่อค่าเป็นเท็จ
visitRequestIndex คือดัชนีฐานศูนย์ของ VisitRequest จาก Shipment.pickups หรือ Shipment.deliveries ในคำขอที่สอดคล้องกันที่ Visit เป็นตัวแทน การตอบสนอง REST จะละเว้นคุณสมบัตินี้เมื่อค่าเป็นศูนย์
startTime คือเวลาที่คาดว่าจะเริ่มการเข้าชม
loadDemands แมปประเภทการโหลดเพื่อโหลดปริมาณที่ต้องการเพื่อทำให้ Visit เสร็จสมบูรณ์ จำนวนโหลดจะเป็นค่าลบสำหรับการเยี่ยมชมการจัดส่ง ซึ่งแสดงถึงการโหลดที่ถูกเอาออกจากยานพาหนะ

ตัวอย่าง Visit มีลักษณะดังนี้:

{
  "routes": [
    {
      ...
      "visits": [
        {
          "isPickup": true,
          "startTime": "2024-02-13T00:00:00Z",
          "detour": "0s"
        },
        ...
      ],
    },
    ...
  ],
  ...
}

ShipmentRoute แต่ละรายการจะมีรายการที่เรียงลำดับของ transitions ซึ่งแสดงถึง การเดินทางระหว่าง visits สำหรับยานพาหนะที่กำหนด พร็อพเพอร์ตี้ที่สำคัญของTransitionข้อความ (REST, gRPC) มีดังนี้

startTime คือเวลาที่รถจะเริ่มทำการเปลี่ยน
travelDuration คือระยะเวลาที่ยานพาหนะต้องเดินทางเพื่อ เปลี่ยนเลนให้เสร็จสมบูรณ์
travelDistanceMeters คือระยะทางเป็นเมตรที่ยานพาหนะต้อง เดินทางเพื่อทำการเปลี่ยนผ่านให้เสร็จสมบูรณ์
trafficInfoUnavailable จะระบุว่ามีข้อมูลการเข้าชมสำหรับการเปลี่ยนเส้นทางหรือไม่
waitDuration แสดงเวลาที่ไม่ได้ใช้งานซึ่งยานพาหนะใช้ในการรอ ก่อนที่จะเริ่มVisitครั้งถัดไปได้ ซึ่งอาจเกิดขึ้นเนื่องจากstart_timeของVisitต่อไปนี้
totalDuration คือระยะเวลาทั้งหมดของการเปลี่ยนผ่าน ซึ่งรวมถึงเวลาเดินทาง เวลารอ เวลาพัก และเวลาที่ล่าช้า
vehicleLoads แมปประเภทการโหลดกับปริมาณการโหลดที่ยานพาหนะบรรทุกในระหว่างการเปลี่ยนนี้

ตัวอย่าง Transition มีลักษณะดังนี้

{
  "routes": [
    {
      ...
      "transitions": [
        ...
        {
          "travelDuration": "1171s",
          "travelDistanceMeters": 9004,
          "waitDuration": "0s",
          "totalDuration": "1171s",
          "startTime": "2024-02-13T00:00:00Z"
        },
        ...
      ],
      ...
    }
  ],
  ...
}

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับความสัมพันธ์ระหว่าง vists และ transitions โปรดดูที่การเพิ่มประสิทธิภาพคำสั่งซื้อแบบหยุดรับและจัดส่งและเอกสารอ้างอิง ShipmentRoute (REST, gRPC) สำหรับข้อมูลเพิ่มเติมเกี่ยวกับคุณสมบัติ routePolyline และ routeToken ของข้อความ Transition โปรดดูที่โพลีไลน์การเปลี่ยนผ่านและโทเค็นเส้นทาง

พร็อพเพอร์ตี้เมตริก

ข้อความ Metrics (REST, gRPC) สรุปโซลูชันทั้งหมด คุณสมบัติที่สำคัญบางประการของ Metrics ได้แก่:

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

เมตริกเพิ่มเติมจะรายงานเป็นAggregatedMetricsข้อความ (REST, gRPC) ประเภทข้อความ AggregatedMetrics ใช้สำหรับพร็อพเพอร์ตี้ Metrics.aggregatedRouteMetrics และสำหรับพร็อพเพอร์ตี้ ShipmentRoute.metrics พร็อพเพอร์ตี้ Metrics.aggregatedRouteMetrics มีเมตริกที่รวบรวมจาก ShipmentRoute ทั้งหมดใน OptimizeToursResponse พร็อพเพอร์ตี้ ShipmentRoute.metrics แต่ละรายการมีเมตริกสำหรับ ShipmentRoute นั้นๆ

AggregatedMetricsพร็อพเพอร์ตี้ที่สำคัญAggregatedMetricsมีดังนี้

performedShipmentCount คือจำนวนการจัดส่งที่ยานพาหนะดำเนินการ ตลอดเส้นทาง
travelDuration คือเวลารวมที่ยานพาหนะใช้ในการเดินทางขณะ ทำเส้นทางให้เสร็จสมบูรณ์
waitDuration คือเวลารวมที่ยานพาหนะใช้ในการรอขณะที่ทำตามเส้นทาง
delayDuration คือเวลาล่าช้ารวมของยานพาหนะ โดยปกติแล้วค่านี้จะเป็น 0 เว้นแต่จะใช้ TransitionAttributes ในคำขอ
breakDuration คือเวลารวมที่ยานพาหนะใช้ในการหยุดพักขณะ ทำเส้นทางให้เสร็จสมบูรณ์
visitDuration คือระยะเวลาทั้งหมดที่ยานพาหนะใช้ในการเข้าชมขณะ เดินทางตามเส้นทาง ซึ่งก็คือผลรวมของค่า VisitRequest.duration ทั้งหมดสำหรับ VisitRequest ที่สอดคล้องกับ Visit ที่ กำหนดให้กับยานพาหนะที่เกี่ยวข้อง
totalDuration คือระยะเวลาทั้งหมดที่ต้องใช้ในการเดินทางตามเส้นทางของยานพาหนะ
travelDistanceMeters คือระยะทางรวมที่ยานพาหนะเดินทางขณะ ทำตามเส้นทาง
maxLoads จะแมปประเภทการโหลดกับปริมาณการโหลดสูงสุดที่ยานพาหนะ บรรทุกในเส้นทาง

ตัวอย่างข้อความ Metrics มีลักษณะดังนี้

{
  "routes": [
    ...
  ],
  "metrics": {
    "aggregatedRouteMetrics": {
      "performedShipmentCount": 1,
      "travelDuration": "2322s",
      "waitDuration": "0s",
      "delayDuration": "0s",
      "breakDuration": "0s",
      "visitDuration": "0s",
      "totalDuration": "2322s",
      "travelDistanceMeters": 18603
    },
    "usedVehicleCount": 1,
    "earliestVehicleStartTime": "2024-02-13T00:00:00Z",
    "latestVehicleEndTime": "2024-02-13T00:38:42Z",
    "totalCost": 18.603,
    "costs": {
      "model.vehicles.cost_per_kilometer": 18.603
    }
  }
}

สำคัญ: หากต้นทุนทั้งหมดเป็น 0 ในข้อความ Metrics หรือ ShipmentRoute เครื่องมือเพิ่มประสิทธิภาพอาจไม่พบคำสั่งซื้อที่เหมาะสมที่สุดสำหรับการทำ Visit ให้เสร็จสมบูรณ์ ต้องระบุพารามิเตอร์ต้นทุนอย่างน้อย 1 รายการ เช่น Vehicle.costPerKilometer หรือ globalDurationCostPerHour มิฉะนั้นเครื่องมือเพิ่มประสิทธิภาพ อาจแสดงโซลูชันใดก็ได้ที่ตรงตามข้อจำกัดที่ระบุ

ตัวอย่างที่สมบูรณ์

การตอบกลับตัวอย่างที่สมบูรณ์สำหรับคำขอจากสร้างคำขอมีลักษณะดังนี้

{
  "routes": [
    {
      "vehicleStartTime": "2024-02-13T00:00:00Z",
      "vehicleEndTime": "2024-02-13T00:38:42Z",
      "visits": [
        {
          "isPickup": true,
          "startTime": "2024-02-13T00:00:00Z",
          "detour": "0s"
        },
        {
          "startTime": "2024-02-13T00:19:31Z",
          "detour": "0s"
        }
      ],
      "transitions": [
        {
          "travelDuration": "0s",
          "waitDuration": "0s",
          "totalDuration": "0s",
          "startTime": "2024-02-13T00:00:00Z"
        },
        {
          "travelDuration": "1171s",
          "travelDistanceMeters": 9004,
          "waitDuration": "0s",
          "totalDuration": "1171s",
          "startTime": "2024-02-13T00:00:00Z"
        },
        {
          "travelDuration": "1151s",
          "travelDistanceMeters": 9599,
          "waitDuration": "0s",
          "totalDuration": "1151s",
          "startTime": "2024-02-13T00:19:31Z"
        }
      ],
      "metrics": {
        "performedShipmentCount": 1,
        "travelDuration": "2322s",
        "waitDuration": "0s",
        "delayDuration": "0s",
        "breakDuration": "0s",
        "visitDuration": "0s",
        "totalDuration": "2322s",
        "travelDistanceMeters": 18603
      },
      "routeCosts": {
        "model.vehicles.cost_per_kilometer": 18.603
      },
      "routeTotalCost": 18.603
    }
  ],
  "metrics": {
    "aggregatedRouteMetrics": {
      "performedShipmentCount": 1,
      "travelDuration": "2322s",
      "waitDuration": "0s",
      "delayDuration": "0s",
      "breakDuration": "0s",
      "visitDuration": "0s",
      "totalDuration": "2322s",
      "travelDistanceMeters": 18603
    },
    "usedVehicleCount": 1,
    "earliestVehicleStartTime": "2024-02-13T00:00:00Z",
    "latestVehicleEndTime": "2024-02-13T00:38:42Z",
    "totalCost": 18.603,
    "costs": {
      "model.vehicles.cost_per_kilometer": 18.603
    }
  }
}