Specify arrival direction at destination

To influence the direction in which you can reach your destination and calculate a route to a waypoint with a desired course heading, specify the course parameter for the destination in your request.

course accepts an integer value for angle clockwise, where 0 is north and 90 is east. The resulting route will try to take this into account and change the direction of approach at the destination, if possible.

In the sample below, the route below reaches the destination at the HERE office from the east as the destination has the course angle specified asking it to do so. Without this parameter, the route will arrive at the destination from the west.

curl -X GET \
  'https://router.hereapi.com/v8/routes?transportMode=car&origin=52.541132,13.410850&destination=52.531073,13.384948;course=90&return=polyline,summary&apikey={YOUR_API_KEY}'

{
  "routes": [
    {
      "id": "330927a3-83b0-4d6f-bde3-80a8864102d3",
      "sections": [
        {
          "id": "0d47ffca-092c-44cd-9609-b9b42fc6b955",
          "type": "vehicle",
          "departure": {
            "place": {
              "type": "place",
              "location": {
                "lat": 52.54113265313208,
                "lng": 13.410850027576089
              },
              "originalLocation": {
                "lat": 52.54113198257983,
                "lng": 13.410849943757058
              }
            }
          },
          "arrival": {
            "place": {
              "type": "place",
              "location": {
                "lat": 52.53108736127615,
                "lng": 13.384937541559339
              },
              "originalLocation": {
                "lat": 52.531072944402698,
                "lng": 13.384947935119272
              }
            }
          },
          "summary": {
            "duration": 485,
            "length": 3306,
            "baseDuration": 403
          },
          "polyline": "BG6s7mkDkixyZ2GrqCkD3mBoBjNU7GUzKA_JnBzKvCrT_E3XTjDnBnGvCrO_EnaTrEnBnGrJzyB3DrTzK74BjDrO7BvHrJrnB7BnG3N3rBjDnL3D7L_EjS3Inf3I3hB3IvgB_EzP3D3NjS_gCjSrgCrJ_d3D3N_EjSzFjXrEzPrE3SvCrJvR36BvHrY7LnpB3DvMnGjSrEnLnLjS3NnVnLjS3IrO7Q7azP_Y3NnVzU7fnGrJ3DzFjD_EnG3IjD3DvM_OnG7G7GjI_EzF3D3DrTvWnLvMrdjhB3InL7BzKrE7L3DnLvMjcrE_JzPnkBvH_OjIjSnGzP_EvMjIzKjIwCnG8GvHkIzP8Q7LkNrOkSrEzU7BrJnBnGrEjSvCrJrEnQ7BnGzFzU3InfvHrdvHvbvCrJzF3S_OzyBnB_ErEnQ_Ov0BzF3SzKnkB_E3NnB3D7BrEnB3IrE_OrEzPzFrTrEwC0KsiBsEkNgF4I8BsEoB4DgF4N0KokB0F4SgPw0BsEoQoBgFgP0yB0F4SwCsJwHwbwHsd4Iof0F0U8BoGO4B",
          "transport": {
            "mode": "car"
          }
        }
      ]
    }
  ],
  "response": {
    "time": 524
  }
}