응답 해석

Route Optimization API는 해당하는 위치의 차량에 대한 경로를 반환합니다. 합니다. 배송 상품은 차량에 할당되며 요청 속성에 따라 건너뜁니다.

OptimizeToursResponse 메시지 (REST, gRPC)에는 속성:

  • routes[]은(는) 할당된 배송이 있는 각 차량의 경로입니다. 각 Route에는 개별 경로의 속성을 반영하는 측정항목이 포함됩니다.
  • metrics은(는) 모든 연령대의 전체 응답에 대해 집계된 측정항목입니다 차량 및 경로 계획도에 포함됩니다. 최상위 측정항목에는 모든 경로에서 집계된 값이 포함된 경로별 측정항목

최적화 결과에 따라 일부 속성이 채워지지 않을 수도 있습니다.

  1. skippedShipments[]에는 차량으로 진행되지 않는 배송이 나열됩니다. 지정된 기간 내에 배송할 수 없는 경우 배송을 건너뛸 수 있습니다. 배송 비용이 벌금 비용을 초과하는 경우입니다. 예를 들어 배송의 수령 또는 배송 기간이 timeWindow 차량이 필요한 기간에 방문을 수행할 수 있습니다
  2. validationErrors[]는 요청을 무효화하는 오류를 지정합니다. 요청의 solvingModeVALIDATE_ONLY 일반 DEFAULT_SOLVE 모드에서는 유효성 검사 오류가 발생합니다. 응답 본문 대신 오류 메시지에 표시됩니다. 참고: VALIDATE_ONLY 해결 모드는 여러 오류를 한 번에 보고할 수 있습니다. 요청을 빠르게 디버깅하는 데 유용합니다.

경로 속성

routes[] 항목은 ShipmentRoute 메시지 (REST, gRPC)입니다. 각 ShipmentRoute은 출발한 특정 차량의 경로 할당을 나타냅니다. 합니다. 상응하는 Vehicle와 관련된 중요한 ShipmentRoute 속성은 다음과 같습니다.

  • vehicleIndex는 상응하는Vehicle 요청 메시지를 전송합니다. REST 응답은 값이 0인 경우 이 속성을 생략합니다.
  • 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은 해당 요청에서 이 방문이 속한 배송의 0 기반 색인입니다.
  • isPickup는 방문이 승차인 경우 true이고, 방문이 승차인 경우 false입니다. 배달. 값이 false인 경우 REST 응답은 이 속성을 생략합니다.
  • visitRequestIndex는 다음 항목의 VisitRequest의 0부터 시작하는 색인입니다. 해당하는 요청에서 Shipment.pickups 또는 Shipment.deliveries Visit를 나타냅니다. REST 응답은 값은 0입니다.
  • startTime은 방문이 시작될 것으로 예상되는 시간입니다.
  • loadDemandsVisit입니다. 게재 방문수의 로드 금액이 음수입니다. 이는 부하를 나타냅니다. 차량에서 제거됩니다.

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"
        },
        ...
      ],
      ...
    }
  ],
  ...
}

viststransitions의 관계는 다음에 설명되어 있습니다. 수령 및 배송 중지 주문 최적화ShipmentRoute 참조 문서 (REST, gRPC)

측정항목 속성

Metrics 메시지 (REST, gRPC)는 전체 솔루션을 요약합니다. 몇 가지 중요한 Metrics 속성은 다음과 같습니다.

  • totalCost은(는) 경로를 완료하는 데 발생한 총 비용입니다. 자세히 알아보기 비용 모델 매개변수의 비용 정보
  • usedVehicleCount는 솔루션에 사용되는 총 차량 수입니다. 옵티마이저가 차량의 용도를 판단할 때 차량에 빈 경로가 있을 수 있습니다. 필요하지 않습니다.
  • skippedMandatoryShipmentCount는 건너뛴 배송의 수입니다. '필수'입니다. 필수 배송에서 다음과 같은 penaltyCost를 지정하지 않았습니다. 배송을 건너뛰는 경우 발생합니다. 필수 배송은 여전히 지정된 제약조건에서 성능이 실현될 수 없는 경우 건너뜁니다. 비용 모델 매개변수에서 비용에 대해 자세히 알아보세요.

추가 측정항목은 AggregatedMetrics 메시지 (REST, gRPC)를 사용합니다. AggregatedMetrics 메시지 유형은 다음에 사용됩니다. Metrics.aggregatedRouteMetrics 속성 및 ShipmentRoute.metrics Metrics.aggregatedRouteMetrics 속성에는 OptimizeToursResponseShipmentRoute ShipmentRoute.metrics마다 속성에는 해당 ShipmentRoute에 대한 측정항목이 포함됩니다.

중요한 AggregatedMetrics 속성은 다음과 같습니다.

  • performedShipmentCount는 차량이 수행한 배송 수입니다. 학습합니다.
  • travelDuration는 차량이 경로를 완료하는 동안 이동하는 데 소비한 총 시간입니다.
  • waitDuration은 차량이 완료하는 동안 대기한 총 시간입니다. 학습합니다.
  • delayDuration은 차량의 총 지연 시간입니다. 일반적으로 요청에 TransitionAttributes가 사용되지 않으면 0을 반환합니다.
  • breakDuration은(는) 휴식 시간 동안 차량이 보낸 총 시간입니다. 갈 수 있습니다.
  • visitDuration는 차량이 경로를 완료하는 동안 방문을 실행하는 데 소비한 총 시간입니다. 이는 관련 차량에 할당된 Visit에 해당하는 VisitRequest의 모든 VisitRequest.duration 값의 합계입니다.
  • 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
    }
  }
}

전체 예시

요청 구성의 요청에 대한 전체 응답 예는 다음과 같습니다. 예를 들면 다음과 같습니다.

{
  "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
    }
  }
}