How to request isolines for pedestrian use-cases

Pedestrian isoline routing uses only roads and roadways open to pedestrians. These includes among others sidewalks, forest paths, parks, ferries, shortcuts through buildings, and stairs.

You can enable pedestrian isoline routing by setting transportMode=pedestrian.

There are two types of isolines available for pedestrian routing:

Limiting the distance that can be traveled with the range[type]=distance and the range[values] (in meters) parameters.
Limiting the time that can be spent traveling with the range[type]=time, range[values] (in seconds), and the pedestrian[speed] (meters per second) parameters.

You can avoid specific road features using the avoid[features] parameter and inserting values for road types that are not desired, for example tunnel, dirtRoad, or ferry.

The following request demonstrates how far a pedestrian can walk from an origin in Berlin with a walking speed of 1.5 seconds per meter and a maximum walking time of 10 minutes while avoiding tunnels.

curl -gX GET 'https://isoline.router.hereapi.com/v8/isolines?'\
'origin=52.559248,13.389417&'\
'range[type]=time&'\
'range[values]=1200&'\
'transportMode=pedestrian&'\
'pedestrian[speed]=1.5&'\
'apiKey=YOUR_API_KEY'

The response contains a polygon which the pedestrian can reach with these preconditions. The polygon is encoded as a flexible polyline.

