ブログ

Routes API 大型車ルーティングパラメータの使い方と迂回ルート検証

2026.10.14

【重要】試す前の事前準備

大型車ルーティングの各種パラメータやドキュメントは一般公開されていますが、大型車ルーティング機能へのアクセスは事前の申請が必要になりますので、弊社までお問い合せください。
https://www.goga.co.jp/contact/

1. Routes API 大型車ルーティングの基本設定

大型車のルートを計算させるには、従来の乗用車向けリクエストに大型車専用のパラメータを追加します。

必須の基本設定

大型車ルーティングを有効化するには、以下の 4 つの設定がポイントとなります。

travelMode: "TRUCK" を設定します。
routingPreference: "TRAFFIC_AWARE_OPTIMAL" を設定します。
routeModifiers.vehicleInfo: 車両スペック（高さ、重量、幅など）を定義するオブジェクトです。travelMode: "TRUCK" を指定する場合は、この vehicleInfo の記述が必須となります。
X-Goog-FieldMask (リクエストヘッダー): レスポンスに「一部規制無視警告フラグ」を表す routes.travelAdvisory.routeRestrictionsPartiallyIgnored を含めるように設定します。

車両パラメータ（vehicleInfo）の主な仕様

LVR 機能の最大の特徴が、リクエストボディ内の routeModifiers.vehicleInfo オブジェクトです。ここでは、ミリメートル（mm）およびキログラム（kg）単位で車両サイズや重量、積載物の種別を指定します。

totalHeightMm: 車両の最大高さ（mm）
totalWidthMm: 車両の最大幅（mm）
totalLengthMm: 車両とトレーラーを合わせた全長（mm）
totalWeightKg: トレーラーを含む車両総重量（kg）
totalAxleCount: 車両とトレーラーを合わせた総軸数
trailerInfo: トレーラーの情報を保持するオブジェクト配列
hazardousGoodsTypes: 積載している危険物の種類（例: EXPLOSIVES や FLAMMABLE など）

リクエスト JSON の例

{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 35.698865709530644,
        "longitude": 139.77534702074976
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 35.69966183015648,
        "longitude": 139.77075152758528
      }
    }
  },
  "travelMode": "TRUCK",
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL",
  "routeModifiers": {
    "vehicleInfo": {
      "totalHeightMm": 2445,
      "totalWidthMm": 2230,
      "totalLengthMm": 8677,
      "totalWeightKg": 7950,
      "totalAxleCount": 2
    }
  },
  "languageCode": "ja"
}

2. 検証例：大型車の車高規制道路の回避挙動

大型トラックの運行において、高さ制限のあるガード下や歩道橋を回避し、安全なルートを確保することはスムーズな配送に欠かせません。
API のリクエストに totalHeightMm（車高）を設定すると、ルート上にある高さ制限道路を判別し、安全に通過できる迂回路を自動的に選択してくれます。

検証例: 東京秋葉原・明神坂ガード（高さ制限 2.8m）

秋葉原駅の北側にある「明神坂ガード（高さ制限 2.8m）」周辺での挙動を検証してみました。ここは一般的な高架よりもかなり低く設定されているため、大型車両は迂回が必要となるポイントです。
神田松永町から外神田へ向かうルートにて、通常の「ドライブモード（乗用車）」と「トラックモード（大型車）」でどのような違いが出るかを比較しました。

ドライブモード（travelMode: "DRIVE"） [左図]: 高さ制限を受けないため、明神坂ガードを真っ直ぐ通過する最短ルートが返ってきます。
トラックモード（travelMode: "TRUCK"） [右図]: 車高設定により明神坂ガード（2.8m）の通過が不可と判定され、ガードを回避して北側の蔵前橋通り方面へ大きく迂回するルートへ切り替わりました。

※紫色の円で囲んでいる部分が、明神坂ガードがあるポイントになります
lvr