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

スクーターのルート検索

scooter移動モードは、電動スクーターやガス駆動スクーターなどの低出力車両からオートバイまで、二輪車のルートを計算するように設計されています。 スクーターのルートを計算するには、ルート計算リクエストでtransportMode=scooterパラメーターを設定します。 このモードでは、APIはオートバイが走行可能な道路のみを使用します。 fastルーティングモードのみがサポートされます。

📘

専用のスクーターレーンはサポートされていません。

デフォルトでは、この移動モードは都市内の交通機関に使用される低出力車両に合わせて最適に動作するように設定されています。

  • 速度上限は60 km/hに設定されています。
  • ルートは高速道路を回避します。

オートバイでこのモードを使用する場合は、デフォルトの速度上限を上書きして、高速道路を走行できるようにすることをお勧めします。

速度上限を上書きする

スクーターのデフォルトの速度上限を上書きするには、vehicle[speedCap]パラメーターを使用します。目的の最大速度をメートル/秒で指定します。 たとえば、リクエストでvehicle[speedCap]=20.0を使用すると、速度は72 km/hに制限されます。 このパラメーターを使用すると、ルートの選択だけでなく、ルートの到達予測時刻にも影響します。

高速道路での走行を許可する

デフォルトでは、スクーターは高速道路を走行できません。 これは、他の移動モードでavoid[features]=controlledAccessHighwayパラメーターを設定するのと同じです。 この動作を上書きするには、リクエストにscooter[allowHighway]=trueパラメーターを追加します。

高速道路を回避できない場合

高速道路を回避できない場合、Routing APIは高速道路の使用を最小限に抑えようとし、レスポンスに通知を含めます。

このリクエストでは、出発地の経由地は高速道路上にあるため、高速道路を完全に回避することはできません。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=53.338335,14.505925&'\
'destination=53.277864,14.256036&'\
'transportMode=scooter&'\
'apiKey=YOUR_API_KEY'

レスポンスには通知コードviolatedAvoidControlledAccessHighwayが含まれます。

"sections": [
  {
    ...,
    "notices": [
      {
        "title": "Violated avoid controlled-access highway.",
        "code": "violatedAvoidControlledAccessHighway",
        "severity": "critical"
      }
    ]
  }
]

計算されたルートの違い

前のセクションのリクエストを、APIがデフォルトの動作でルート計算を処理する方法の例として取り上げ、それをスクーターのルーティングで高速道路を許可する次のリクエストと比較します。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=53.338335,14.505925&'\
'destination=53.277864,14.256036&'\
'transportMode=scooter&'\
'scooter[allowHighway]=true&'\
'vehicle[speedCap]=45.0&'\
'apiKey=YOUR_API_KEY'

次の図は、2つのルートを示しています。 青で示されたルートは高速道路を利用でき、目的地付近まで高速道路上を走行します。 車両が適切な速度に到達できるよう、速度上限は45 m/s (162 km/h) に設定されていることに注意してください。 紫色で示されたルートは、高速道路回避のため、できるだけ早く高速道路を離れます。これはスクーターの移動モードにおけるデフォルトの動作です。

高速道路での走行が許可されている場合のスクータールートの違い