대형 차량 경로

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

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

  • 도로 위험 방지: 낮은 높이 제한, 무게 제한 도로, 기타 물리적 위험을 피하도록 차량을 안내하는 경로 계획을 생성합니다.
  • 세부 차량 정보 지정: 정확한 크기, 총 무게, 차축 수, 트레일러 구성을 Fleet 전체 경로 계획에 통합합니다.
  • Fleet 전체 계획 개선: 모든 할당이 물리적 도로 제약 조건을 준수하도록 하면서 전체 트럭 Fleet의 효율적인 경로 계획을 수립합니다.

제한사항

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

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

속성

대형 차량 경로 지정 속성을 사용하려면 물리적 크기로 차량을 구성하고 경로 지정 모드를 트럭으로 설정해야 합니다.

다음 표에는 대형 차량 경로 지정을 구성하기 위한 최상위 속성이 나와 있습니다.

속성 유형 요구사항 설명
travelMode 문자열 필수 차량의 이동 모드를 지정합니다. 대형 차량 경로 지정 속성을 사용 설정하려면 이 값을 TRUCK으로 설정합니다.
routeModifiers 객체 필수 vehicleInfo를 비롯한 경로별 구성이 포함되어 있습니다.

vehicleInfo

vehicleInfo 객체에는 차량의 물리적 사양이 포함되어 있습니다. routeModifiers 속성 내에서 이 객체를 정의합니다. vehicleInfo 객체를 제공해야 합니다 if you set travelMode to TRUCK.

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

속성 유형 요구사항 설명
totalHeightMm 정수 필수 차량의 총 높이를 밀리미터 단위로 지정합니다. 이 값은 양의 정수여야 합니다.
totalWidthMm 정수 필수 차량의 총 너비를 밀리미터 단위로 지정합니다. 이 값은 양의 정수여야 합니다.
totalWeightKg 정수 필수 차량의 총 무게를 킬로그램 단위로 지정합니다. 이 값은 양의 정수여야 합니다.
totalLengthMm 정수 필수 차량의 총 길이를 밀리미터 단위로 지정합니다. 이 값은 양의 정수여야 합니다.
trailerInfo 배열 선택사항 각 트레일러의 길이를 밀리미터 단위로 지정하는 lengthMm 속성을 포함하여 트레일러 사양 배열을 포함합니다.
totalAxleCount 정수 필수 차량의 총 차축 수를 지정합니다. 이 값은 2 이상의 정수여야 합니다.

예

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

코드 샘플

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

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