HERE Tour Planning API

https://docs.here.com/tour-planning/
Admin
The HERE Tour Planning API dynamically optimizes routes for multiple vehicles visiting a set of...
Tokens:550,993
Snippets:2,374
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### VisuallyAppealingTours Example

Source: https://docs.here.com/tour-planning/openapi/api.yaml

Example configuration for the VisuallyAppealingTours object, showing parameters for clustering and weighting.

```json
{
  "maxClusterRadius": 300,
  "tolerance": 0.1,
  "type": "visuallyAppealingTours",
  "weight": 0.5
}
```

--------------------------------

### Multiple shifts configuration JSON

Source: https://docs.here.com/tour-planning/docs/billing

Example showing a vehicle configured with four distinct shifts, each with its own start and end time and location.

```json
{
    "fleet": {
      "types": [
        {
          "id": "Vehicle_1",
          "profile": "car",
          "costs": {
            "fixed": 10,
            "distance": 0.002,
            "time": 0.003
          },
          "shifts": [
            {
              "start": {
                "time": "2021-10-23T09:00:00Z",
                "location": {
                  "lat": 51.059188,
                  "lng": 13.540317
                }
              },
              "end": {
                "time": "2021-10-23T12:00:00Z",
                "location": {
                  "lat": 51.059188,
                  "lng": 13.540317
                }
              }
            },
            {
              "start": {
                "time": "2021-10-24T09:00:00Z",
                "location": {
                  "lat": 51.059188,
                  "lng": 13.540317
                }
              },
              "end": {
                "time": "2021-10-24T12:00:00Z",
                "location": {
                  "lat": 51.059188,
                  "lng": 13.540317
                }
              }
            },
            {
              "start": {
                "time": "2021-10-25T09:00:00Z",
                "location": {
                  "lat": 51.059188,
                  "lng": 13.540317
                }
              },
              "end": {
                "time": "2021-10-25T12:00:00Z",
                "location": {
                  "lat": 51.059188,
                  "lng": 13.540317
                }
              }
            },
            {
              "start": {
                "time": "2021-10-26T09:00:00Z",
                "location": {
                  "lat": 51.059188,
                  "lng": 13.540317
                }
              },
              "end": {
                "time": "2021-10-26T12:00:00Z",
                "location": {
                  "lat": 51.059188,
                  "lng": 13.540317
                }
              }
            }
          ],
          "capacity": [
            10
          ],
          "amount": 1
        }
      ],
      "profiles": [
        {
          "type": "car",
          "name": "car"
        }
      ]
    },
    // Remaining problem components omitted for brevity
  }
```

--------------------------------

### Full Problem Configuration JSON

Source: https://docs.here.com/tour-planning/docs/map-route-violations

A complete example configuration including fleet profiles, violation mapping, and job definitions.

```json
{
    "configuration": { "experimentalFeatures": ["violationMapping"] },
    "fleet": {
      "types": [
        {
          "profile": "delivery_truck",
          "amount": 1,
          "capacity": [30],
          "costs": { "fixed": 10, "time": 0.002, "distance": 0.001 },
          "id": "vehicle_1",
          "shifts": [
            {
              "start": {
                "time": "2026-05-15T08:30:00Z",
                "location": { "lat": 52.5062838773854, "lng": 13.386458504898345 }
              }
            }
          ]
        }
      ],
      "profiles": [
        {
          "name": "delivery_truck",
          "type": "truck",
          "options": { 
            "height": 800,
            "grossWeight": 8000 
          },
          "avoid": {
            "areas": [
              {
                "type": "boundingBox",
                "north": 52.463258,
                "south": 52.461414,
                "east": 13.313586,
                "west": 13.309732
              }
            ]
          },
          "violationMapping": [
            { "category": "category1", "type": "traffic" },
            { "category": "category1", "type": "avoidAreasAndSegments" },
            { "category": "category1", "type": "restriction", "grossWeight": "include" },
            { "category": "category2", "type": "restriction", "height": "include" }
          ],
          "ignoreRouteViolations": ["allExceptCategory2"]
        }
      ]
    },
    "plan": {
      "jobs": [
        {
          "id": "Job_1_height",
          "tasks": {
            "deliveries": [
              {
                "places": [
                  {
                    "duration": 300,
                    "location": { "lat": 52.443484936711805, "lng": 13.348484551197322 }
                  }
                ],
                "demand": [1]
              }
            ]
          }
        },
        {
          "id": "Job_2_grossWeigth",
          "tasks": {
            "deliveries": [
              {
                "places": [
                  {
                    "duration": 300,
                    "location": { "lat": 52.5028909960123, "lng": 13.397018480136607 }
                  }
                ],
                "demand": [1]
              }
            ]
          }
        },
        {
          "id": "Job_3_traffic",
          "tasks": {
            "deliveries": [
              {
                "places": [
                  {
                    "duration": 300,
                    "location": { "lat": 52.49173924851315, "lng": 13.401725806085613 }
                  }
                ],
                "demand": [1]
              }
            ]
          }
        },
        {
          "id": "Job_4_height",
          "tasks": {
            "deliveries": [
              {
                "places": [
                  {
                    "duration": 300,
                    "location": { "lat": 52.41796351389373, "lng": 13.314499243723935 }
                  }
                ],
                "demand": [1]
              }
            ]
          }
        },
        {
          "id": "Job_5_bbox",
          "tasks": {
            "deliveries": [
              {
                "places": [
                  {
                    "duration": 300,
                    "location": { "lat": 52.462269714892976, "lng": 13.311738706185261 }
                  }
                ],
                "demand": [1]
              }
            ]
          }
        }
      ]
    }
  }
```

