開始時のコースの方向と距離を使用したルート

移動中の車両からルート計算がトリガされる場合は、ルートリクエストにコンテキストを追加すると便利です。 移動の方向はそのような状況の 1 つです。 車両が走行中で速度が速いため、要求で origin の course パラメーターと minCourseDistance を指定することで、このパラメーターをコンテキストとして渡すことができます。

courseは、 時計回りにカウントされた角度の整数値を受け入れます。0 は北、90 は東です。 結果として生じるルートは、可能であれば、この方向のルートの見出しを考慮して提供しようとします。

次の例では、 HERE オフィスの近くから出発するルート course の角度がに指定されており origin、西に向かうルートを要求しています。 また、minCourseDistance が指定されており、ジャンクションでの右折を防止している。たとえば、ドライバーが間違った車線に入っている、または急に曲がるなどの理由である。

このパラメータの組み合わせを使用しない場合、ルートは目的地に向かって東に向かうか、ジャンクションで右折します。

curl -X GET \
    'https://router.hereapi.com/v8/routes?origin=52.530705,13.383540;course=270;minCourseDistance=50&transportMode=car&destination=52.531839,13.390363&return=polyline,summary&apikey={YOUR_API_KEY}'

{
  "routes": [
    {
      "id": "590956f5-a13e-4e95-9522-70ae81205388",
      "sections": [
        {
          "id": "121cb5a0-5c04-4fcf-b264-75f8b8865d68",
          "type": "vehicle",
          "departure": {
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5307072,
                "lng": 13.3835383,
                "elv": 0.0
              },
              "originalLocation": {
                "lat": 52.530705,
                "lng": 13.3835399
              }
            }
          },
          "arrival": {
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5318229,
                "lng": 13.3903676,
                "elv": 0.0
              },
              "originalLocation": {
                "lat": 52.531839,
                "lng": 13.390363
              }
            }
          },
          "summary": {
            "duration": 234,
            "length": 1266,
            "baseDuration": 190
          },
          "polyline": "BGmhnmkDk37wZN3BvHvbvCrJzF3S_EnQ_JriBnB_ErEnQ_Ov0BzF3SzKnkB_E3NnB3D7BrEnB3IrE_OrEzPzFrTrEwC0KsiBsEkNgF4I8BsEoB4DgF4N0KokB0F4SgPw0BsEoQoBgFgKsiBgFoQ0F4SwCsJwHwbwHsd4Iof0F0U8BoGsEoQwCsJsEkSoBoG8BsJsE0U8BgK8BoLoB4IoB0KoBoLoBkNwC8a8B0UoB0UoBkNsEgtBkDsdyEwoB",
          "transport": {
            "mode": "car"
          }
        }
      ]
    }
  ]
}

スクリーンショット

次の図は、 2 つのルートを示しています。 紫色のルートは course パラメーターのないルートで、青色のルートは上記の例の結果です。