Zaman aralıkları

Zaman aralıkları, bir rotadaki etkinliklerin zamanlamasını belirtir. Bu etkinlikler arasında bir sürücünün rotasının başlangıcı ve bitişi, planlanan teslim alma ve teslimat saatleri veya tüm rotanın süresi yer alabilir.

Zaman aralıkları aşağıdaki gibi hedefleri destekleyebilir:

• Belirtilen zaman aralıklarında teslim alma ve teslimat işlemlerini tamamlamaya öncelik verin.
• Genel çalışma saatleri içinde çalışacak şekilde rotalar planlayın.
• Araçların rotalara belirtilen zaman aralıklarında başlayıp bitirmesini sağlayın.

Yapı

Diyagramda gösterildiği gibi, zaman aralıkları aşağıdaki şekilde yapılandırılır:

• globalStartTime ve globalEndTime, ShipmentModel özellikleridir.
• timeWindows, aşağıdaki öğelerin özellikleridir:
  • Shipment içinde pickups.
  • Shipment içinde deliveries.
• startTimeWindows ve endTimeWindows, Vehicle özellikleridir.

Essentials kontrol listesi

Aşağıdaki kontrol listesinde, zaman aralıklarıyla ilgili olası hataları önlemek için gerekli bilgiler açıklanmaktadır. Bu liste, isteğinizi doğrulamanıza ve yanıtınızla ilgili sorunları gidermenize yardımcı olabilir.

Tüm kargo ve araç zaman aralıkları globalStartTime ile globalEndTime zaman aralığında olmalıdır.

Gönderiler ve araçlar için zaman aralıkları TimeWindow mesaj türünü kullanmalıdır.

globalStartTime ve globalEndTime değerleri, TimeWindow mesaj türünü kullanan diğer zaman aralıklarının aksine zaman damgalarıdır.

Belirli bir gönderi ve araç için birden fazla TimeWindow nesneniz olabilir.

Bir Vehicle iki tür zaman aralığı özelliğine sahiptir: startTimeWindows ve endTimeWindows. Bu özellikler, bir aracın rotalarına sırasıyla başlaması ve rotalarını bitirmesi gereken bir zaman aralığını tanımlar.

Gönderiler için timeWindows yalnızca teslim alma veya teslimatın başlangıç zamanı için geçerlidir. Ziyaret süresi, zaman aralığını aşabilir ancak aracın çalışma saatleri ve genel zaman aralığı içinde olmalıdır.

Özellikler

Aşağıdaki tabloda, genel zaman aralığı özellikleri açıklanmaktadır.

Mülk	Biçim	Açıklama
globalStartTime	Timestamp	Herhangi bir etkinlik için en erken saat.
globalEndTime	Timestamp	Herhangi bir etkinlik için en geç saat.

Aşağıdaki tabloda, gönderiler ve araçlardaki zaman aralığı özellikleri açıklanmaktadır.

Ebeveyn	Mülk	Biçim	Açıklama
Shipment.pickups	timeWindows	TimeWindow mesaj türleri dizisi.	Gönderi teslim alma zaman aralıklarını belirtir.
Shipment.deliveries	timeWindows		Kargo teslimatı için zaman aralıklarını belirtir.
Vehicle	startTimeWindows		Bir aracın çalışma planının başlangıç zamanını belirtir.
	endTimeWindows		Bir aracın çalışma planının bitiş zamanını belirtir.

Not: Araç programları, araç operatörlerinin mola verebileceği dönemleri tanımlayan BreakRule'lerden de etkilenebilir. Daha fazla bilgi için BreakRule referans belgelerine bakın.

Aşağıdaki tabloda, TimeWindow mesaj türünün özellikleri açıklanmaktadır.

Mülk	Biçim	Açıklama
startTime	Dize (RFC3339 UTC "Zulu" biçimi)	Zaman aralığının başlangıcı.
endTime	Dize (RFC3339 UTC "Zulu" biçimi)	Zaman aralığının sonu.

Örnekler

Bu bölümde üç tür örnek ele alınmaktadır:

• Zaman aralıklarının yapısını gösteren kod örnekleri.
• Zaman aralıklarını kullanarak işletme hedefine ulaşmanın bir yolunu gösteren örnek senaryo.
• Örnek senaryoda ayarlanan değerleri içeren istek örneği.

Kod örnekleri

Aşağıdaki bölümlerde, farklı zaman aralığı türlerine ait kod örnekleri gösterilmektedir.

Genel zaman aralıkları

Aşağıdaki kod örneğinde, genel zaman aralıklarının yapısı gösterilmektedir:

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

Teslim alma ve teslimat zaman aralıkları

Aşağıdaki kod örneğinde, bir gönderinin teslim alma ve teslimat işlemlerindeki zaman aralıklarının yapısı gösterilmektedir:

{
  "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": [ ... ]
  }
}

Araç zaman aralıkları

Aşağıdaki kod örneğinde, bir aracın zaman aralıklarının yapısı gösterilmektedir:

{
  "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"
          }
        ]
      }
    ]
  }
}

Örnek senaryo