--------------------------------

### Open VRP configuration without shift locations

Source: https://docs.here.com/tour-planning/docs/open-vrp

A JSON configuration example for a fleet with defined shift times but no start or end locations, including multiple job tasks.

```json
{
    "fleet": {
        "types": [
            {
                "id": "048d43e6e61c",
                "profile": "car_1",
                "costs": {
                    "fixed": 10.0,
                    "distance": 0.002,
                    "time": 0.01
                },
                "shifts": [
                    {
                        "start": {
                            "time": "2021-07-13T08:20:00Z"
                        },
                        "end": {
                            "time": "2021-07-13T14:20:00Z"
                        }
                    }
                ],
                "capacity": [
                    100
                ],
                "amount": 2
                }
            ],
            "profiles": [
                {
                    "type": "car",
                    "name": "car_1"
                }
            ]
        },
        "plan": {
            "jobs": [
                {
                    "id": "job_1",
                    "tasks": {
                        "pickups": [
                            {
                                "places": [
                                    {
                                        "location": {
                                            "lat": 52.513365341037485,
                                            "lng": 13.325000854641972
                                        },
                                        "duration": 780
                                    }
                                ],
                                "demand": [
                                    40
                                ]
                            }
                        ]
                    }
                },
                {
                    "id": "job_2",
                    "tasks": {
                        "deliveries": [
                            {
                                "places": [
                                    {
                                        "location": {
                                            "lat": 52.7478839710114,
                                            "lng": 13.44595304182502
                                        },
                                        "duration": 120
                                    }
                                ],
                                "demand": [
                                    5
                                ]
                            }
                        ]
                    }
                },
                {
                    "id": "job_3",
                    "tasks": {
                        "pickups": [
                            {
                                "places": [
                                    {
                                        "location": {
                                            "lat": 52.44003237354213,
                                            "lng": 13.422125667246638
                                        },
                                        "duration": 360
                                    }
                                ],
                                "demand": [
                                    10
                                ]
                            }
                        ]
                    }
                },
                {
                    "id": "job_4",
                    "tasks": {
                        "deliveries": [
                            {
                                "places": [
                                    {
                                        "location": {
                                            "lat": 52.55783238016377,
                                            "lng": 13.304436007504957
                                        },
                                        "duration": 720
                                    }
                                ],
                                "demand": [
                                    10
                                ]
                            }
                        ]
                    }
                },
                {
                    "id": "job_5",
                    "tasks": {

```

--------------------------------

### Sample solution JSON

Source: https://docs.here.com/tour-planning/docs/custom-matrix

The API returns the full solution details including statistics and tour stops.

```json
{
  "statistic": {
    "cost": 78.269,
    "distance": 8641,
    "duration": 3745,
    "times": {
      "driving": 1345,
      "serving": 2400,
      "waiting": 0,
      "stopping": 0,
      "break": 0
    }
  },
  "tours": [
    {
      "vehicleId": "car_1_1",
      "typeId": "car_1",
      "stops": [
        {

```

