Routing API v7 Developer's Guide

Isoline with Single or Multiple Components

An isoline may consist of several isolated components. This supports use cases where the reachable area is disconnected by ferry links. All islands are returned as separate polygons (components). Ferry links between these polygons are also returned as separate polyline geometries (connections). The range reachable using ferries can be displayed as multiple components (with or without connections) or even as a single component.

Below is an example of the 40km isoline calculated in the center of Split, Croatia.

https://isoline.route.ls.hereapi.com/routing/7.2/calculateisoline.json
?apiKey={YOUR_API_KEY}
&mode=shortest;car;traffic:disabled
&rangetype=distance
&start=geo!43.5086,16.43787
&range=40000
Note: This example uses a HERE API Key to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide.
Figure 1. Example of multiple components without connections displayed.
Figure 2. Example of multiple components with connections displayed.

If multiple components are not desired, use the single component option. Ferries will be treated as normal roads.

Below is an example of the same 40km isoline calculated in the center of Split, Croatia, using the single component parameter.

https://isoline.route.ls.hereapi.com/routing/7.2/calculateisoline.json
?apiKey={YOUR_API_KEY}
&mode=shortest;car;traffic:disabled
&rangetype=distance
&start=geo!43.5086,16.43787
&range=40000
&singlecomponent=true
Note: This example uses a HERE API Key to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide.
Figure 3. Example with single component.