Yük talepleri ve sınırları

loadDemands özelliği ShipmentModel.shipments.Shipment altında, loadLimits özelliği ise ShipmentModel.vehicles.Vehicle altında tanımlanır.

Yük talepleri ve sınırlar, kapasiteyi yönetmek için kullanabileceğiniz bir kısıtlama türüdür. Bu kısıtlama, bir gönderinin gerekli kapasitesini ve bir aracın maksimum kapasitesini belirtir. Bu sayede, rota atamalarını bu kısıtlamalara göre optimize edebilirsiniz.

Yük talepleri ve sınırları şu gibi hedefleri destekleyebilir:

  • Araçların aşırı yüklenmesini önleme
  • Gönderiler teslim alınırken ve teslim edilirken araç yüklerinin nasıl değiştiğini izleyin.
  • Ağır hizmet araçlarının ağır yük gönderileriyle eşleştirilmesine öncelik verin.

Yük talepleri ve sınırları şu özelliklerde belirtilir:

  • loadDemands, belirli bir gönderinin gerektirdiği kapasite miktarını belirtir.
  • loadLimits, belirli bir araç için maksimum kapasiteyi belirtir.

Yapı

Şemada gösterildiği gibi, yük talepleri ve sınırları aşağıdaki şekilde yapılandırılır:

Essentials yapılacaklar listesi

Aşağıdaki kontrol listesinde, yüklemeyle 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.

Özellikler

Bu bölümde, yük talepleri ve sınırlarıyla ilgili özellikler açıklanmaktadır. Bu özellikler şunlardır:

  • Yükleme türü: Yükleme talepleri ve sınırları arasında paylaşılan bir özelliktir.
  • Load ve LoadLimit: Sırasıyla yükleme taleplerinde ve yükleme sınırlarında bulunan benzersiz özellikler.

Yükleme türü

Yük türü, gönderilere ve araçlara eşit olarak uyguladığınız bir dize anahtardır. Tek bir yük türü, gönderinin yük talebinin yanı sıra aracın yük sınırı için de geçerlidir.

Yük türleri, Protocol Buffers harita türü söz dizimini kullanır. Yük türünü adlandırırken yükün türünü ve birimini açıklayan tanımlayıcılar kullanın. Örneğin: weightKg, volume_gallons, palletcount veya frequencyDaily.

Load ve LoadLimit

Load ve LoadLimit nesneleri, gönderiler ve araçlar için kapasite şartlarını tanımlamaya yönelik belirli özellikler içerir. Aşağıdaki tabloda bu özellikler açıklanmaktadır:

Nesne Ebeveyn Mülk Tesis türü Tesis açıklaması
Load loadDemands amount dize (int64 biçimi) Belirtilen türdeki gönderinin kapasite gereksinimini tanımlar.
LoadLimit loadLimits maxLoad dize (int64 biçimi) Belirtilen türdeki aracın maksimum yük kapasitesini tanımlar.

Örnekler

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

  • Yük taleplerinin ve sınır özelliklerinin yapısını gösteren kod örnekleri.
  • API isteğinde yük taleplerini ve sınırlarını kullanmanın bir yolunu gösteren örnek senaryo.
  • Bir istek örneği. Bu örnek, örnek senaryoda ayarlanan değerleri içerir.

Kod örnekleri

Aşağıdaki örnekte, loadDemands türünü dize, amount özelliğini ise int64 biçiminde dize olarak ayarlayabileceğiniz bir yük talebinin yapısı gösterilmektedir:

{
  "model": {
    "shipments": [ ...
      {
        "loadDemands": {
          "MATCHING_LOAD_TYPE": {
            "amount": "YOUR_LOAD_AMOUNT"
          }
        }
      }
    ],
    "vehicles": [ ...
    ]
  }
}

Aşağıdaki örnekte, yük sınırının en temel yapısı gösterilmektedir. Burada loadLimits türünü dize, maxLoad özelliğini ise int64 biçiminde dize olarak ayarlayabilirsiniz:

{
  "model": {
    "shipments": [ ...
    ],
    "vehicles": [ ...
      {
        "loadLimits": {
          "MATCHING_LOAD_TYPE": {
            "maxLoad": "YOUR_MAX_LOAD"
          }
        }
      }
    ]
  }
}

Örnek senaryo

Bu bölümde, köpek bakımı işi yaptığınız ve sınırlı sayıda kafes içeren bir araçta birkaç köpeği taşımak için rotayı optimize ettiğiniz bir senaryo açıklanmaktadır.

Her gönderim, belirli sayıda köpeği aldığınız bir durağı temsil eder. Bu örnekte, her gönderinin farklı bir teslim alma konumu vardır. Bu konum, baktığınız köpeklerin evidir. Tüm gönderilerin teslimat konumu ise aynıdır: Köpek bakım merkezinizin bulunduğu bina.

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