--------------------------------

### Configure Open VRP without shift end

Source: https://docs.here.com/tour-planning/docs/open-vrp

Example configuration for a vehicle with a defined start location and time, but no specified shift end. Note that only the final shift for a vehicle can lack an end time to avoid validation errors.

```json
{
    "fleet": {
        "types": [
            {
                "id": "048d43e6e61c",
                "profile": "car_1",
                "costs": {
                    "fixed": 10.0,
                    "distance": 0.002,
                    "time": 0.01
                },
                "shifts": [
                    {
                        "start": {
                            "time": "2021-07-13T08:20:00Z",
                            "location": {
                                "lat": 52.530971,
                                "lng": 13.384915
                            }
                        }
                    }
                ],
                "capacity": [
                    100
                ],
                "limits": {
                    "shiftTime": 43200
                },
                "amount": 2
                }
            ],
            "profiles": [
                {
                    "type": "car",
                    "name": "car_1"
                }
            ]
        },
        "plan": {
            "jobs": [
                {
                    "id": "job_1",
                    "tasks": {
                        "pickups": [
                            {
                                "places": [
                                    {
                                        "location": {
                                            "lat": 52.513365341037485,
                                            "lng": 13.325000854641972
                                        },
                                        "duration": 780
                                    }
                                ],
                                "demand": [
                                    40
                                ]
                            }
                        ]
                    }
                },
                {
                    "id": "job_2",
                    "tasks": {
                        "deliveries": [
                            {
                                "places": [
                                    {
                                        "location": {
                                            "lat": 52.7478839710114,
                                            "lng": 13.325000854641972
                                        }
```

--------------------------------

### Example solution with unassigned jobs

Source: https://docs.here.com/tour-planning/docs/traffic-modes

A JSON response showing a tour planning result where jobs are unassigned due to reachability constraints.

```json
{
  "statistic": {
    "cost": 21.187,
    "distance": 1187,
    "duration": 554,
    "times": {
      "driving": 254,
      "serving": 300,
      "waiting": 0,
      "stopping": 0,
      "break": 0
    }
  },
  "tours": [
    {
      "vehicleId": "A_2",
      "typeId": "A",
      "stops": [
        {
          "time": {
            "arrival": "2023-07-18T09:28:40Z",
            "departure": "2023-07-18T09:28:40Z"
          },
          "load": [
            1
          ],
          "activities": [
            {
              "jobId": "departure",
              "type": "departure",
              "location": {
                "lat": 48.833409,
                "lng": 2.34858
              },
              "time": {
                "start": "2023-07-18T09:28:40Z",
                "end": "2023-07-18T09:28:40Z"
              }
            }
          ],
          "location": {
            "lat": 48.833409,
            "lng": 2.34858
          },
          "distance": 0
        },
        {
          "time": {
            "arrival": "2023-07-18T09:32:54Z",
            "departure": "2023-07-18T09:37:54Z"
          },
          "load": [
            0
          ],
          "activities": [
            {
              "jobId": "Job_3",
              "type": "delivery",
              "location": {
                "lat": 48.830612,
                "lng": 2.342853
              },
              "time": {
                "start": "2023-07-18T09:32:54Z",
                "end": "2023-07-18T09:37:54Z"
              }
            }
          ],
          "location": {
            "lat": 48.830612,
            "lng": 2.342853
          },
          "distance": 1187
        }
      ],
      "statistic": {
        "cost": 21.187,
        "distance": 1187,
        "duration": 554,
        "times": {
          "driving": 254,
          "serving": 300,
          "waiting": 0,
          "stopping": 0,
          "break": 0
        }
      },
      "shiftIndex": 0
    }
  ],
  "unassigned": [
    {
      "jobId": "Job_1",
      "reasons": [
        {
          "code": "REACHABLE_CONSTRAINT",
          "description": "location unreachable",
          "details": [
            {
              "vehicleId": "A_2",
              "shiftIndex": 0
            }
          ]
        }
      ]
    },
    {
      "jobId": "Job_2",
      "reasons": [
        {
          "code": "REACHABLE_CONSTRAINT",
          "description": "location unreachable",
          "details": [
            {
              "vehicleId": "A_2",
              "shiftIndex": 0
            }
          ]
        }
      ]
    }
  ]
}
```

