대형 차량 경로

대형 차량 경로 설정은 물리적 크기, 무게, 트레일러 수를 지정하여 대형 차량의 차량 경로를 최적화할 수 있는 속성 집합입니다. API는 이러한 속성을 사용하여 제한된 도로, 낮은 다리 또는 중량 제한 경로를 피하는 실행 가능한 경로를 계산합니다.

대형 차량 경로를 사용하면 다음과 같은 대형 차량의 Fleet 물류 문제를 해결할 수 있습니다.

• 도로 위험 회피: 차량이 낮은 높이 제한, 중량 제한 도로, 기타 물리적 위험을 피하도록 경로 계획을 생성합니다.
• 자세한 차량 정보 지정: 정확한 치수, 총중량, 차축 수, 트레일러 구성을 전체 차량 경로 계획에 통합합니다.
• 전체 차량 계획 개선: 모든 할당이 실제 도로 제약 조건을 준수하도록 하면서 전체 트럭 차량에 대한 효율적인 경로 계획을 수립합니다.
• 턴바이턴 내비게이션 사용 설정: 최적화된 차량 경로의 경로 토큰을 생성하고 이를 Navigation SDK에 전달하여 대형 차량별 내비게이션으로 운전자를 안내합니다.

제한사항

시작하기 전에 다음 제한사항과 요구사항을 숙지해야 합니다.

• 지역별 사용 가능 여부: 대형 차량 경로 지정은 미국 본토 48개 주에서만 사용할 수 있습니다.
• 운전자 권고 및 안전: 운전자는 안전하거나 합법적인 경로를 위해 이 API에서 반환된 경로에만 의존해서는 안 됩니다. 경로가 차량에 적합하지 않을 수 있으며, 경로를 따라가면 낮은 다리나 대형 차량이 금지된 도로와 같은 위험에 노출될 수 있습니다.
• 최적 경로: 경우에 따라 API가 이동 제한을 완전히 준수하는 경로를 찾지 못할 수 있습니다. 대신 제한 구역을 통과할 수 있는 '최선의' 경로를 반환합니다.
• 지원되지 않는 기능: 대형 차량 경로 지정은 다음을 지원하지 않습니다.
  • 트럭 통행료
  • 제한 속도
  • 방사성 유해 물질 라우팅
• 결제: 요청이 대형 차량 경로 지정 속성을 구성하는지 여부와 관계없이 모든 optimizeTours 요청에 대해 균일하게 청구됩니다.
• 장거리 경로: 500km 이상의 장거리 트럭 경로에는 단거리 경로보다 더 많은 계산 시간이 필요하며, 경로 데이터의 품질이 낮아질 수 있습니다. 경로 품질을 유지하려면 배송, 차량 시작 위치, 차량 종료 위치 간의 거리를 제한하세요. 긴 경로가 필요한 경우 요청 기한을 늘려 DEADLINE_EXCEEDED 오류가 발생할 가능성을 줄이세요.

속성

대형 차량 라우팅 속성을 사용하려면 실제 크기로 차량을 구성하고 라우팅 모드를 트럭으로 설정해야 합니다.

다음 표에는 대형 차량 경로를 구성하기 위한 최상위 속성이 나열되어 있습니다.

vehicleInfo

vehicleInfo 객체에는 차량의 물리적 사양이 포함됩니다. routeModifiers 속성 내에서 이 객체를 정의합니다. travelMode을 TRUCK로 설정하는 경우 vehicleInfo 객체를 제공해야 합니다.

다음 표에는 vehicleInfo 객체 내에서 사용할 수 있는 속성이 나와 있습니다.

예

이 섹션에서는 두 가지 유형의 예를 다룹니다.

• 대형 차량 라우팅의 구조를 보여주는 코드 샘플
• 기능이 포함된 요청 예시

코드 샘플

다음 예시에서는 대형 차량 경로에 사용되는 속성의 구조를 보여줍니다.

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

다음 단계

• 세부 경로 안내 내비게이션 제공: 각 전환에 대해 반환된 routeToken를 Android 또는 iOS용 Navigation SDK에 전달하는 방법을 알아봅니다.
• 전환 다중선 및 경로 토큰 생성: 전환 다중선 및 경로 토큰에서 populateTransitionPolylines를 사용하여 경로 토큰을 요청하는 방법을 알아봅니다.
• API 참조: optimizeTours 참조에서 전체 필드 목록을 확인하세요.