Ebeveyn Mülk Tür Değer Senaryo
loadDemands yükleme türü dize dogUnit Gönderinin yük türünü tanımlar. Bu örnekte, her dogUnit değerinin bir köpeği temsil ettiği dogUnit kullanılıyor.
loadDemands amount sayı 1. gönderim: 1
2. gönderim: 3
Tanımlanan yük türünün miktarını belirtir. Bu örnekte iki gönderim tanımlıyorsunuz. İlkinde bir köpek, ikincisinde ise 3 köpek alıyorsunuz.
loadLimits yükleme türü dize dogUnit Araca uygulanan yük sınırı türünü tanımlar. Sınırın geçerli olması için bu değer, gönderinin yük türüyle eşleşmelidir.
loadLimits maxLoad sayı 6 Aracın taşıyabileceği yük türünün maksimum miktarını belirtir. Bu örnekte, maksimum kapasitesi 6 dogUnit olan tek bir aracınız var. Her dogUnit, bir köpek kafesini temsil ediyor.

Aşağıdaki diyagramda aracın yük sınırları, her gönderinin yük talepleri ve her gönderinin aracın yük sınırlarını nasıl kullandığı gösterilmektedir:

Araç, rotaya yük sınırlarını temsil eden 6 boş alanla başlar. İlk gönderim için bir köpek, ikinci gönderim için üç köpek yeri gerekiyor. Aracın son durumunda 6 yerden 4'ü dolu, 2'si ise boş kalır.

Bu örnekte, her gönderinin yük talepleri ve aracın yük sınırları aşağıdaki etkilere sahiptir:

  • Araç 6 köpeğe kadar taşıma kapasitesine sahip olduğundan ve yalnızca 4 köpek alacağınız için optimize edici, köpekleri taşıyacak araç için rota oluşturmada sorun yaşamayacaktır.

  • Araçta 6 dogUnit yük sınırı olması, bu araçta yalnızca iki köpek daha taşıyabileceğiniz anlamına da gelir.

  • Köpek sayısı yük sınırından fazlaysa optimizasyon aracı bir alımı atlar veya uygun bir araca atar.

Önceden tanımlanmış türler olmadığını unutmayın. Bu örnekte, köpeklerin ağırlığını sınırlamak için yük türünü köpek birimlerinden ağırlık birimlerine veya genişliğini ya da yüksekliğini sınırlamak için doğrusal ölçülere değiştirebilirsiniz. Bu esneklik sayesinde yük taleplerini ve sınırlarını kendi ihtiyaçlarınıza göre ayarlayabilirsiniz.

İstek örneği

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

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.8024,
              "longitude": -122.4058
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            }
          }
        ],
        "label": "One bernese mountain dog",
        "loadDemands": {
          "dogUnit": {
            "amount": "1"
          }
        }
      },
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.7359,
              "longitude": -122.5011
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            }
          }
        ],
        "label": "Three chihuahuas",
        "loadDemands": {
          "dogUnit": {
            "amount": "3"
          }
        }
      }
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "endLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "loadLimits": {
          "dogUnit": {
            "maxLoad": "6"
          }
        },
        "costPerKilometer": 1.0
      }
    ]
  }
}

Bu örnektekinin aksine, bir gönderinin birden fazla yük talebi olabileceğini ve bir aracın birden fazla yük sınırı olabileceğini unutmayın. Bu sayede, filonuzun rotalarını optimize ederken dikkate alınması gereken karmaşık kısıtlamalar sağlayabilirsiniz.

Yumuşak yükleme sınırları

Bir aracın loadLimits bölümüne softMaxLoad ve costPerUnitAboveSoftMax ekleyerek yük sınırlarını esnek kısıtlamalar olarak ayarlayabilirsiniz. Bu, optimizasyon aracının, yük sınırına sıkı sıkıya bağlı kalmak yerine rotayı tamamlamaya öncelik vererek bir maliyet karşılığında aracın maksimum yükünü aşmasına olanak tanır.

Hem kesin hem de esnek yük sınırı belirlemek için maxLoad ve softMaxLoad öğelerini birlikte kullanabilirsiniz. Bu durumda, softMaxLoad, aşılabilecek yükü belirler ve maxLoad, aşılamayacak sabit bir sınır belirler. İkisi de kullanıldığında maxLoad, softMaxLoad değerinden büyük olmalıdır.

Özellikler

Aşağıdaki tabloda, yük talepleri ve sınırları için esnek kısıtlama özellikleri açıklanmaktadır.

Ebeveyn Mülk adı Tesis türü Tesis açıklaması
loadLimits softMaxLoad dize (int64 biçimi) Bir araç için tercih edilen maksimum yük. Aracın yükü bu değeri aşarsa maliyet oluşur.
loadLimits costPerUnitAboveSoftMax sayı softMaxLoad üzerindeki yük birimi başına maliyet. Bu alan, softMaxLoad kullanılırken zorunludur. Maliyetler hakkında daha fazla bilgi edinmek için Maliyet modeli temel kavramına bakın.

Kod örneği

Aşağıdaki örnekte, loadLimits öğesinin esnek kısıtlama özelliklerinin yapısı gösterilmektedir:

{
   "loadLimits": {
        "LOAD_TYPE": {
          "softMaxLoad": "LOAD_AMOUNT",
          "costPerUnitAboveSoftMax": COST_PER_UNIT
        }
      }
}