--------------------------------

### UnauthenticatedErrorResponse Example

Source: https://docs.here.com/tour-planning/openapi/api.yaml

Example response for an unauthenticated request.

```json
{
  "error": "Unauthorized",
  "error_description": "No credentials found"
}
```

--------------------------------

### Initial solution JSON (0.5 m/s)

Source: https://docs.here.com/tour-planning/docs/pedestrian-speed

A sample JSON output representing a tour plan with a pedestrian speed of 0.5 m/s, including statistics and stop details.

```json
{
    "statistic": {
      "cost": 48.152,
      "distance": 6116,
      "duration": 16018,
      "times": {
        "driving": 12418,
        "serving": 3600,
        "waiting": 0,
        "stopping": 0,
        "break": 0
      }
    },
    "tours": [
      {
        "vehicleId": "courier_1_1",
        "typeId": "courier_1",
        "stops": [
          {
            "time": {
              "arrival": "2024-06-24T08:00:00Z",
              "departure": "2024-06-24T08:00:00Z"
            },
            "load": [
              15
            ],
            "activities": [
              {
                "jobId": "departure",
                "type": "departure",
                "location": {
                  "lat": 52.53097,
                  "lng": 13.38504
                },
                "time": {
                  "start": "2024-06-24T08:00:00Z",
                  "end": "2024-06-24T08:00:00Z"
                }
              }
            ],
            "location": {
              "lat": 52.53097,
              "lng": 13.38504
            },
            "distance": 0
          },
          {
            "time": {
              "arrival": "2024-06-24T08:10:57Z",
              "departure": "2024-06-24T08:14:57Z"
            },
            "load": [
              14
            ],
            "activities": [
              {
                "jobId": "Job_11",
                "type": "delivery",
                "location": {
                  "lat": 52.53011,
                  "lng": 13.38086
                },
                "time": {
                  "start": "2024-06-24T08:10:57Z",
                  "end": "2024-06-24T08:14:57Z"
                }
              }
            ],
            "location": {
              "lat": 52.53011,
              "lng": 13.38086
            },
            "distance": 324
          },
          {
            "time": {
              "arrival": "2024-06-24T08:25:21Z",
              "departure": "2024-06-24T08:29:21Z"
            },
            "load": [
              13
            ],
            "activities": [
              {
                "jobId": "Job_14",
                "type": "delivery",
                "location": {
                  "lat": 52.531,
                  "lng": 13.37755
                },
                "time": {
                  "start": "2024-06-24T08:25:21Z",
                  "end": "2024-06-24T08:29:21Z"
                }
              }
            ],
            "location": {
              "lat": 52.531,
              "lng": 13.37755
            },
            "distance": 636
          },
          {
            "time": {
              "arrival": "2024-06-24T08:48:12Z",
              "departure": "2024-06-24T08:52:12Z"
            },
            "load": [
              12
            ],
            "activities": [
              {
                "jobId": "Job_8",
                "type": "delivery",
                "location": {
                  "lat": 52.52716,
                  "lng": 13.38202
                },
                "time": {
                  "start": "2024-06-24T08:48:12Z",
                  "end": "2024-06-24T08:52:12Z"
                }
              }
            ],
            "location": {
              "lat": 52.52716,
              "lng": 13.38202
            },
            "distance": 1196
          },
          {
            "time": {
              "arrival": "2024-06-24T09:07:18Z",
              "departure": "2024-06-24T09:11:18Z"
            },
            "load": [
              11
            ],
            "activities": [
              {
                "jobId": "Job_7",
                "type": "delivery",
                "location": {
                  "lat": 52.528909,
                  "lng": 13.385381
                },
                "time": {
                  "start": "2024-06-24T09:07:18Z",
                  "end": "2024-06-24T09:11:18Z"
                }
              }
            ],
            "location": {
              "lat": 52.528909,
              "lng": 13.385381
            },
            "distance": 1644
          },
          {
            "time": {
              "arrival": "2024-06-24T09:22:07Z",
              "departure": "2024-06-24T09:26:07Z"
            },
            "load": [
              10
            ],
            "activities": [
              {
                "jobId": "Job_6",
                "type": "delivery",
                "location": {
                  "lat": 52.52756,
                  "lng": 13.38836
                },
                "time": {
                  "start": "2024-06-24T09:22:07Z",
                  "end": "2024-06-24T09:26:07Z"
                }
              }
            ],
            "location": {
              "lat": 52.52756,
              "lng": 13.38836
            }
```

