Scooter routing

The scooter transport mode is designed to calculate routes for two-wheeled vehicles, ranging from low-powered ones such as electric scooters or gas-powered scooters, to motorcycles. To calculate a route for a scooter, set the transportMode=scooter parameter in your route calculation request. In this mode, the API uses only the roads open for motorcycles. Only the fast routing mode is supported.

📘

Note

Dedicated scooter lanes aren't supported.

By default, this transport mode is set up to work best with low-powered vehicles used for intra-city transportation:

• Speed cap is set to 60 km/h.
• Routes avoid highways.

When using this mode for motorcycles, it's recommended to override the default speed cap and allow the vehicle on highways.

Override speed cap

To override the default speed cap for scooters, use the vehicle[speedCap] parameter. Provide the desired maximum speed in meters per second. For example, using vehicle[speedCap]=20.0 in your request limits the speed to 72 km/h. Using this parameter affects the route selection as well as the route ETA.

Allow on highways

By default, scooters aren't allowed on highways. This is equivalent to setting the avoid[features]=controlledAccessHighway parameter in other transport modes. To override this behavior, add the scooter[allowHighway]=true parameter to your request.

Highway can't be avoided

If highways can't be avoided, the Routing API tries to minimize the usage of highways and includes a notice in the response.

In this request, the origin waypoint is on a highway, and thus highways can't be completely avoided:

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'

The response contains the notice code violatedAvoidControlledAccessHighway:

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

Difference in calculated route

Taking the request from the preceding section as an example of how the API handles route calculation with the default behavior, compare it to the following request which allows highways for scooter routing:

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'

The image shows the two routes. The route marked with blue allows highways and stays on one until it's close to the destination. Note, that the speed cap is set to 45 m/s (162 km/h) to allow the vehicle to reach appropriate speeds. The route marked with purple leaves the highway as soon as possible due to highway avoidance, which is the default behavior of the scooter transport mode.