Waypoints Sequence Extension API Developer's Guide

WaypointWithIdType

WaypointWithIdType specifies WGS-84-compliant coordinates with an optional alphanumerical ID starting with an alphabetic character: [A-Za-z][a-zA-Z0-9].*;latitude,longitude or latitude,longitude.

Properties

The WaypointWithIdType can be extended with additional properties for intermediate destinations, for example to indicate constraints. Properties are delimited by semicolons: [A-Za-z][a-zA-Z0-9].*;latitude,longitude;PROP1;PROP2;

The type supports the properties described in the following table:

Table 1. Properties of WaypointWithIdType
Name Meaning Description
st service time Defines the time to be spent at the waypoint in seconds, for example, st:600 indicates 10 minutes.
at appointment YDefines a fixed appointment at a waypoint. Appointments require a start time and a service time. The start time must be given in the xs:datetime format:
[-]CCYY-MM-DDThh:mm:ss[Z|(+|-)hh:mm]
Hours (hh) must be specified as integer values in the range 0..23. Minutes and seconds must be in the range 0..59.

Aappointment constraints require a service time, which is the duration of the appointment, for example at:2013-07-04T17:00:00+02:00;st:1800

acc access hours Defines access hours for a waypoint with the service time needed at that waypoint. The value consists of two timestamps with day, time and time zone information in the format:
acc:DDhh:mm:ss[Z|(+|-)hh:mm]|DDhh:mm:ss[Z|(+|-)hh:mm]
For access hours days (DD) are abbreviated with two lowercase characters: mo for Monday, tu for Tuesdainy, we, th, fr, sa, su. Hours (hh) must integer values in the range 0..23. Minutes and seconds must be from the range 0..59.

The first time stamp defines the beginning of the access hours, the second time stamp defines the end of the access hours. The access hours constraints require a service time, which is the length time (to be spent) at the waypoint, for example acc:mo09:30:00+01:00|12:00:00+01:00;st:600

before partial sequence order Defines that this way point must be reached before the specified one. The value is destination directly followed by the waypoint sequence number.

Examples

To specify only a set of geographic coordinates using WGS-84-compliant latitude and longitude values, use:
destination3=53.5296,9.97
To specify an ID for the coordinates for tracking or other purposes, specify an alphanumeric value and a semicolon (;) before the geocoordinates:
destination3=HamburgerHafen;53.5296,9.97
The response includes any values you specify in this case.
To capture "A 10-minute task at Frankfurt airport every Monday morning", use:
destination1=FrankfurtAirport;50.050639,8.569641;
      acc:mo07:30:00+00:00|11:00:00Z;st:600  
To capture "Be for 1h at Frankfurt airport from noon, May 1st, 2015", use:
destination2=FrankfurtAirport;50.050639,8.569641;
      at:2015-05-01T12:00:00+01:00;st:3600    
To specify that waypoint 7 must be reached before way point 3, use:
destination7=FrankfurtAirport;50.050639,8.569641;
      before:waypoint3;st:0

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.