GuidesAPI Reference
Guides
  1. HERE Routing API v8 Developer Guide
  2. Restrictions and regulations

No-through restrictions

The term "no-through restricted area" refers to an area of the road network where through-traffic is not allowed. A common no-through restriction, a "Residents Only" sign, indicates that select vehicles are only allowed to enter the area if they are making a stop and no vehicles are allowed to use the restricted area as a through road.

HERE Routing API v8 avoids no-through restricted areas unless the origin, destination, or an intermediate waypoint of the request fall in an area with such restriction.

Applicable no-through restrictions change depending on the transport mode and vehicle parameters used in the routing request.

No-through restrictions in API response

In some cases, no-through restriction data in HERE Map Content can be incorrect due to the local and dynamic nature of the subject. For this reason, the Routing API doesn't report violation notices for no-through restrictions. It only reports the existence of the restrictions. The API does, however, avoid routing through areas that would cause violations.

To get no-through restrictions in the API response, add return=noThroughRestrictions to your request. To locate these restrictions on the calculated route, request spans with no-through restrictions by adding spans=noThroughRestrictions to the request.

Routing around no-through restrictions

The following examples show the behavior of the API in an area with a no-through restriction. In the first example, the origin and destination are close to a no-through restricted area, but outside of it. The API avoids the restriction and calculates a route around it.

In the second example, the destination is moved inside the no-through restricted area. As a result, the route doesn't avoid the area and the response contains a noThroughRestriction object with the restriction details.

Example 1: restriction avoided

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.7490018,10.9137729&'\
'destination=52.717981,10.916049&'\
'return=polyline,summary,noThroughRestrictions&'\
'spans=noThroughRestrictions&'\
'transportMode=truck&'\
'vehicle[grossWeight]=8000&'\
'apiKey=YOUR_API_KEY'
{
  "routes": [
    {
      "id": "e93deab8-4c03-4478-938e-4cea1bd533c5",
      "sections": [
        {
          ...,
          "summary": {
            "duration": 485,
            "length": 6450,
            "baseDuration": 463
          },
          "polyline": "BGwgyzkD-mk6U7BqM_E8QvHgUnL4X3XkrBnVsnBjhB46Bv-BsyD34CkoF31BwrD_2GgzNvtCo8EztBo7C7uB44CzvFkmLze46Bj1B4iD_0C07EjmB8sCzUgtBrsBknDnao9BnQwlBrO0jBrO4rBjuC_kFjX3wB_EzK7VvvBjNvb3I7QjInL3I3I3IzFvHvC3I7BjcnBjDArETjDvCvC3DvC7GvCnL7B7L7GrxBvCjS7BvRvC3S7B_JjDvM3DrJvHjN_YnpB_EjInLvWvCnGjDzK3D3S3DnVzKjwBvH3hBvCzK3D3IrEvH_E7B_EnB3InBzFnBrJzFzF7G_J3N7ankB7a7kBjX7fjI7LjI3N_EjN_E_TvCjX3Dn4BnB3NjI_yD7VjqJjDvlBvC_TzFvlB3IvvBnLv0BrOrgC_drmEjSvyCvHriBzoBr4FjIvlBjIriBrErTzFrO7LzU_O3XpDzF",
          "spans": [
            {
              "offset": 0
            }
          ],
          "language": "en-us",
          "transport": {
            "mode": "truck"
          }
        }
      ]
    }
  ]
}
No-through restricted area avoided

Example 2: destination in restricted area

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.7490018,10.9137729&'\
'destination=52.745227,10.918257&'\
'return=polyline,summary,noThroughRestrictions&'\
'spans=noThroughRestrictions&'\
'transportMode=truck&'\
'vehicle[grossWeight]=8000&'\
'apiKey=YOUR_API_KEY'
{
  "routes": [
    {
      "id": "6a116225-0a74-4627-9b19-0da1683c1910",
      "sections": [
        {
          ...,
          "polyline": "BGwgyzkD-mk6U7BqM_E8QvHgUnL4X3XkrBnVsnBjhB46Bl4Eo5B",
          "spans": [
            {
              "offset": 0
            },
            {
              "offset": 7,
              "noThroughRestrictions": [
                0
              ]
            }
          ],
          "language": "en-us",
          "transport": {
            "mode": "truck"
          },
          "noThroughRestrictions": [
            {
              "type": "restriction",
              "maxGrossWeight": 7500,
              "maxWeight": {
                "value": 7500,
                "type": "gross"
              }
            }
          ]
        }
      ]
    }
  ]
}
Route destination in no-through restricted area

No-through restrictions in HERE Map Content

In HERE Map Content, different terminology is used to indicate no-through areas for cars and trucks.

  • Cars: through_traffic=false.
  • Trucks: combination of trucks=false and deliveries=true.

The actual road signs for trucks can use either the "no-through" or "delivery-only" terminology. HERE Map Content doesn't distinguish between these.

HERE Map Content doesn't contain no-through restriction data for vehicles other than cars and trucks. In routing requests for other vehicle types (scooters, motorcycles, buses), no-through restrictions are derived from the available car and truck data.

No-through restrictions in HERE Map Rendering

📘

Note

To get the most accurate information about the restrictions present in the calculated route, always check the response returned by the Routing API.

In HERE Map Rendering, no-through restrictions are visually distinguished by a green cube, which symbolizes a package. The presence of the green package symbol signals that the route is delivery-only - the vehicle can enter it to unload its cargo, but it can't use the road as a through-road to cross an area or a neighborhood.

Related content

Updated 9 days ago