大型車両のルート

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

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

  • 道路の危険を回避する: 車両を低い高架下、重量制限のある道路、その他の物理的な危険から遠ざけるルートプランを生成します。
  • 車両の詳細情報を指定する: 正確な寸法、総重量、車軸数、トレーラーの構成をフリート全体のルートプランに組み込みます。
  • フリート全体の計画を改善する: すべての割り当てが物理的な道路の制約に準拠していることを確認しながら、トラック フリート全体で効率的なルート計画を構築します。
  • ターンバイターンのナビゲーションを有効にする: 最適化されたフリート ルートのルートトークンを生成し、Navigation SDK に渡して、大型車両専用のナビゲーションでドライバーを案内します。

制限事項

始める前に、次の制限事項と要件を把握しておく必要があります。

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

プロパティ

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

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

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

vehicleInfo

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

次の表に、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
      }
    ]
  }
}

次のステップ

  • ターンバイターン ナビゲーションを提供する: 各トランジションで返される routeToken を Navigation SDK for Android または iOS に渡す方法について説明します。
  • トランジション ポリラインとルートトークンを生成する: トランジション ポリラインとルートトークンで populateTransitionPolylines を使用してルートトークンをリクエストする方法について学習します。
  • API リファレンス: optimizeTours リファレンスでフィールドの完全なリストを表示します。