Maximum route distance

A how-to guide for using maximum route distance with vehicle routing.

This feature is configurable via .json input, without the need for code customization.
Available for both the Marketplace app and Platform. You can find a list of all available features here.

This how-to guide assumes you already completed the get started with vehicle routing tutorial.

Field name	Required	Data type	SI Unit	Defined on	Example	Configurable via `defaults`
`max_distance`	No	`int`	`meters`	`vehicle`	`{"max_distance": 123}`	✅

It may be useful to limit the route distance, this is, how long can a vehicle travel. For example, if the vehicle has a limited range. This limit can be set via the max_distance feature on vehicles. The distance is given in meters.

Here is an example defining different maximum distances for vehicles. A sample output obtained after solving the problem is also shown.

Input (JSON)
Output (JSON)

{
  "defaults": {
    "vehicles": {
      "speed": 20
    },
    "stops": {
      "unplanned_penalty": 2000000
    }
  },
  "stops": [
    {
      "id": "Fushimi Inari Taisha",
      "location": { "lon": 135.772695, "lat": 34.967146 }
    },
    {
      "id": "Kiyomizu-dera",
      "location": { "lon": 135.78506, "lat": 34.994857 }
    },
    {
      "id": "Nijō Castle",
      "location": { "lon": 135.748134, "lat": 35.014239 }
    },
    {
      "id": "Kyoto Imperial Palace",
      "location": { "lon": 135.762057, "lat": 35.025431 }
    },
    {
      "id": "Gionmachi",
      "location": { "lon": 135.775682, "lat": 35.002457 }
    },
    {
      "id": "Kinkaku-ji",
      "location": { "lon": 135.728898, "lat": 35.039705 }
    },
    {
      "id": "Arashiyama Bamboo Forest",
      "location": { "lon": 135.672009, "lat": 35.017209 }
    }
  ],
  "vehicles": [
    {
      "id": "v1",
      "max_distance": 3000
    },
    {
      "id": "v2",
      "max_distance": 4000
    }
  ]
}

Page last updated September 28, 2023