요청 메시지 작성

경로 최적화 개요에서 간략히 설명한 대로 기본 요청은 필수 항목인 모델, 배송, 차량으로 구성됩니다.

  • 모델ShipmentsVehicles를 모두 포함하여 전체 요청의 설정 및 제약 조건을 캡처합니다.
  • 배송은 수령 및 배송 VisitRequest가 포함된 작업 또는 실제 배송을 나타냅니다. 배송에는 로컬 설정 및 제약조건이 있습니다.
  • 차량은 차량, 운전자 또는 인력을 나타냅니다. 차량에는 제약 조건을 기준으로 지정할 수 있습니다

각 항목의 속성은 인코더-디코더에서 최적화 문제의 일부를 지정할 수 있습니다. 모델 전체 제약 조건이 (배송에 명시된 제약 조건 및 속성) 단일 배송 또는 차량에 해당하는 경우

각 메시지 유형에 대한 전체 문서는 참조 문서를 확인하세요. ShipmentModel (REST, gRPC), Shipment (REST, gRPC)용 및 Vehicle (REST, gRPC) 메시지

숙박 시설 OptimizeToursRequest

최상위 OptimizeToursRequest 메시지(REST, gRPC)에서 일반적으로 사용되는 몇 가지 속성은 다음과 같습니다.

  • searchMode는 조건을 충족하는 첫 번째 솔루션을 반환할지 여부를 나타냅니다. 주어진 제약조건 또는 집합 내에서 최적의 솔루션을 찾습니다. 기한을 연장할 수 있습니다.
  • considerRoadTraffic는 실시간 트래픽의 사용 여부를 결정합니다. 경로 및 도착예정시간 예측에 사용됩니다.
  • populateTransitionPolylines는 다중선과 경로 토큰이 응답에 반환됩니다.

모델 속성

ShipmentModel 메시지 (REST, gRPC)에는 다음이 포함됩니다.

  • globalStartTime은 모든 차량 및 배송의 경로 중 가장 빠른 시작 시간을 나타냅니다. 차량이 첫 전환을 시작할 수 없으며 배송 건을 선택할 수 없습니다.
  • globalEndTime는 모든 차량 및 배송의 경로의 최신 종료 시간을 나타냅니다. 이 시간 전에 모든 할당된 배송 및 전환이 완료되어야 합니다.

배송 속성

Shipment 메시지(REST, gRPC)에서 일반적으로 사용되는 일부 속성은 다음과 같습니다.

  • pickups[]deliveries[]는 배송 상품을 수령하거나 발송할 수 있는 위치를 나타냅니다. pickups[]deliveries[] 속성은 모두 VisitRequest 메시지(REST, gRPC)를 사용합니다.
  • loadDemands는 차량이 배송을 완료하는 데 필요한 로드를 나타냅니다. 차량 해당 load_limits (REST, gRPC) 속성은 차량이 한 번에 수용할 수 있는 하중을 나타냅니다. 부하 수요 및 한도에서 부하에 대해 자세히 알아보세요.
  • penalty_cost: 배송을 건너뛸 경우 발생하는 비용을 나타냅니다. 읽기 비용 모델 매개변수에서 비용에 대해 자세히 알아보세요.

차량 속성

일반적으로 사용되는 Vehicle 메시지 속성 (REST, gRPC) 포함:

  • startLocation는 차량이 경로를 시작해야 하는 위치를 나타냅니다. 이 속성은 선택사항입니다. 지정하지 않으면 차량의 경로가 배송 위치를 확인합니다.
  • endLocation는 차량이 경로를 종료해야 하는 위치를 나타냅니다. 이 속성은 선택사항입니다. 지정하지 않으면 차량의 경로는 마지막으로 할당된 배송의 위치에서 종료됩니다.
  • startTimeWindows[]는 차량이 경로를 시작할 수 있는 시점을 나타냅니다. 이 속성은 선택사항입니다.
  • endTimeWindows[]은 차량이 경로를 시작하고 종료할 수 있는 시간을 나타냅니다. 두 속성 모두 선택사항입니다.
  • loadLimits는 배송에 사용할 수 있는 차량의 용량을 나타냅니다. 자동으로 확장 및 축소할 수 있습니다 부하 수요 및 한도에서 부하 수요 및 한도에 대해 자세히 알아보세요.

JSON 형식의 전체 요청 예는 다음과 같습니다.

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.73881799999999,
              "longitude": -122.4161
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.79581,
              "longitude": -122.4218856
            }
          }
        ]
      }
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.73881799999999,
          "longitude": -122.4161
        },
        "endLocation": {
          "latitude": 37.73881799999999,
          "longitude": -122.4161
        },
        "costPerKilometer": 1.0
      }
    ],
   "globalStartTime": "2024-02-13T00:00:00.000Z",
   "globalEndTime": "2024-02-14T06:00:00.000Z"
  }
}

OptimizeToursBatchOptimizeTours는 모두 다음과 같은 요청 메시지를 소비합니다. 다른 방식으로 작동합니다 경로 최적화 요청을 하기 전에 다음 두 가지 방법의 차이를 이해하는 것이 중요합니다.

OptimizeTours와 BatchOptimizeTours의 비교