Bu bölümde, köpek kreşi işletmesi senaryosu kullanılmaktadır. Örnekte, iki farklı evden köpek alma ve bırakma rotaları optimize ediliyor. Köpek sahiplerinin alma ve bırakma zaman aralıkları aynı. Optimizasyon aracı, kreşin çalışma saatlerine, müşterilerin belirli alma ve bırakma zaman aralıklarına ve sürücünün çalışma saatlerine uymalıdır.

Bu örnekte, istekteki özellik değerleri şunlardır:

Ebeveyn	Mülk	Değer	Senaryo
ShipmentModel	globalStartTime	2023-01-13T07:00:00Z	Köpek kreşinizin açılış saatini temsil eder. Bu saatten önce teslim alma veya teslimat yapılamaz.
ShipmentModel	globalEndTime	2023-01-13T19:00:00Z	Köpek kreşinizin kapanış saatini temsil eder. Tüm teslim alma ve teslimat işlemleri bu zamana kadar tamamlanmalıdır.
Shipment.pickups	timeWindows	startTime: 2023-01-13T07:30:00Z	Müşterinin evinden köpek alma için kabul edilebilir zaman aralığını tanımlar. Bu örnekte, her iki müşteriye de teslim alma için 07:30-09:00 saatleri arasında müsait olmalarını söylediniz.
		endTime: 2023-01-13T09:00:00Z
Shipment.deliveries	timeWindows	startTime: 2023-01-13T17:00:00Z	Köpeğin müşterinin evine bırakılabileceği kabul edilebilir zaman aralığını tanımlar. Bu örnekte, her iki müşteriye de köpeklerinin 17:00 ile 18:30 arasında bırakılacağını söylediniz.
		endTime: 2023-01-13T18:30:00Z
Vehicle	startTimeWindows	startTime: 2023-01-13T07:00:00Z endTime: 2023-01-13T07:15:00Z	Aracın kabul edilebilir başlangıç (07:00-07:15) ve bitiş (17:00-17:15) aralığını tanımlar.
	endTimeWindows	startTime: 2023-01-13T18:45:00Z endTime: 2023-01-13T19:00:00Z

Aşağıdaki diyagramda bu rotayı etkileyen zaman aralıkları gösterilmektedir.

Bu senaryoda, diyagramda gösterildiği gibi zaman pencereleri aşağıdaki gibi çalışır:

• Genel zaman aralığı, köpek kreşinin çalışma saatlerini gösterir ve diğer tüm zaman aralıkları bu zaman aralığı içinde olmalıdır.
• Teslim alma ve teslimatların günün başında ve sonunda kendi timeWindows vardır.
• Aracın startTimeWindows, araç operatörüne çalışmaya başlaması gereken bir zaman aralığı verir ve endTimeWindows, gününü bitirmesi gereken başka bir zaman aralığı sağlar.
• İlk startTimeWindow'nin başlangıç zamanı ve son endTimeWindow'nin bitiş zamanı, aracın çalışma saatlerini tanımlar. Bu örnekte, çalışma saatleri genel zaman aralığıyla aynıdır.

İstek örneği

Aşağıdaki örnekte, örnek senaryo zaman aralığı değerlerini içeren bir optimizeTours isteğinin yapısı gösterilmektedir.

{
  "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"
          }
        ]
      }
    ]
  }
}

Esnek zaman aralıkları

Zaman aralıkları, bir TimeWindow mesaj türünde softStartTime ve softEndTime tanımlanarak esnek kısıtlamalar olarak kullanılabilir. Bu sayede, optimizasyon aracı belirtilen maliyetle belirtilen zaman aralığından sapabilir. Bu durumda, faydalı olduğunda zaman aralıklarına sıkı sıkıya bağlı kalmak yerine genel optimizasyona öncelik verilir.

Esnek zaman aralıklarında aşağıdaki kullanım sınırlamaları geçerlidir:

• TimeWindow mesaj türünü kullanmadıkları için globalStartTime ve globalEndTime'e uygulanamazlar.
• Yalnızca listede tek bir TimeWindow olduğunda geçerlidir.

Özellikler

Aşağıdaki tabloda, zaman aralıklarıyla ilgili esnek kısıtlama özellikleri açıklanmaktadır.

Mülk adı	Biçim	Tesis açıklaması
softStartTime	Zaman damgası	Esnek zaman aralığının başlangıcını belirtir. Bu saatten önce bir etkinlik gerçekleşirse maliyet oluşur.
softEndTime	Zaman damgası	Esnek zaman aralığının sonunu belirtir. Bu süreden sonra bir etkinlik gerçekleşirse maliyet oluşur.
costPerHourBeforeSoftStartTime	sayı	Bir etkinlik softStartTime tarihinden önce başladığında saat başına tahakkuk eden maliyet. Bu özellik, softStartTime kullanılırken zorunludur. Maliyetleri uygulama hakkında daha fazla bilgi edinmek için Maliyet modeli temel kavramına bakın.
costPerHourAfterSoftEndTime	sayı	Bir etkinlik softEndTime tarihinden sonra sona erdiğinde saat başına tahakkuk eden maliyet. Bu özellik, softEndTime kullanılırken zorunludur. Maliyetlerin nasıl uygulanacağı hakkında daha fazla bilgi edinmek için Maliyet modeli temel kavramına bakın.

Kod örneği

Aşağıdaki örnekte, TimeWindow mesaj türünün esnek kısıtlama özelliklerinin yapısı gösterilmektedir:

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