Get guidance

Turn-by-turn guidance allows users to be guided to their destination in a step-by-step approach.

Guidance comprises of verbal and visual components. Verbal components refer to the voice instructions about one or more next maneuvers. Visual components refer to user interface elements supporting the current or next maneuvers, such as direction arrows, current or next street names.

The route sections are broken down into a sequence of guidance-oriented turn-by-turn actions and can be obtained by specifying return=polyline,turnbyturnactions when requesting a route.

curl -X GET \
'https://router.hereapi.com/v8/routes?transportMode=car&origin=52.5308,13.3847&destination=52.5323,13.3789&return=polyline,turnbyturnactions&apikey={YOUR_API_KEY}'

{
  "routes": [
    {
      "id": "a514bfa3-e97c-407b-aa13-615a9e4244c3",
      "sections": [
        {
          "id": "d71cc8f3-76a1-4ad0-a67f-56895aecc187",
          "type": "vehicle",
          "turnByTurnActions": [
            {
              "action": "depart",
              "duration": 24,
              "length": 113,
              "offset": 0,
              "nextRoad": {
                "name": [
                  {
                    "value": "Invalidenstraße",
                    "language": "de"
                  }
                ]
              }
            },
            {
              "action": "turn",
              "duration": 53,
              "length": 321,
              "offset": 4,
              "direction": "right",
              "severity": "quite",
              "currentRoad": {
                "name": [
                  {
                    "value": "Invalidenstraße",
                    "language": "de"
                  }
                ]
              },
              "nextRoad": {
                "name": [
                  {
                    "value": "Chausseestraße",
                    "language": "de"
                  }
                ]
              }
            },
            {
              "action": "turn",
              "duration": 15,
              "length": 105,
              "offset": 18,
              "direction": "left",
              "severity": "quite",
              "currentRoad": {
                "name": [
                  {
                    "value": "Chausseestraße",
                    "language": "de"
                  }
                ]
              },
              "nextRoad": {
                "name": [
                  {
                    "value": "Habersaathstraße",
                    "language": "de"
                  }
                ]
              }
            },
            {
              "action": "arrive",
              "duration": 0,
              "length": 0,
              "offset": 21,
              "currentRoad": {
                "name": [
                  {
                    "value": "Habersaathstraße",
                    "language": "de"
                  }
                ]
              }
            }
          ],
          "departure": {
            "time": "2020-09-11T13:29:22+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5309837,
                "lng": 13.384567
              },
              "originalLocation": {
                "lat": 52.5307999,
                "lng": 13.3847
              }
            }
          },
          "arrival": {
            "time": "2020-09-11T13:30:54+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5323264,
                "lng": 13.378874
              },
              "originalLocation": {
                "lat": 52.5323,
                "lng": 13.3789
              }
            }
          },
          "polyline": "BGwynmkDu39wZvBtF3InfvHrdvHvboGzF0FnGoGvHsOvR8L3NkSnVoGjIsEzFgFvHkDrJwHrJwHrJ4NjS0ezoBjInV3N_iBzJ_Z",
          "transport": {
            "mode": "car"
          }
        }
      ]
    }
  ]
}

• For a detailed explanation of severity and other notices, see Notice.
• For information about duration and its types, see Duration.