Jendela waktu

Jendela waktu menentukan waktu untuk peristiwa di rute. Peristiwa ini dapat mencakup awal dan akhir rute pengemudi, waktu pengambilan dan pengiriman terjadwal, atau durasi seluruh rute.

Jendela waktu dapat mendukung tujuan seperti:

• Memprioritaskan penyelesaian pengambilan dan pengiriman dalam jangka waktu yang ditentukan.
• Merencanakan rute untuk beroperasi dalam jam kerja keseluruhan.
• Memastikan kendaraan memulai dan mengakhiri rute dalam jangka waktu yang ditentukan.

Struktur

Seperti yang ditunjukkan dalam diagram, jendela waktu disusun sebagai berikut:

• globalStartTime dan globalEndTime adalah properti ShipmentModel
• timeWindows adalah properti:
  • pickups di dalam Shipment.
  • deliveries di dalam Shipment.
• startTimeWindows dan endTimeWindows adalah properti Vehicle.

Checklist penting

Checklist berikut menjelaskan pengetahuan penting yang mencegah potensi kesalahan terkait jendela waktu. Daftar ini dapat membantu Anda memvalidasi permintaan dan memecahkan masalah respons.

Properti

Tabel berikut menjelaskan properti jendela waktu global.

Tabel berikut menjelaskan properti jendela waktu dalam pengiriman dan kendaraan.

Tabel berikut menjelaskan properti jenis pesan TimeWindow.

Contoh

Bagian ini membahas tiga jenis contoh:

• Contoh kode yang mengilustrasikan struktur jendela waktu.
• Contoh skenario yang menunjukkan salah satu cara menggunakan jendela waktu untuk mencapai tujuan bisnis.
• Contoh permintaan yang menyertakan nilai yang ditetapkan dalam contoh skenario.

Contoh kode

Bagian berikut menunjukkan contoh kode dari berbagai jenis jendela waktu.

Jendela waktu global

Contoh kode berikut menunjukkan struktur jendela waktu global:

{
  "model": {
    "globalStartTime": "YYYY-MM-DDTHH:MM:SSZ",
    "globalEndTime": "YYYY-MM-DDTHH:MM:SSZ",
    "shipments": [ ... ],
    "vehicles": [ ... ]
  }
}

Jendela waktu pengambilan dan pengiriman

Contoh kode berikut menunjukkan struktur jendela waktu dalam pengambilan dan pengiriman pengiriman:

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "timeWindows": [
              {
                "startTime": "YYYY-MM-DDTHH:MM:SSZ",
                "endTime": "YYYY-MM-DDTHH:MM:SSZ"
              }
            ]
          }
        ],
        "deliveries": [
          {
            "timeWindows": [
              {
                "startTime": "YYYY-MM-DDTHH:MM:SSZ",
                "endTime": "YYYY-MM-DDTHH:MM:SSZ"
              }
            ]
          }
        ]
      }
    ],
    "vehicles": [ ... ]
  }
}

Jendela waktu kendaraan

Contoh kode berikut menunjukkan struktur jendela waktu kendaraan:

{
  "model": {
    "shipments": [ ... ],
    "vehicles": [
      {
        "startTimeWindows": [
          {
            "startTime": "YYYY-MM-DDTHH:MM:SSZ",
            "endTime": "YYYY-MM-DDTHH:MM:SSZ"
          }
        ],
        "endTimeWindows": [
          {
            "startTime": "YYYY-MM-DDTHH:MM:SSZ",
            "endTime": "YYYY-MM-DDTHH:MM:SSZ"
          }
        ]
      }
    ]
  }
}

Contoh skenario

Bagian ini menggunakan skenario bisnis penitipan. Contoh ini mengoptimalkan rute untuk mengambil dan mengantar dari dua rumah yang berbeda, dan pemiliknya memiliki jendela waktu pengambilan dan pengantaran yang sama. Pengoptimal harus menghormati jam operasional tempat penitipan anak, jendela waktu penjemputan dan pengantaran khusus untuk pelanggan, dan jam kerja pengemudi.

