ガイドAPIリファレンス
ガイド
  1. HERE Routing API V8 - 開発者ガイド
  2. 制限と規制

車両属性

車両属性は、ルートを計算する車両の物理的特性、その貨物または車両の法的ステータスに関する詳細情報をRouting APIに提供できるようにするパラメーターのグループです。

車両属性をルート計算リクエストに追加すると、APIは計算されるルートに対する制限をより多くの考慮に入れ、ルートが違反している制限が可能な限り最小限 (理想的には0個) になるようにします。

車両属性の最も一般的なユースケースは、トラックやバンなどの貨物車両のルート計算です。 車両属性を定義することで、APIは車両が重量制限を超える道路を通過しないルートを計算したり、高さ制限を超えるトンネルや幅の制限を超える道路を回避したりできます。

車両属性は、非商用アプリケーションでも使用できます。 車高を定義すると、ルーフラックを装備した車両は低いトンネルや橋を避けることができます。また、乗員数を定義すると、APIはHOV (多人数乗車車両) レーンを使用するルートを計算できます。

使用方法

リクエストに車両属性を追加するには、vehicle[PROPERTY_NAME]グループのパラメーターを使用します。 リクエストに追加するプロパティはそれぞれ独立したパラメーターです。

プロパティの例を次に示します。

  • vehicle[height]
  • vehicle[width]
  • vehicle[length]
  • vehicle[tiresCount]
  • vehicle[weightPerAxle]
📘

注

使用可能なプロパティのリストは定期的に更新されます。現在使用可能なすべてのプロパティについては、「APIリファレンス」を参照してください。

例：車高

次のリクエストは、高さ2.7 mの車のルートを計算します。車高はvehicle[height]=270パラメーターを使用して指定します。 このルートの目的地は高さ制限エリアにあるため、APIは制限違反に関する重大な通知警告を返します。 制限が経由地に適用される場合、その制限違反は回避できません。 この例では、APIが迂回ルートを計算するため、このルート上には他の違反はありません。

リクエスト

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=40.90429,9.100922&'\
'destination=40.9041583,9.1014598&'\
'return=polyline&'\
'spans=notices&'\
'transportMode=car&'\
'vehicle[height]=270&'\
'apiKey=YOUR_API_KEY'

レスポンス

{
  ...,
  "polyline": "BGmmzguC2nvrRpGuFU8GA4I9CqM",
  "spans": [
    {
      "offset": 0,
      "length": 13
    },
    {
      "offset": 1,
      "length": 38,
      "notices": [
        0
      ]
    }
  ],
  "notices": [
    {
      "title": "Violated vehicle restriction.",
      "code": "violatedVehicleRestriction",
      "severity": "critical",
      "details": [
        {
          "type": "restriction",
          "cause": "Route violates vehicle restriction",
          "maxHeight": 250
        }
      ]
    }
  ]
}

例：トレーラーを牽引する

vehicle[trailerCount]=1オプションは、車両がトレーラーを牽引していることを示します。 このオプションをリクエストに追加すると、APIはトレーラーの牽引が許可されていない道路を回避するルートを計算できます。

📘

注

車両がトレーラーを牽引する場合、ほとんどの車両パラメーターは、車両とトレーラーの組み合わせを反映した値を取ります。これは、vehicle[currentWeight]、vehicle[grossWeight]、vehicle[length]やその他の類似パラメーターには、トレーラーの重量と寸法も含めなければならないことを意味します。

現在、Routing APIではトレーラー付き車両に適用される速度制限が無視されています。

以下のリクエストは、車両がトレーラーを牽引しているかどうかに応じて、計算されたルートがどのように変化するかを示しています。 なお、重量と長さのプロパティは、トレーラーの存在を反映するように変更されます。

トレーラーがあるルート

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=41.8669074,14.0680527&'\
'destination=41.8733632,14.0690313&'\
'return=polyline,summary&'\
'transportMode=car&'\
'vehicle[currentWeight]=3500&'\
'vehicle[length]=700&'\
'vehicle[trailerCount]=1&'\
'apiKey=YOUR_API_KEY'
トレーラーを牽引する場合のルート

トレーラーなしのルート

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=41.8669074,14.0680527&'\
'destination=41.8733632,14.0690313&'\
'return=polyline,summary&'\
'transportMode=car&'\
'vehicle[currentWeight]=2000&'\
'vehicle[length]=400&'\
'vehicle[trailerCount]=0&'\
'apiKey=YOUR_API_KEY'
トレーラーなしのルート

ルート計算への影響

車両属性が指定されている場合、APIは制限に違反しないルートを計算できない場合があります。 このような状況では、計算されたルートに重大度criticalの通知が含まれます。

車両パラメーターと地域の規制の特定の組み合わせなど、ある一定の状況下では、違反を回避して合法的なルートを見つけることが困難かつ時間がかかるため、ルーティングアルゴリズムはルート計算を放棄する可能性があります。

関連コンテンツ

25 日前の更新