Waypoints Sequence Extension API Developer's Guide

Picking Up a Passenger along the Journey

To find the order of waypoints between the Berlin Main Station (start) and the Berlin HERE Campus (end) for the fastest route, send the following GET request:

https://wse.cit.api.here.com/2/
/findpickups.json
?mode=fastest;car;traffic:disabled
&start=waypoint0;50.115620,8.631210
&departure=2016-10-14T07:30:00+02:00
&vehicleCost=0.29
&driverCost=20
&maxDetour=60
&restTimes=disabled
&end=waypoint3;50.132540,8.649280
&destination0=waypoint1;50.122540,8.631070;pickup:LOAD2
&destination1=waypoint2;50.128920,8.629830;drop:LOAD2,value:200
&app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
The response to the above request delivers the following high-level elements:
  • Optimal sequence of the selected waypoints for the cost optimized route, numbered from 0 to 3 (sequence)
  • Information about each route segment (interconnection) in between two consecutive waypoints including the distance between them in meters and the estimated time in seconds
  • meta information about the request
{
  "results": [
    {
      "waypoints": [
        {
          "id": "waypoint0",
          "lat": 50.11562,
          "lng": 8.63121,
          "sequence": 0,
          "estimatedArrival": null,
          "estimatedDeparture": "2017-09-06T14:49:09Z",
          "fulfilledConstraints": []
        },
        {
          "id": "waypoint1",
          "lat": 50.12254,
          "lng": 8.63107,
          "sequence": 1,
          "estimatedArrival": "2017-09-06T14:52:09Z",
          "estimatedDeparture": "2017-09-06T14:52:09Z",
          "fulfilledConstraints": [ "pickup:LOAD2,value:200,load:0 (destination0 -> destination1)" ]
        },
        {
          "id": "waypoint2",
          "lat": 50.12892,
          "lng": 8.62983,
          "sequence": 2,
          "estimatedArrival": "2017-09-06T14:53:39Z",
          "estimatedDeparture": "2017-09-06T14:53:39Z",
          "fulfilledConstraints": [  "drop:LOAD2,value:200,load:0 (destination0 -> destination1)" ]
        },
        {
          "id": "waypoint3",
          "lat": 50.13254,
          "lng": 8.64928,
          "sequence": 3,
          "estimatedArrival": "2017-09-06T14:57:23Z",
          "estimatedDeparture": null,
          "fulfilledConstraints": []
        }
      ],
      "distance": "6055",
      "time": "494",
      "interconnections": [
        {
          "fromWaypoint": "waypoint0",
          "toWaypoint": "waypoint1",
          "distance": 1707.0,
          "time": 180.0,
          "rest": 0.0,
          "waiting": 0.0
        },
        {
          "fromWaypoint": "waypoint1",
          "toWaypoint": "waypoint2",
          "distance": 930.0,
          "time": 90.0,
          "rest": 0.0,
          "waiting": 0.0
        },
        {
          "fromWaypoint": "waypoint2",
          "toWaypoint": "waypoint3",
          "distance": 3418.0,
          "time": 224.0,
          "rest": 0.0,
          "waiting": 0.0
        }
      ],
      "description": "Targeted best solution: optimal; without traffic",
      "timeBreakdown": {
        "driving": 494,
        "service": 0,
        "rest": 0,
        "waiting": 0
      }
    }
  ],
  "errors": [],
  "processingTimeDesc": "107ms",
  "responseCode": "200",
  "warnings": null,
  "requestId": null
}