--------------------------------

### ServiceErrorResponse Example

Source: https://docs.here.com/tour-planning/openapi/api.yaml

Example response for a 503 Request Timeout error.

```json
{
  "title": "Request Timeout",
  "status": 503,
  "code": "E613503",
  "cause": "Service was not ready to process the request. Please retry later.",
  "action": "",
  "correlationId": "ff93d908-aecf-4df8-b9f6-3d33f85d638a"
}
```

--------------------------------

### ServerErrorResponse Example

Source: https://docs.here.com/tour-planning/openapi/api.yaml

Example response for a 500 Internal server error.

```json
{
  "title": "Server error",
  "status": 500,
  "code": "E613000",
  "cause": "Internal server error.",
  "action": "",
  "correlationId": "ff93d908-aecf-4df8-b9f6-3d33f85d638a"
}
```

--------------------------------

### Tour Planning JSON Output

Source: https://docs.here.com/tour-planning/docs/skills

Example of a tour plan showing vehicle activities, statistics, and unassigned jobs due to skill constraints.

```json
{
                        "lat": 52.530971,
                        "lng": 13.384915
                    },
                    "time": {
                        "arrival": "2021-08-27T08:03:00Z",
                        "departure": "2021-08-27T08:03:00Z"
                    },
                    "load": [
                        2
                    ],
                    "activities": [
                        {
                            "jobId": "departure",
                            "type": "departure"
                        }
                    ],
                    "distance": 0
                },
                {
                    "location": {
                        "lat": 52.558716170353655,
                        "lng": 13.31823634661218
                    },
                    "time": {
                        "arrival": "2021-08-27T08:19:19Z",
                        "departure": "2021-08-27T08:23:19Z"
                    },
                    "load": [
                        0
                    ],
                    "activities": [
                        {
                            "jobId": "job_3",
                            "type": "delivery"
                        }
                    ],
                    "distance": 7233
                },
                {
                    "location": {
                        "lat": 52.45717902261775,
                        "lng": 13.45675245690121
                    },
                    "time": {
                        "arrival": "2021-08-27T08:47:25Z",
                        "departure": "2021-08-27T08:47:25Z"
                    },
                    "load": [
                        0
                    ],
                    "activities": [
                        {
                            "jobId": "arrival",
                            "type": "arrival"
                        }
                    ],
                    "distance": 29200
                }
            ],
            "statistic": {
                "cost": 21327.0,
                "distance": 29197,
                "duration": 2665,
                "times": {
                    "driving": 2425,
                    "serving": 240,
                    "waiting": 0,
                    "break": 0
                }
            }
        }
    ],
    "unassigned": [
        {
            "jobId": "job_6",
            "reasons": [
                {
                    "code": "SKILL_CONSTRAINT",
                    "description": "cannot serve required skill"
                }
            ]
        }
    ]
}
```

--------------------------------

### ResourceErrorResponse Example

Source: https://docs.here.com/tour-planning/openapi/api.yaml

Example response for a 404 Resource not found error.

```json
{
  "title": "Resource not found",
  "status": 404,
  "code": "E613000",
  "cause": "The problem not found.",
  "action": "",
  "correlationId": "1f19d292-fb74-42f3-83a4-3730e535b88e"
}
```

--------------------------------

### Full Territory Planning Example

Source: https://docs.here.com/tour-planning/docs/territory

A complete configuration example featuring two vehicles restricted to North and South territories respectively, and a job assigned to the North territory.

