Evaluate

Evaluation is a very important part of the optimization process. It is important to know how to evaluate the quality of
a solution. In this example we will show you how to evaluate a solution.
All evaluation requests require for every Job a planned arrival time and a planned resource. If you don't provide this
information, the evaluation will fail.

Example:

{
  "name": "JOB-1",
  "location": {
    "latitude": 50.54963315022148,
    "longitude": 4.848855475505483
  },
  "plannedArrival": "2023-01-13T08:00:00",
  "plannedResource": "R-1",
  "duration": 600
}

Our solver will recalculate the necessary travel time and return through the "PLANNED_ARRIVAL" constraint how much
deviation there is from actual arrival vs planned arrival.

In this case we send 5 jobs to be assigned in sequence. When we look at the explanation, we see that total travel time
is 9823 seconds or about 2,5 hours.
There is some deviation from planned arrival time, but this is not a problem. The solver will always try to minimize
travel time. The deviation from planned arrival has no impact on the solve process, just to show the result.

{
  "resources": [
    {
      "name": "R-1",
      "start": {
        "latitude": 50.923554431590595,
        "longitude": 4.890691212789399
      },
      "shifts": [
        {
          "from": "2023-01-13T08:00:00",
          "to": "2023-01-13T18:30:00"
        }
      ]
    }
  ],
  "jobs": [
    {
      "name": "JOB-1",
      "location": {
        "latitude": 50.54963315022148,
        "longitude": 4.848855475505483
      },
      "plannedArrival": "2023-01-13T08:00:00",
      "plannedResource": "R-1",
      "duration": 600
    },
    {
      "name": "JOB-2",
      "location": {
        "latitude": 50.65910297910443600,
        "longitude": 4.007987934186738
      },
      "plannedArrival": "2023-01-13T08:13:00",
      "plannedResource": "R-1",
      "duration": 600
    },
    {
      "name": "JOB-3",
      "location": {
        "latitude": 50.65310297910443600,
        "longitude": 4.007987934186738
      },
      "plannedArrival": "2023-01-13T08:14:00",
      "plannedResource": "R-1",
      "duration": 600
    },
    {
      "name": "JOB-4",
      "location": {
        "latitude": 50.69910297910443600,
        "longitude": 4.017987934186738
      },
      "plannedArrival": "2023-01-13T08:30:00",
      "plannedResource": "R-1",
      "duration": 600
    },
    {
      "name": "JOB-5",
      "location": {
        "latitude": 50.65310297910443600,
        "longitude": 4.027987934186738
      },
      "plannedArrival": "2023-01-13T08:45:00",
      "plannedResource": "R-1",
      "duration": 600
    }
  ],
  "options": {
    "maxSuggestions": 3
  }
}

{
  "score": {
    "hardScore": 0,
    "mediumScore": 0,
    "softScore": -10632,
    "feasible": true
  },
  "trips": [
    {
      "visits": [
        {
          "arrival": "2023-01-13T09:02:22",
          "job": "JOB-1",
          "location": "50.54963315022148;4.848855475505483",
          "breakTime": 0
        },
        {
          "arrival": "2023-01-13T10:19:35",
          "job": "JOB-2",
          "location": "50.65910297910444;4.007987934186738",
          "breakTime": 0
        },
        {
          "arrival": "2023-01-13T10:38:07",
          "job": "JOB-3",
          "location": "50.65310297910444;4.007987934186738",
          "breakTime": 0
        },
        {
          "arrival": "2023-01-13T11:03:21",
          "job": "JOB-4",
          "location": "50.69910297910444;4.017987934186738",
          "breakTime": 0
        },
        {
          "arrival": "2023-01-13T11:23:43",
          "job": "JOB-5",
          "location": "50.65310297910444;4.027987934186738",
          "breakTime": 0
        }
      ],
      "resource": "R-1",
      "date": "2023-01-13",
      "departureTime": "2023-01-13T08:00:00",
      "waitTime": 0,
      "travelTime": 9823,
      "workTime": 12823,
      "serviceTime": 3000
    }
  ],
  "totalTravelTimeInSeconds": 9823,
  "totalServiceTimeInSeconds": 3000,
  "workloadFairness": 1,
  "status": "SOLVED"
}

{
  "score": {
    "hardScore": 0,
    "mediumScore": 0,
    "softScore": -10632,
    "feasible": true
  },
  "unresolved": [
    {
      "constraint": "PLANNED_ARRIVAL",
      "score": "-808soft"
    },
    {
      "constraint": "MINIMISE_TRIP_USAGE",
      "score": "-1soft"
    },
    {
      "constraint": "TRAVEL_TIME",
      "score": "-9823soft"
    }
  ]
}