Waypoints Sequence Extension API Developer's Guide


Use the resource findsequence to get a good order of waypoints.


Required Parameters

Parameter Type Description
app_id String Typically, but not guaranteed to be, 20 bytes Base64 URL-safe encoded string used for the authentication of the client application. See Acquiring Credentials.
app_code String Typically, but not guaranteed to be, 20 bytes Base64 URL-safe encoded string used for the authentication of the client application. See Acquiring Credentials.
departure DateTimeString Time when travel is expected to start. Traffic speed and incidents are taken into account when calculating the route. departure is required, if trafficmode:enabled is set or if properties are added to waypoints.
The format is as xsd type xs:datetime
For Example: 2014-11-11T16:52:00+2b02:00, 2014-11-11T16:52:00Z
destinationN Waypoint with ID; lat,lon; constraints... (see WaypointWithIdType) Intermediate destinations, at least one. If no end parameter is provided, one of these values is selected as end of the sequence. Waypoints of destination parameters can have appointment or access hour constraints.

The maximum number of waypoints including the start point and end point is 120 without traffic and 50 with traffic. If the routing mode pedestrian is used, the distance between each two of the waypoints must not be greater than 5km.

The waypoint id can be followed by a semicolon separated list of constraints. Supported constraints:

  • before:destination3 (ordering constraint)
  • acc:mo12:00:00+02:00|mo18:00:00+02:00 (access time frame), in combination with st
  • at:2016-10-14T16:00:00+02:00 (appointment time = exact time to be there), in combination with st
  • st:900 (service time = delay at the way point)

If any if these constraints is used, a departure time must be given.

mode String The routing mode specifies how the route is to be calculated. The parameter must be specified on the following pattern:
In this pattern:
  • type: fastest | shortest
  • transport_mode: car | truck | pedestrian
  • traffic_mode: traffic:enabled | traffic:disabled
The Waypoints Sequence Extension API also supports route feature weightings such as tollRoads, motorways or boatFerrys. Please see the description of the RoutingModeType in HERE Routing API for details. Please note that route weightings are separated by commas, e.g. ...traffic:disabled;tunnel:-2,motorway=-1

The parameter mode is required.

start Waypoint with ID Starting Position of the Journey. For Example: start=52.2,8.1

Optional Parameters

Parameter Type Description
avoidLinks List of Link Ids Links that the route may not cross.
avoidArea List of Bounding Boxes Areas which the route must not cross.
end Waypoint with ID Optional Position to be reached at the end of the journey. This value can be omitted. In this case the journey will end at any of the destinations.
hasTrailer Boolean The value indicates if a truck has a trailer.
height Number Defines the height of the truck in meters.
improveFor String Defines the result parameter to be optimized:
  • time: the total driving time
  • distance: the distance of the journey
The parameter is optional, but recommended. The default setting is time.
jsonCallback String

Specifies the name of a user-defined function used to wrap the JSON response (JSONP).

If a JSON callback is set, the http response status is always "200 OK". In the case of an error onErrors is set to true and the response field errors contains an error description.

length Number Defines the length of the truck in meter.
limitedWeight Number Defines the vehicle's limited weight in tons.
requestId Text Clients may pass in an arbitrary string to trace request processing through the system. The requestId is mirrored in the response of the service.
restTimes Driving and Rest Specification Type Specification of driving and rest times
shippedHazardousGoods List of Strings List of hazardous goods.

For Example: ..&shippedHazardousGoods=flammable,harmfulToWater&..

trailerWeight Number Defines the weight of the vehicle's trailer in tons.
weightPerAxle Number Defines the vehicle's weight per axle in tons.
width Number Defines the width of the truck in meters.
walkSpeed Number Defines the walking speed for pedestrian mode. Default is HLP Router's default walk speed. Allowed values are 0.5 ... 2 meters per second.

Hazardous Goods

FindSequence requests can include the following hazardous goods:
Explosive material
Flammable material
Combustible material
Organic material
Radio-active material
Corrosive material
Materials that are poisonous upon inhalation
Materials that are harmful to water
Other types of hazardous materials

Please see HERE Routing API for a comprehensive list of supported values.

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.