Car with Clusters on Topology Segments

User Story

The user is looking for the fastest way through a number of destinations located in a residential area. The waypoints located on a road between two junctions shall be kept together.

Request

https://wps.hereapi.com/2/findsequence.json
?apiKey=\{YOUR\_API\_KEY\}
&mode=fastest;car;traffic:disabled;
&start=Start;50.116300,8.628638
&end=End;50.116300,8.628638
&destination1=A;50.117780,8.630247
&destination2=B;50.118227,8.630328
&destination3=C;50.118357,8.630335
&destination4=D;50.117922,8.630277
&destination5=E;50.117841,8.631541
&destination6=F;50.117783,8.632024
&destination7=G;50.117766,8.632335
&clustering=topologySegment

Note: This example uses a HERE API Key to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide.

Response

The service puts the waypoints at a topology segment together in the sequence. This is reflected by the attribute cluster in the waypoints section of the response. Please observe that the waypoint with the id "E" belongs to no cluster. It is the only destination on its topology segment. The interconnection section is shortened in the example response.

{
    "results": [
        {
            "waypoints": [
                {
                    "id": "Start",
                    "lat": 50.1163,
                    "lng": 8.628638,
                    "sequence": 0,
                    "estimatedArrival": null,
                    "estimatedDeparture": null,
                    "fulfilledConstraints": []
                },
                {
                    "id": "C",
                    "lat": 50.118357,
                    "lng": 8.630335,
                    "sequence": 1,
                    "estimatedArrival": null,
                    "estimatedDeparture": null,
                    "fulfilledConstraints": [],
                    "cluster": 0
                },
                {
                    "id": "B",
                    "lat": 50.118227,
                    "lng": 8.630328,
                    "sequence": 2,
                    "estimatedArrival": null,
                    "estimatedDeparture": null,
                    "fulfilledConstraints": [],
                    "cluster": 0
                },
                {
                    "id": "A",
                    "lat": 50.11778,
                    "lng": 8.630247,
                    "sequence": 3,
                    "estimatedArrival": null,
                    "estimatedDeparture": null,
                    "fulfilledConstraints": [],
                    "cluster": 1
                },
                {
                    "id": "D",
                    "lat": 50.117922,
                    "lng": 8.630277,
                    "sequence": 4,
                    "estimatedArrival": null,
                    "estimatedDeparture": null,
                    "fulfilledConstraints": [],
                    "cluster": 1
                },
                {
                    "id": "E",
                    "lat": 50.117841,
                    "lng": 8.631541,
                    "sequence": 5,
                    "estimatedArrival": null,
                    "estimatedDeparture": null,
                    "fulfilledConstraints": []
                },
                {
                    "id": "F",
                    "lat": 50.117783,
                    "lng": 8.632024,
                    "sequence": 6,
                    "estimatedArrival": null,
                    "estimatedDeparture": null,
                    "fulfilledConstraints": [],
                    "cluster": 2
                },
                {
                    "id": "G",
                    "lat": 50.117766,
                    "lng": 8.632335,
                    "sequence": 7,
                    "estimatedArrival": null,
                    "estimatedDeparture": null,
                    "fulfilledConstraints": [],
                    "cluster": 2
                },
                {
                    "id": "End",
                    "lat": 50.1163,
                    "lng": 8.628638,
                    "sequence": 8,
                    "estimatedArrival": "2022-06-01T07:35:24+02:00",
                    "estimatedDeparture": null,
                    "fulfilledConstraints": []
                }
            ],
            "distance": "1876",
            "time": "324",
            "interconnections": [
                {
                    "fromWaypoint": "Start",
                    "toWaypoint": "C",
                    "distance": 536.0,
                    "time": 115.0,
                    "rest": 0.0,
                    "waiting": 0.0
                },
                ...
            ],
            "description": "Targeted best time; without traffic",
            "timeBreakdown":
            {
                "driving": 324,
                "service": 0,
                "rest": 0,
                "waiting": 0
            }
        }
    ],
    "8.1.11s": [],
    "processingTimeDesc": "365ms",
    "responseCode": "200",
    "warnings": null,
    "requestId": null
}

results matching ""

    No results matching ""