Routing API v7 Developer's Guide

Distance-Based Isoline

To calculate a distance-based isoline, specify the distance as rangetype and range in meters. mode can be either shortest or fastest. The driver can arrive at a destination within a certain area by always driving the fastest possible route or by always driving the shortest possible route. The request below calculates a 4km isoline around the center of Berlin in shortest mode. This results in the answer to the question: What area can I reach by travelling 4km or less?

Note: These examples use a HERE API Key to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide.
https://isoline.route.ls.hereapi.com/routing/7.2/calculateisoline.json
?apiKey={YOUR_API_KEY}
&mode=shortest;car;traffic:disabled
&rangetype=distance
&start=geo!52.51578,13.37749
&range=4000
Figure 1. Example isoline representing a travel distance of 4km from the center of Berlin.

Drivers normally choose the fastest possible route. It is possible to calculate an isoline which simulates this behavior, while limiting it to a given distance. The request below calculates a 4km isoline around the center of Berlin in fastest mode. This results in the answer to the question: What area can I reach by travelling 4km or less, while taking the fastest possible route?

https://isoline.route.ls.hereapi.com/routing/7.2/calculateisoline.json
?apiKey={YOUR_API_KEY}
&mode=fastest;car;traffic:disabled
&rangetype=distance
&start=geo!52.51578,13.37749
&range=4000
Figure 2. Example isoline representing a travel distance of 4km from the center of Berlin while driving the fastest possible route.