```json
{
    "fleet": {
        "types": [
            {
                "id": "car_1",
                "profile": "car_profile",
                "costs": {
                    "distance": 0.0001,
                    "time": 0
                },
                "territories": {
                    "strict": true,
                    "items": [
                        {
                            "id": "North"
                        }
                    ]
                },
                "shifts": [
                    {
                        "start": {
                            "time": "2021-07-04T06:03:00Z",
                            "location": {
                                "lat": 47.625729,
                                "lng": -122.337255
                            }
                        },
                        "end": {
                            "time": "2021-07-04T13:03:00Z",
                            "location": {
                                "lat": 47.625729,
                                "lng": -122.337255
                            }
                        }
                    }
                ],
                "capacity": [
                    0
                ],
                "amount": 1
            },
            {
                "id": "car_2",
                "profile": "car_profile",
                "costs": {
                    "distance": 0.0001,
                    "time": 0
                },
                "territories": {
                    "strict": true,
                    "items": [
                        {
                            "id": "South"
                        }
                    ]
                },
                "shifts": [
                    {
                        "start": {
                            "time": "2021-07-04T06:03:00Z",
                            "location": {
                                "lat": 47.625729,
                                "lng": -122.337255
                            }
                        },
                        "end": {
                            "time": "2021-07-04T13:03:00Z",
                            "location": {
                                "lat": 47.625729,
                                "lng": -122.337255
                            }
                        }
                    }
                ],
                "capacity": [
                    0
                ],
                "amount": 1
            }
        ],
        "profiles": [
            {
                "type": "car",
                "name": "car_profile"
            }
        ]
    },
    "plan": {
        "jobs": [
            {
                "id": "A",
                "tasks": {
                    "deliveries": [
                        {
                            "places": [
                                {
                                    "location": {
                                        "lat": 47.628661,
                                        "lng": -122.342312
                                    },
                                    "territoryIds": [
                                        "North"
                                    ],
                                    "duration": 0
                                }
                            ],
                            "demand": [
                                0
```

--------------------------------

### TooManyRequestsResponse Example

Source: https://docs.here.com/tour-planning/openapi/api.yaml

Example response when the service rate limit has been reached.

```json
{
  "error": "Too Many Requests",
  "error_description": "Rate limit for this service has been reached"
}
```

--------------------------------

### Tour Planning Solution Output

Source: https://docs.here.com/tour-planning/docs/breaks

A sample solution response containing aggregated statistics and detailed stop information for a vehicle tour.

```json
{
    "statistic": {
        "cost": 180.973,
        "distance": 63465,
        "duration": 17918,
        "times": {
            "driving": 6897,
            "serving": 4980,
            "waiting": 4241,
            "break": 1800
        }
    },
    "tours": [
        {
            "vehicleId": "6290a20b08a7_1",
            "typeId": "6290a20b08a7",
            "stops": [
                {
                    "location": {
                        "lat": 52.530971,
                        "lng": 13.384915
                    },
                    "time": {
                        "arrival": "2021-08-27T08:03:00Z",
                        "departure": "2021-08-27T09:43:41Z"
                    },
                    "load": [
                        6
                    ],
                    "activities": [
                        {
                            "jobId": "departure",
                            "type": "departure"
                        }
                    ],
                    "distance": 0
                },
                {
                    "location": {
                        "lat": 52.59175589353722,
                        "lng": 13.350747750372255
                    },
                    "time": {
                        "arrival": "2021-08-27T10:03:00Z",
                        "departure": "2021-08-27T10:09:00Z"
                    },
                    "load": [
                        5
                    ],
                    "activities": [
                        {
                            "jobId": "job_1",
                            "type": "delivery"
                        }
                    ],
                    "distance": 9479
                },
                {
```

--------------------------------

### Full solution JSON sample

Source: https://docs.here.com/tour-planning/docs/co-emissions

Provides the complete JSON structure for a tour planning solution including statistics and tour details.

