Temel yapı (ShipmentModel, Shipment ve Vehicle)

Rota Optimizasyonu API'nin amacı, bir araç filosu için bir dizi konumu ziyaret edecek rotalar planlamaktır. OptimizeToursRequest nesnesi, bu araçların ve konumların özelliklerini tanımlar ve her uç noktanın istek gövdesinin birincil yapısıdır.

OptimizeToursRequest nesnesinin temel yapısı aşağıdaki gibidir:

• model alanında, iki önemli alan içeren bir ShipmentModel mesajı bulunur:
  • Bir veya daha fazla Shipment mesajı içeren bir shipments alanı.
  • Bir veya daha fazla Vehicle mesajı içeren bir vehicles alanı.

Bu dokümanda aşağıdaki ileti türleri açıklanmaktadır:

• ShipmentModel: Gönderimlerin, mevcut araçların ve aralarındaki ilişkileri açıklayan diğer nesnelerin listesini tutar.
• Shipment: Bir aracın ziyaret edeceği konumları tanımlar. Bu noktalar, teslim alınacak ve teslim edilecek gerçek paketleri veya araç sürücüsünün hizmet verdiği yerleri temsil edebilir.
• Vehicle: Kargo konumları arasındaki nakliye aracını belirtir. Her araç, gerçek bir araca veya yaya olarak hareket eden bir kişiye karşılık gelir.

ShipmentModel

ShipmentModel, rota optimizasyon probleminin öğelerini içerir. Kısıtlamaları dikkate alıp genel maliyeti en aza indirirken bir dizi araç tarafından gerçekleştirilebilecek bir dizi gönderi içerir.

Aşağıdaki tabloda, ShipmentModel ile ilgili bazı özellikler açıklanmaktadır:

ShipmentModel özelliğindeki özelliklerin tam listesi için referans dokümanlarına bakın.

ShipmentModel Örnek

Bu örnekte, köpek bakım hizmeti sunuyorsunuz ve isteğinizi oluşturmaya başlıyorsunuz. Gönderimleri ve araçları daha sonra tanımlayacaksınız ancak çalışma saatlerinizi ve saatlik işletme maliyetinizi ayarlayarak başlamak istiyorsunuz.

Bu örnekte, isteğinizde ShipmentModel mülk değerleri şunlardır:

Aşağıda, örnek senaryo değerlerini içeren bir ShipmentModel mesajının kod örneği verilmiştir.

{
  "model": {
    "shipments": [
      ...
    ],
    "vehicles": [
      ...
    ],
   "globalStartTime": "2024-02-13T00:00:00.000Z",
   "globalEndTime": "2024-02-14T06:00:00.000Z"
  }
}

Shipment

Shipment mesaj türü, teslim edilebilecek bir gönderinin veya bir rotada gerçekleştirilebilecek hizmetin mülk yapısını tanımlar.

Diyagramda gösterildiği gibi:

• Shipment mesajı, gerçek bir gönderim veya hizmetle ilgili tüm bilgileri içerir.
• Tüm Shipment mesajları shipments alanında belirtilir.
• shipments alanında bir veya daha fazla Shipment mesajı bulunur.

Shipment mesajı için en az bir pickups veya deliveries nesnesi gerekir. Bu nesnelerin tanımı şu şekildedir:

• pickups, gönderinin teslim alma konumunu tanımlar.
• deliveries, gönderinin teslimat konumunu tanımlar.
• Hem pickups hem de deliveries, konumları ve diğer ayrıntıları tanımlayan bir VisitRequest mesaj türü içerir.

Aşağıdaki tabloda, Shipment mesajındaki pickups ve deliveries yapılandırmasına göre farklı senaryolar açıklanmaktadır.

Shipment içindeki özelliklerin tam listesi için referans dokümanlarına bakın.

Shipment Örnek

Bu örnekte, köpekleri evlerinden alıp gündüz bakım merkezinize götürdüğünüz bir köpek bakım hizmeti sunuyorsunuz. İki köpeğin teslim alma konumunu işletmeniz olarak, teslimat konumunu ise ev olarak ayarlamak istiyorsunuz:

• İlk köpek evi San Francisco'daki Coit Kulesi'ndedir. Bu konumun koordinatları 37,8024 enlem ve -122,4058 boylamdır.
• İkinci köpeğin evi San Francisco'daki South Sunset Playground Park'ta bulunuyor. Bu konumun koordinatları 37,7359 enlem ve -122,5011 boylamdır.
• Köpek bakım merkeziniz San Francisco'daki Mission Dolores Park'ta. Bu konumun koordinatları 37,759773 enlem ve -122,427063 boylamdır.

Aşağıda, shipments nesnesinin örnek koordinatları içeren iki Shipmentileti türü barındırdığı bir Shipment iletisinin kod örneği verilmiştir.

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.8024,
              "longitude": -122.4058
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            }
          }
        ]
      },
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.7359,
              "longitude": -122.5011
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            }
          }
        ]
      }
    ],
    "vehicles": [
    ...
    ]
  }
}

Vehicle

Vehicle ileti türü, bir rotada kargo gerçekleştirebilen bir aracın mülk yapısını tanımlar.

Şemada gösterildiği gibi:

• Vehicle mesajı, gerçek bir aracın tüm bilgilerini içerir.
• Tüm Vehicle mesajları vehicles alanında belirtilir.
• vehicles alanında birden fazla Vehicle mesajı var.

Aşağıdaki tabloda, Vehicle öğesinin bazı alakalı özellikleri açıklanmaktadır.

Vehicle Örnek

Bu örnekte, köpek bakım hizmeti veriyorsunuz ve aracınızın günün başında ve sonunda konumunu ve ne kadar benzin harcadığını tanımlamak istiyorsunuz. ShipmentModel nesnesinin globalStartTime ve globalEndTime mülklerinde tanımladığınız saatlerle eşleştiği için aracın çalışma saatlerini belirtmeniz gerekmez.

Bu örnekte, isteğinizde Vehicle mülk değerleri şunlardır:

Aşağıda, örnek senaryo değerlerini içeren bir Vehicle mesajının kod örneği verilmiştir.

{
  "model": {
    "shipments": [
    ...
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "endLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "costPerHour": 27
      }
    ]
  }
}

Vehicle özelliğindeki özelliklerin tam listesi için referans dokümanlarına bakın.

Tam istek örneği

Aşağıdaki kod örneğinde, bu belgede gösterilen ShipmentModel, Shipment ve Vehicle örnekleri birleştirilerek eksiksiz bir istek örneği sağlanmaktadır.

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.8024,
              "longitude": -122.4058
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            }
          }
        ]
      },
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.7359,
              "longitude": -122.5011
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            }
          }
        ]
      }
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "endLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "costPerHour": 27
      }
    ],
    "globalStartTime": "2024-02-13T00:00:00.000Z",
    "globalEndTime": "2024-02-14T06:00:00.000Z"
  }
}