Action

An action specifies what needs to be done at or during a specific portion of the route.

Examples of actions:

  • Turn right
  • Board a ferry
  • You have reached your destination

Actions in a section are divided into actions, pre-actions, and post-actions:

  • Pre-actions are performed before the departure of a section.
  • Post-actions are performed after the arrival of a section.
  • Actions are performed between the departure and arrival of a section.

Clients can also request a separated list of turn-by-turn actions between the departure and arrival of a section. These actions additionally contain road information for each maneuver (e.g. street name and/or house number...) in order to support turn-by-turn guidance.

For more information about turn-by-turn actions for the guidance use case, see turn-by-turn guidance.

For more information about actions and returning human-readable instructions, see Instructions use case.

Example

An action may involve turning: ...

"actions": [
  ...
  {
    "action": "turn",
    "direction": "left",
    "duration": 167,
    "offset": 85,
    "severity": "light"
  },
  ...
]
...

A post-action may involve charging an electric vehicle:

...
"postActions": [
  {
    "action": "chargingSetup",
    "duration": 300
  },
  {
    "action": "charging",
    "arrivalCharge": 8.9334,
    "consumablePower": 50.0,
    "duration": 5045,
    "targetCharge": 72.0
  }
],
...

A turn-by-turn action also contains detailed road information:

...
"turnByTurnActions": [
  ...
  {
    "action": "turn",
    "duration": 393,
    ...
    "currentRoad": {
    "name": [
      {
        "value": "Otto-Braun-Straße",
        "language": "de"
      }
    ],
    "number": [
      {
        "value": "B2",
        "language": "de"
      }
    ]
    },
    "nextRoad": {
    "name": [
      {
        "value": "Alexanderstraße",
        "language": "de"
      }
    ],
    "number": [
      {
        "value": "B2",
        "language": "de"
      },
      {
        "value": "B5",
        "language": "de"
      }
    ]
    }
  }
  ...
]
...

results matching ""

    No results matching ""