Untuk contoh ini, nilai properti dalam permintaan adalah sebagai berikut:

Diagram berikut mengilustrasikan jendela waktu yang memengaruhi rute ini.

Dalam skenario ini, seperti yang diilustrasikan oleh diagram, jendela waktu berfungsi sebagai berikut:

• Jendela waktu global mewakili jam kerja bisnis penitipan, dan semua jendela waktu lainnya harus berada di dalam jendela waktu ini.
• Pengambilan dan pengiriman memiliki timeWindows sendiri pada awal dan akhir hari.
• startTimeWindows kendaraan memberi operator kendaraan jangka waktu untuk memulai pekerjaan, dan endTimeWindows memberikan jangka waktu lain untuk menyelesaikan hari kerja.
• Waktu mulai startTimeWindow pertama dan waktu berakhir terakhir endTimeWindow menentukan jam kerja kendaraan, yang dalam hal ini, sama dengan jendela waktu global.

Contoh permintaan

Contoh berikut menunjukkan struktur permintaan optimizeTours yang menggabungkan nilai jendela waktu contoh skenario.

{
  "model": {
    "globalStartTime": "2023-01-13T07:00:00Z",
    "globalEndTime": "2023-01-13T19:00:00Z",
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.8024,
              "longitude": -122.4058
            },
            "timeWindows": [
              {
                "startTime": "2023-01-13T07:30:00Z",
                "endTime": "2023-01-13T09:00:00Z"
              }
            ]
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            },
            "timeWindows": [
              {
                "startTime": "2023-01-13T17:00:00Z",
                "endTime": "2023-01-13T18:30:00Z"
              }
            ]
          }
        ]
      },
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.7359,
              "longitude": -122.5011
            },
            "timeWindows": [
              {
                "startTime": "2023-01-13T07:30:00Z",
                "endTime": "2023-01-13T09:00:00Z"
              }
            ]
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            },
            "timeWindows": [
              {
                "startTime": "2023-01-13T17:00:00Z",
                "endTime": "2023-01-13T18:30:00Z"
              }
            ]
          }
        ]
      }
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "endLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "costPerHour": 27,
        "startTimeWindows": [
          {
            "startTime": "2023-01-13T07:00:00Z",
            "endTime": "2023-01-13T07:15:00Z"
          }
        ],
        "endTimeWindows": [
          {
            "startTime": "2023-01-13T18:45:00Z",
            "endTime": "2023-01-13T19:00:00Z"
          }
        ]
      }
    ]
  }
}

Jendela waktu fleksibel

Jendela waktu dapat digunakan sebagai batasan fleksibel dengan menentukan softStartTime dan softEndTime dalam jenis pesan TimeWindow. Hal ini memungkinkan pengoptimal menyimpang dari jendela waktu yang ditentukan dengan biaya tertentu, memprioritaskan pengoptimalan keseluruhan daripada kepatuhan ketat terhadap jangka waktu jika menguntungkan.

Jendela waktu fleksibel memiliki batasan penggunaan berikut:

• Jendela waktu fleksibel tidak dapat diterapkan ke globalStartTime dan globalEndTime karena tidak menggunakan jenis pesan TimeWindow.
• Jendela waktu fleksibel hanya berlaku jika ada satu TimeWindow dalam daftar.

Properti

Tabel berikut menjelaskan properti batasan fleksibel untuk jendela waktu.

Contoh kode

Contoh berikut menunjukkan struktur properti batasan fleksibel dari jenis pesan TimeWindow:

    {
      "softStartTime": "SOFT_START_TIME",
      "softEndTime": "SOFT_END_TIME",
      "costPerHourBeforeSoftStartTime": COST_BEFORE_START_TIME,
      "costPerHourAfterSoftEndTime": COST_AFTER_END_TIME
    }