Fleet Telematics Waypoints Sequence Developer's Guide


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


When using POST, Content-Type must be application/x-www-form-urlencoded and all parameters in the body, excepted for app_id and app_code.

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, 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:
In this pattern:
  • type: fastest | shortest
  • transport_mode: car | truck | pedestrian
  • traffic_mode: traffic:enabled | traffic:disabled
The Fleet Telematics Waypoints Sequence 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&..

tunnelCategory Number Defines the tunnel categories the truck must NOT use. B, C, D or E. A tunnels have no restrictions. E tunnels have most restrictions. If C is defined, the route will use A and B tunnels but not C, D or E.
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.
weightPerAxle Number Defines the vehicle's weight per axle in tons.
width Number Defines the width of the truck in meters.

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.