Routing API Developer's Guide

Enabling a Truck Route Violating a Restriction

A position derived from a postal code or a city is imprecise and may be located in the area forbidden for a given truck. To calculate a truck route using imprecise positions, like an approximate city-to-city route, use the calculateroute service specifying the truck restriction penalty type soft (truckRestrictionPenalty=soft). Note that the soft penalty requires the route notes to be enabled in the response. You also have to specify an app_id and app_code (see Acquiring Credentials).

In the following example we request a route for a truck which is 5 meters high. The truckRestrictionsPenalty is set to soft and notes are enabled both in the routeAttributes and maneuverAttributes. The route ends on a link forbidden for vehicles higher than 4 meters. The returned route for the given truck uses this link. The response includes notes indicating that the route violates the truck restriction.

https://route.cit.api.here.com/routing/7.2/calculateroute.json
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&mode=fastest;truck
&waypoint0=geo!52.534924,13.199499
&waypoint1=geo!52.534614,13.199362
&height=5
&truckRestrictionPenalty=soft
&routeattributes=notes
&maneuverattributes=notes

Example response for route violating truck restriction


<Route>
...
  <Leg>
    ...
    <Maneuver ...>
      ...
      <Note>
        <Type>violation</Type>
        <Code>truckRestriction</Code>
      </Note>
    </Maneuver>
    ...
  </Leg>

  <Note>
    <Type>violation</Type>
    <Code>routingOptionViolated</Code>
    <Text>truckRestriction</Text>
  </Note>
</Route>

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.