ガイドAPIリファレンス
ガイド

多人数乗車車両用レーンの使用方法

allow[hov]パラメーターは、計算に多人数乗車車両 (HOV) レーンを使用できるかどうかを指定します。 HOVレーンまたはカープールレーンは、カープール使用のために確保されています。 車がカープールレーンを使用するには最少人数の乗員が必要です。 パラメーター値のタイプはブール型で、デフォルトではfalseです。

📘

  • このパラメーターは vehicle[hovOccupancy] と併用できません。
  • このパラメーターは vehicle[occupancy] と併用できます。vehicle[occupancy] が設定されている場合、この人数の乗員を許可する HOV レーンのみが許可されます。
  • 違反がある場合はviolatedCarpoolの通知が返されます。

allow[hot]パラメーターは、計算に多人数乗車料金 (HOT) レーンを使用できるかどうかを指定します。 HOTレーンとは、多人数乗車の条件を満たさない車両が料金を支払うことで通過できるHOVレーンのことをいいます。 パラメーター値のタイプはブール型で、デフォルトではfalseです。

📘

  • このパラメーターは vehicle[hovOccupancy] と併用できません。
  • このパラメーターは allow[hov] および vehicle[occupancy] と併用できます。
  • 違反がある場合は violatedCarpool の通知が返されます。
  • 料金は動的な情報であるため、HOTレーンの料金情報は返されません。

違反がある場合は、次のviolatedCarpoolコードを含むnoticeが応答で指定されます。

"notices": [
  {
    "title": "Violated carpool.",
    "code": "violatedCarpool",
    "severity": "critical"
  }
]

通知の詳細については、こちらのトピックを参照してください。

次のコマンドを使用すると、HOV レーンを許可するルートをリクエストできます。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=33.9136720,-118.0991479&'\
'destination=33.9138302,-118.1189846&'\
'transportMode=car&'\
'vehicle[occupancy]=2&'\
'allow[hov]=true&'\
'apiKey=YOUR_API_KEY'
HOVを許可

画像の濃い青色のラインは、HOVレーンを使用するルートを示しています。薄い青色のラインは、比較用のデフォルトのルートを示しています。

次のコマンドを使用すると、HOT レーンを許可するルートをリクエストできます。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=35.376483,-80.847333&'\
'destination=35.4095822,-80.8559814&'\
'transportMode=car&'\
'allow[hot]=true&'\
'apiKey=YOUR_API_KEY'
HOTを許可

画像の濃い青色のラインは、HOTレーンを使用するルートを示しています。薄い青色のラインは、比較用のデフォルトのルートを示しています。