{
  "departure":
  {
    "time": "2023-06-27T09:00:37+00:00",
    "place":
    {
      "type": "place",
      "location":
      {
        "lat": 52.55946,
        "lng": 13.38971
      },
      "originalLocation":
      {
        "lat": 52.559248,
        "lng": 13.389417
      }
    }
  },
  "isolines": [
    {
      "range":
      {
        "type": "time",
        "value": 1200
      },
      "polygons": [
        {
          "outer": "BGoxjokD028vZA4SrFkQlgB2K3KmgB1K4KrFiQA81CsFiQiQsFkQrF2K3KkQpF8qBAkQrFmgBlgB2KAsFiQAsgCsFkQkQsFuVAiQqFA4KlgB4KtVuVrFkQAuVsFiQkQsFiQrF4K1K2KAsFiQrFkQhQsFtVAjQqFA4K4K4KsFiQA2rFqFiQkQsFiQrFsFhQAvVsFhQkQrF8qBAkQsF2K4KmgB2KsFkQrFiQ1K4KrFiQsFkQiQsFuVAkQsFuVuVA4KhQqFvVAhQsF3K4K1KA3K3K3KAlgBmgB1KA3KlgB3KApFkQA8qBrFkQvVuVhQsFtVrFjQrFrF4KAuVsFwV4KuVsFuVA-qBqFiQsgCsgCmgB4K4K4KkQsFqgCAkQrFsFjQAtVrFjQ3K1K1KlgB3K3KrFhQA9qBsFjQ4KA2KmgB4K4KsFkQAuVsFiQ2K4KsFkQAuVsFiQmgB4K4K4KiQsFkQrFuVvV4KlgB2KAsFkQAuVrFkQ1K2K3KmgB3KA1K1KjQrFhQsFvVuVrFkQA8qBpFkQ3K2KrFkQAsgCrFiQ1K4KA4K2K2KsFkQAuVsFkQ4K2KqFkQAuVsFkQ4KA4KlgB2K3K4KlgB4K3K2KlgB4K1K4KlgBuVvV4KAqFkQAorDpFkQ3K4KA2K4K4KqFiQAwVpFuV3KuVAkQ4K2KqFkQpFiQ3K4KA4KmgB2KA4KjQsFtVAhQsF3KmgB3K2KrFkQA61CpFkQ3KA3KlgBhQrFvVAhQsFtVuVrFkQA8qBsFkQmgB2KmgBmgBmgB4K2K4K4KAsFjQAnrDsFjQ2KAsFkQAuVsFiQ4K4KA4K3K2KrFkQAuVsFkQiQqFwVAiQsFwVwVqFiQAuVpFkQ3KAlgBlgBjQrFhQsFrFiQAwVsFiQ4K4KqFiQAwVpFiQ3K4KrFiQA-qBrFkQhQqFjQpFrFjQA51CpFjQ3KA3K4KhQsFvVAhQrFA3KmgBlgBsFhQrFjQ9qB7qB1KA3KmgB3K2K1KmgBlgBmgB3KmgB3K4KpFiQA-qBqFkQkQqFuVAkQsFA4KjQsFtVAjQqFpFkQAuVqFkQ4K2KA4K3K4K1KmgBjQsFhQrFrFjQsFhQ2K3KsFhQAvVrFhQ1K3KrFhQsFjQ2K1KsFjQA9qBrFhQhQrFjQsF1K4KjQqFhQpFrFjQAtVsFjQ2K1KA3KlgB3KA1KmgB3KsFjQA7qBrFjQ1KA9qB-qB3KmgBlgB4KtVuVrFiQA-qBrFkQ1KAvVvVpFhQAn2ErFhQ3KA1KmgBlgB4K3K2KlgB4K3KiQrFkQsF4KwVuV2KmgB4K4K4KmgB2K2KsFkQAuVrFuV1KwV3KiQjQsFhQrF3KlgB1KArFkQAuVrFiQ3KArFhQA51CpFjQ3K1K3KlgB1KArFiQA-qBrFiQ3K4KrFiQAwVsFiQ4K4KA2KjQsFhQrFrFhQA3gEsFhQ4K3KqFjQAtVpFhQvVvVhQrFl2EAjQsFrFkQA61CrFkQtVuV3KApFjQA51CqFhQ4K3KA3KhQrFjQsF3K4K1KArFjQsFhQiQrFwVAiQrFsFhQAvVrFhQlgB3K3KlgB1KA3KmgBtVwVjQqFtVAtVpFjQrF3KsF1KArFjQsFhQmgBlgBsFjQA7qBrFjQlgB3KA1KmgB3KA3K3K1KrFjQsFhQ4K3KA3K3K1K3KlgB1K3KrFhQsFjQiQrFkQsF2K4K4KAsFjQAtVrFjQlgB1K3K3KhQrFtVAjQsFrFkQA61CrFiQ1KArFhQAtVrFjQtVtV3KAz1B01BjQsFhQrFA3K4K1K2KlgBmgB3KsFhQAvVrFhQ1K3KrFhQsFjQiQrFkQsF2KmgB4KAsFhQAn2ErFhQ3KArFiQA-qBpFkQjQqFhQpFrFjQAtVrFjQlgB1KrFjQAtVsFjQ4K1K2KlgB4K3KsFjQA51CrFhQ3K3K1KlgB3K3KrFhQAtVsFjQiQrFwVAiQsFsFkQAuVsFiQ-qB-qB2KA4KlgBmgBlgB2KlgB4K3KsFhQAtVrFjQ3KA1KmgB3KA7qB9qBrFhQA51CrFjQ3KA1KmgB3K4KrFiQAwVrFiQ1K4KrFiQAwVrFiQ3KArFhQAprDpFhQ3K3KA3KiQrFwVAiQpF4KlgBmgBlgBsFjQrFhQ3K3K1KlgBlgB3KvVtVrFjQAtVpFhQ3K3KrFjQAtVrFhQ1K3KA3KiQpFkQqFmgBmgB2KAmgBlgBkQpFuVAiQqF4KmgBuVwV4KAsFjQArgCsFhQiQrFkQsF8qB8qB4KmgB4K4K2KmgB4KAsFjQA7qBsFjQ2K1KsFjQAl2EsFjQkQpFiQqFsFkQA-qBrFiQ3K4KpFiQA4gErFkQ3K2KrFkQsFiQ4KAuVtV4KlgBygDxgD2KlgB4K3KsFhQrFjQlgB1K9qB9qBA3K4K1K4KlgB2KAsFiQAwVsFiQiQsFkQrFsFhQA3gEsFjQuVtViQrFkQsFsFiQAwVrFiQ3K4KrFiQAqrDsFiQ4KAuVtV4KlgB01Bz1B4KlgB4K3KqFhQAvVpFhQlgBlgBrFjQAtVsFhQ2KAwVuV2KmgB4K4K4KmgB2KA4KlgB61C71C4K1CsFiIAuN"
        }
      ]
    }
  ]
}

For more information on the parameters used, see the HERE Isoline Routing API v8 API reference.

The following image shows how avoiding tunnels can change the shape of the resulting isoline. It shows two overlaid isolines, one with avoid[features]=tunnel and one without.