```json
{
    "statistic": {
      "cost": 91.205,
      "distance": 60325,
      "duration": 14241,
      "times": {
        "driving": 6441,
        "serving": 7800,
        "waiting": 0,
        "stopping": 0,
        "break": 0
      },
      "consumption": 6.3893,
      "co2Emission": 17.232999999999997
    },
    "tours": [
      {
        "vehicleId": "small_10",
        "typeId": "small",
        "stops": [
          {
            "time": {
              "arrival": "2023-05-28T08:00:00Z",
              "departure": "2023-05-28T08:00:00Z"
            },
            "load": [
              0
            ],
            "activities": [
              {
                "jobId": "departure",
                "type": "departure",
                "location": {
                  "lat": 52.50935,
                  "lng": 13.41997
                },
                "time": {
                  "start": "2023-05-28T08:00:00Z",
                  "end": "2023-05-28T08:00:00Z"
                }
              }
            ],
            "location": {
              "lat": 52.50935,
              "lng": 13.41997
            },
            "distance": 0
          },
          {
            "time": {
              "arrival": "2023-05-28T08:19:39Z",
              "departure": "2023-05-28T08:29:39Z"
            },
            "load": [
              1
            ],
            "activities": [
              {
                "jobId": "Job_1",
                "type": "pickup",
                "location": {
                  "lat": 52.56182,
                  "lng": 13.497167
                },
                "time": {
                  "start": "2023-05-28T08:19:39Z",
                  "end": "2023-05-28T08:29:39Z"
                }
              }
            ],
            "location": {
              "lat": 52.56182,
              "lng": 13.497167
            },
            "distance": 9971
          },
          {
            "time": {
              "arrival": "2023-05-28T08:36:16Z",
              "departure": "2023-05-28T08:46:16Z"
            },
            "load": [
              2
            ],
            "activities": [
              {
                "jobId": "Job_2",
                "type": "pickup",
                "location": {
                  "lat": 52.534553,
                  "lng": 13.519429
                },
                "time": {
                  "start": "2023-05-28T08:36:16Z",
                  "end": "2023-05-28T08:46:16Z"
                }
              }
            ],
            "location": {
              "lat": 52.534553,
              "lng": 13.519429
            },
            "distance": 13720
          },
          {
            "time": {
              "arrival": "2023-05-28T09:00:18Z",
              "departure": "2023-05-28T09:10:18Z"
            },
            "load": [
              3
            ],
            "activities": [
              {
                "jobId": "Job_3",
                "type": "pickup",
                "location": {
                  "lat": 52.482275,
                  "lng": 13.502456
                },
                "time": {
                  "start": "2023-05-28T09:00:18Z",
                  "end": "2023-05-28T09:10:18Z"
                }
              }
            ],
            "location": {
              "lat": 52.482275,
              "lng": 13.502456
            },
            "distance": 22499
          },
          {
            "time": {
              "arrival": "2023-05-28T09:12:08Z",
              "departure": "2023-05-28T09:22:08Z"
            },
            "load": [
              4
            ],
            "activities": [
              {
                "jobId": "Job_4",
                "type": "pickup",
```

--------------------------------

### LinearPenalty Type Example

Source: https://docs.here.com/tour-planning/openapi/api.yaml

Example of the linear penalty type definition.

```json
"linear"
```

--------------------------------

### ErrorCodes Example

Source: https://docs.here.com/tour-planning/openapi/api.yaml

Example array for error codes in the routing matrix.

```json
[0,1,2,3]
```

--------------------------------

### Territory Configuration JSON

Source: https://docs.here.com/tour-planning/docs/territory

Example configuration defining job locations and their associated territory IDs.

```json
{
                "id": "D",
                "tasks": {
                    "deliveries": [
                        {
                            "places": [
                                {
                                    "location": {
                                        "lat": 47.624891,
                                        "lng": -122.347445
                                    },
                                    "territoryIds": [
                                        "North"
                                    ],
                                    "duration": 0
                                }
                            ],
                            "demand": [
                                0
                            ]
                        }
                    ]
                }
            },
            {
                "id": "E",
                "tasks": {
                    "deliveries": [
                        {
                            "places": [
                                {
                                    "location": {
                                        "lat": 47.623208,
                                        "lng": -122.330536
                                    },
                                    "duration": 0
                                }
                            ],
                            "demand": [
                                0
                            ]
                        }
                    ]
                }
            },
            {
                "id": "F",
                "tasks": {
                    "deliveries": [
                        {
                            "places": [
                                {
                                    "location": {
                                        "lat": 47.621933,
                                        "lng": -122.334567
                                    },
                                    "territoryIds": [
                                        "South-East"
                                    ],
                                    "duration": 0
                                }
                            ],
                            "demand": [
                                0
                            ]
                        }
                    ]
                }
            }
```

--------------------------------

### ForbiddenErrorResponse Example

Source: https://docs.here.com/tour-planning/openapi/api.yaml

Example response for a forbidden request due to insufficient authorization.

```json
{
  "error": "Forbidden",
  "error_description": "These credentials do not authorize access."
}
```
Tokens:
Raw