大型車両のルート

大型車両のルート設定は、物理的な寸法、重量、トレーラーの数を指定して、大型車両のフリート ルートを最適化できる一連のプロパティです。この API は、これらの属性を使用して、通行禁止の道路、低い橋、重量制限のあるルートを避けた実現可能な経路を計算します。

大型車両のルート設定を使用すると、次のような大型車両のフリート ロジスティクスに関する課題を解決できます。

  • 道路の危険を回避する: 車両が低い高架下、重量制限のある道路、その他の物理的な危険を避けるルートプランを生成します。
  • 車両の詳細情報を指定する: 正確な寸法、総重量、車軸数、トレーラーの構成をフリート全体のルートプランに組み込みます。
  • フリート全体の計画を改善する: トラック フリート全体の効率的なルートプランを作成し、すべての割り当てが道路の物理的な制約に準拠するようにします。

制限事項

始める前に、次の制限事項と要件を確認してください。

  • 利用可能な地域: 大型車両のルート設定は、 米国本土 48 州 でのみご利用いただけます。
  • ドライバーへのアドバイスと安全性: ドライバーは、この API から返されたルート のみに頼って安全や合法性を確保することはできません。ルートが車両に適しているとは限りません。ルートに従うと、低い橋や大型車両が通行禁止の道路などの危険にさらされる可能性があります。
  • ベストエフォート型のルート: 旅行の制限に 完全に準拠したルートを API が見つけられない場合があります。その場合、通行禁止区域を通過する可能性のある「ベストエフォート」ルートが返されます。
  • サポートされていない機能: 大型車両のルート設定では、次の機能はサポートされていません:
    • トラックの通行料金
    • 制限速度
    • 放射性有害物質のルート設定
  • 請求: リクエストで大型車両のルート設定プロパティが構成されているかどうかに関係なく、Google はすべての optimizeTours リクエストに対して一律に請求します。
  • 長距離ルート: 500 km 以上の長距離トラック ルートでは、短いルートよりも計算時間が長くなり、ルートデータの品質が低下する可能性があります。ルートの品質を維持するには、配送、車両の出発地、車両の到着地の間の距離を制限します。長いルートが必要な場合は、リクエストの期限を延長して DEADLINE_EXCEEDED エラーが発生する可能性を減らしてください。

プロパティ

大型車両のルート設定プロパティを使用するには、物理的な寸法で車両を構成し、ルート設定モードをトラックに設定する必要があります。

次の表に、大型車両のルート設定を構成するための最上位のプロパティを示します。

プロパティ タイプ 要件 説明
travelMode 文字列 必須 車両の移動モードを指定します。大型車両のルート設定プロパティを有効にするには、この値を TRUCK に設定します。
routeModifiers オブジェクト 必須 vehicleInfo など、ルート固有の構成が含まれます。

vehicleInfo

vehicleInfo オブジェクトには、 車両の物理的な仕様が含まれます。このオブジェクトは、routeModifiers プロパティ内で定義します。 vehicleInfo オブジェクトを指定する必要があります。 travelMode を TRUCK に設定する場合

次の表に、vehicleInfo オブジェクトで使用可能なプロパティを示します。

プロパティ タイプ 要件 説明
totalHeightMm integer 必須 車両の全高をミリメートル単位で指定します。この値は正の整数である必要があります。
totalWidthMm integer 必須 車両の全幅をミリメートル単位で指定します。この値は正の整数である必要があります。
totalWeightKg integer 必須 車両の総重量をキログラム単位で指定します。この値は正の整数である必要があります。
totalLengthMm integer 必須 車両の全長をミリメートル単位で指定します。この値は正の整数である必要があります。
trailerInfo 配列 省略可 トレーラーの仕様の配列が含まれます。これには、各トレーラーの長さをミリメートル単位で指定する lengthMm プロパティが含まれます。
totalAxleCount integer 必須 車両の車軸の総数を指定します。この値は 2 以上の整数である必要があります。

例

このセクションでは、次の 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
      }
    ]
  }
}