Waypoints Sequence Extension API Developer's Guide

FindSequence

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

.../2/findsequence.json?<parameter1>=<value1>&<parameter2>=<value2>&...

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
[-]CCYY-MM-DDThh:mm:ss[Z|(+|-)hh:mm]
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, several comma separated 'before' destinations are allowed per way point)
  • 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:
mode={type};{transport_mode};{traffic_mode}
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 vehicle weight including trailers and shipped goods, 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&..

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
Explosive material
gas
Gas
flammable
Flammable material
combustible
Combustible material
organic
Organic material
poison
Poison
radioActive
Radio-active material
corrosive
Corrosive material
poisonousInhalation
Materials that are poisonous upon inhalation
harmfulToWater
Materials that are harmful to water
other
Other types of hazardous materials

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