How to plan your routes

Each vehicle in your fleet may have a unique tour that must take into account multiple variables, such as multiple time windows for pickups and deliveries, job priorities, and territories.

With the information obtained in the solution in the Create your optimized tours topic, the Routing v8 request can be executed to get an actual route.

For more information, see the HERE Routing API v8 Developer Guide.

Request

The routing request specifies tour departure and arrival at the depot as origins and destinations. The job locations are defined as via waypoints in the order corresponding to the tour stops.

curl "https://router.hereapi.com/v8/routes?origin=52.520008,13.404954&transportMode=car&destination=52.520008,13.404954&via=52.508923,13.3722855&via=52.53086,13.38469&return=polyline,summary&apiKey={YOUR_API_KEY}"

Response

This returns the route containing the geometry and information specified in the query param "return" above that can be used to display on a map or turn by turn navigation:

{
  "routes": [
    {
      "id": "326e8fb3-0fe7-4b0b-a007-94278104a5f3",
      "sections": [
        {
          "id": "098ddbc5-7d92-4688-b2c9-f9e293e97277",
          "type": "vehicle",
          "departure": {
            "time": "2023-06-30T11:33:57+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.52003,
                "lng": 13.40495
              },
              "originalLocation": {
                "lat": 52.520008,
                "lng": 13.4049539
              }
            }
          },
          "arrival": {
            "time": "2023-06-30T11:44:33+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.50908,
                "lng": 13.37216
              },
              "originalLocation": {
                "lat": 52.5089229,
                "lng": 13.3722855
              },
              "waypoint": 0
            }
          },
          "summary": {
            "duration": 636,
            "length": 3350,
            "baseDuration": 384
          },
          "polyline": "BG8lylkDsxlyZkDrE4D_EnGzKnG4IvH8LvH8LnG0K_E8Q7QkX7Vof7fgtBrJwMvRkX3XsiBjDoG3DwC3IgFnGoLvCgFjDwHrEoG_E8BvCnB_EzFnGvHzPzUvRnVvHrJnQ_T7LvMjNjNjDjD3SnV_JnLjDjDnG7GnG7GvHjIjIrJ_EnG_EnGzK_OrEnGvgBztB3N3SzUvb7ajmBrJ3NnGrJvC3D7G_J3DzF_EvH_J_O7G7LnGrJ_E_JjD3IvCnGjD_JjD7LvCzK7B7LjD_T7BnQ7B3XrJvkEjD_xBnBrYvCriBnG77C7BnfvC7fnB3SnB3cnBjNnBvH7BvMjDvMvC7LrEzP7BvWvCriB3Dn9BvCjmB3Ij2D3Dz8B3D7iCTrJTrJvC_2B7B7fnB_OTjIzF77C7BvlBnGvhDT7LT3IjDrnBTnLTzKvCnkB7B3XnB_OoBrEoBrEU7GAjIA7LA3IvC7fTrJvCzZvCvgB3DnpBnB3X7B_TnBnf7BjhB7BnVvCjDvCnB7BU7BU7BoBnB4D",
          "transport": {
            "mode": "car"
          }
        },
        {
          "id": "6d1ec102-6466-4de8-bf41-aa8162177a46",
          "type": "vehicle",
          "departure": {
            "time": "2023-06-30T11:44:33+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.50908,
                "lng": 13.37216
              },
              "originalLocation": {
                "lat": 52.5089229,
                "lng": 13.3722855
              },
              "waypoint": 0
            }
          },
          "arrival": {
            "time": "2023-06-30T11:53:10+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5309913,
                "lng": 13.3845948
              },
              "originalLocation": {
                "lat": 52.53086,
                "lng": 13.3846899
              },
              "waypoint": 1
            }
          },
          "summary": {
            "duration": 517,
            "length": 3521,
            "baseDuration": 379
          },
          "polyline": "BGw58kkDgwlwZAAoBgPkD8pBnkB8G4IrlCoBnG0KjDkD7BoG_EgFUwHA0Z7G8V7G4X7GwM3D8LrEwWjI4S7GgKrEsJ3DofjNkXzKwRnGwR7G8GvCoGvCoLrEkN_EgFnBkIvCwRrEgU3D8V7B4cA0U8BkIoBwRkD8GoBwR4D8V8GgZoLwR4IsOwHoGkD8L8G0P4IkhBsTkS0KgP4IoLoG4SgKgK4DoLkD4IUsJToGT4I7B8L_EsOjIwMjIkSjNwR3Noa7V4IvH4DjDgF_EsOjNwMvMoGvHsEzFoBvCgKvWkDjI8G_TsJjXsJnQ0F7GwHjI8GzFoL7GgFnB4DnB4DnB4IT0KAsEAwHT8LA4NA0KU0FT8GT0KkcoG4SwHoawCsJoB0FsJwgB4I8asJoVwH4SwHsYwHgZkIsY0K4hB8Qg3BwCkIwH0ZsE8LgF8QwHwWkD0KsT89B0KgjBkNgtB8GgZ4NkwB0KsiBsEkNgF4I8BsEoB4DgF4N0KokB0F4SgPw0BsEoQoBgFgKsiBgFoQ0F4SwCsJwHwbwHsd4Iof-BmH",
          "transport": {
            "mode": "car"
          }
        },
        {
          "id": "bb602025-1977-401a-9c17-a8a47eb75c50",
          "type": "vehicle",
          "departure": {
            "time": "2023-06-30T11:53:10+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5309913,
                "lng": 13.3845948
              },
              "originalLocation": {
                "lat": 52.53086,
                "lng": 13.3846899
              },
              "waypoint": 1
            }
          },
          "arrival": {
            "time": "2023-06-30T12:01:20+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.52003,
                "lng": 13.40495
              },
              "originalLocation": {
                "lat": 52.520008,
                "lng": 13.4049539
              }
            }
          },
          "summary": {
            "duration": 490,
            "length": 2442,
            "baseDuration": 379
          },
          "polyline": "BG-ynmkDm59wZ2DuN8BoGsEoQwCsJsEkSoBoG8BsJsE0U8BgK8BoLoB4IoB0KjIkD_doQvbgPniC4mBnL8GjNgK7LsJ_E4DnG4DzKoG_2B4c_JjwBjDrOrEzU3DvR7B_J7BnLnBnGTzF_EkD3D8B3DoB_EoBrEUzPwCvHoBvHoBU0FAkD7B0FnBgFjDkNrJwlBvCgKnBwHAsJ3DsOzFkXnBsE3IsiB_O08BrE4SzKssB3Nk6B_JkmBTkD7Q8iC3IokBnBgF7BkIzF8VvCsJzFoV3IwgBzF8VrEwRjDkNvCoL3D0KjDwH3D0KvHsT_EgKzFoL3DkIjDkIvMofnG0P7BsE7BkD7BwCvCwC_E4D_EwC7GkDvCoB7G4DrEwCzFsEzFsEnG4DrEoBrEoBjIAjIU_JwC_JkDzF8BnGkDnG4DnGgFrEkDoao2C0FwRgFgPnGwHvb8kBvMoQvM8Q_EoG_T8anG4I0FoL",
          "transport": {
            "mode": "car"
          }
        }
      ]
    }
  ]
}