How to do pickup along the route

The HERE Waypoints Sequence API v8 allows you to optimize the cost of your journey by picking up and dropping off passengers and goods along the route. Use the driver_cost (cost per hour) and vehicle_cost (cost per kilometer) parameters to set the detour time/distance in relation to the profit made.

📘

Note

HERE Waypoints Sequence API v8 doesn't include route details in its responses. To request a route, use HERE Routing API v8 and pass the route start/end points and the pickup/drop-off waypoints in the order as suggested in the findpickups response.

Requests to the HERE Routing API v8 must include the route travel mode and two consecutive waypoint coordinates from the response from the HERE Waypoints Sequence API v8. The response from the HERE Waypoints Sequence API v8 provides this information in the estimatedDeparture element.

Time window constraints define opening hours or deadlines for product delivery points or appointments specific to each waypoint. Successful responses contain an optimized waypoint sequence that observes all the time constraints specified in the request in the parameter waypointN. Where this isn't possible, the service generates a response without a way point sequence, but hints at conflicting or problematic constraints or waypoints. You must then resubmit the request with relaxed or modified constraints or waypoints. For an example, see Waypoints sequence optimized with time constraints.

Pickup and drop off names define an implicit partial order between pairs of waypoints which is strictly obeyed.

Service time is specific to each waypoint and defines the amount of time to be spent at the waypoint. In other words, it indicates the length of time between arrival at the waypoint and departure from it, for example to complete the delivery of goods. Service times are taken into account in the optimized waypoint sequence.

The HERE Waypoints Sequence API v8 may take several minutes to calculate a response depending on the parameters specified. Specifically, this calculation time depends on the following:

• Whether traffic mode (mode=...;traffic:enabled) is enabled
• Number of waypoints
• Distances between the individual waypoints
• Whether car or truck mode is used (mode=car; or mode=truck;...)

The timeout after which the network connection is closed is set to 300 seconds on the HERE Waypoints Sequence API v8 systems.