Maliyet modeli

Rota Optimizasyonu API'sinin temel amacı, en düşük maliyetli rotaları bulmaktır. Bu nedenle, maliyet modeli rota optimizasyonunun temel itici gücüdür.

Maliyet modeli, genel, araç ve kargo maliyetlerini belirten bir özellikler kümesidir.

Maliyet modeli özellikleri, aşağıdaki optimizasyon hedefi türlerini destekler:

• Verimli araç atamaları ve rotalar
• Uygun maliyetli teslim alma ve teslimat süreleri
• Kritik gönderilere öncelik verme

Yapı

Şemada gösterildiği gibi, maliyet modeli özellikleri aşağıdaki gibi yapılandırılır:

• Shipment, penaltyCost özelliğini içerir.
• Vehicle aşağıdaki özellikleri içerir:
  • fixedCost
  • costPerHour
  • costPerKilometer
  • costPerTraveledHour

Bu belgede yalnızca temel maliyet modeli parametreleri vurgulanmaktadır. Maliyet parametrelerinin tamamı için referans belgelerine bakın.

Essentials yapılacaklar listesi

Aşağıdaki kontrol listesinde, olası maliyetle ilgili hataları önleyen temel bilgiler açıklanmaktadır. Bu liste, isteğinizi doğrulamanıza ve yanıtınızla ilgili sorunları gidermenize yardımcı olabilir.

Özellikler

Aşağıdaki tabloda maliyet modeli özellikleri listelenmekte ve açıklanmaktadır.

Örnekler

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

• Maliyet modeli özelliklerinin yapısını gösteren kod örnekleri.
• Maliyet modeli özelliklerinin bir işletme hedefine ulaşmak için nasıl kullanılabileceğini gösteren örnek bir senaryo.
• Bir istek örneği. Bu örnek, örnek senaryoda ayarlanan değerleri içerir.

Kod örnekleri

Aşağıdaki kod örneğinde, Shipment içindeki maliyet modeli özelliklerinin yapısı gösterilmektedir:

{
  "model": {
    "shipments": [ ...
      {
        "penaltyCost": PENALTY_COST
      }
    ],
    "vehicles": [ ...
    ]
  }
}

Aşağıdaki kod örneğinde, Vehicle içindeki maliyet modeli özelliklerinin yapısı gösterilmektedir:

{
  "model": {
    "shipments": [ ...
    ],
    "vehicles": [ ...
      {
        "fixedCost": FIXED_COST,
        "costPerKilometer": KILOMETER_COST,
        "costPerHour": HOUR_COST,
        "costPerTraveledHour": TRAVELED_HOUR_COST
      }
    ]
  }
}

Örnek senaryo

Bu bölümde, köpek bakımı işletmenizin olduğu bir senaryo açıklanmaktadır. Köpekleri evlerinden almak için kullandığınız kamyonun rotasını optimize ediyorsunuz. Bu senaryoda, rota sağlarken optimizasyon aracının köpekleri alma ve araç işlemleriyle ilgili maliyetleri dikkate almasını istiyorsunuz.

Bu örnekte, bir maliyet birimi 1 ABD dolarını temsil eder. Bu durumda, isteğinizdeki maliyet modeli özellik değerleri şunlardır:

Optimizasyon aracı, maliyet parametrelerine göre kullanıcı için açık olmayan ancak optimizasyon yoluyla bulunabilen ödünler verebilir.

Aşağıdaki şemada, optimize edicinin noktalı kırmızı çizgideki trafikten kaçınmak için yeşil kesikli çizgide daha uzun ancak daha hızlı bir rota seçebileceği bir örnek gösterilmektedir.

Bu senaryoda, iki rotanın maliyet dengesi aşağıdaki gibidir:

• Yeşil kesikli çizgi, trafikten kaçınan hızlı bir rota olduğundan düşük costPerHour ve costPerTraveledHour değerine sahiptir. Bu rota, costPerKilometer yüksek olsa bile daha uygun maliyetlidir.

• Kırmızı noktalı çizgi, doğrudan rota olduğu için düşük bir costPerKilometer değerine sahip ancak trafikteki bekleme süreleri nedeniyle costPerHour ve costPerTraveledHour çok yüksek olduğundan en pahalı rota oluyor.

Optimizasyon aracı, uygun maliyetli rotalar sunmanın yanı sıra yanıt özelliklerinde teslimat rotalarının toplam maliyetlerinin bir özetini de sağlar.

İstek örneği

Aşağıdaki örnekte, örnek senaryoda ayarlanan değerleri 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
            }
          }
        ]
        "penaltyCost": 40
      }
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "endLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "fixedCost": 30,
        "costPerKilometer": 0.08,
        "costPerHour": 27,
        "costPerTraveledHour": 2.5
      }
    ]
  }
}

Yanıt özellikleri

OptimizeToursResponse mesajında, bir rotanın tamamlanması sürecinde yapılan harcamaları açıklayan maliyet özellikleri bulunur:

• metrics.costs: Maliyetle ilgili istek alanlarına göre ayrılmış, tüm rotalardaki toplam maliyet.
• metrics.totalCost: Tüm rotalardaki toplam maliyetin özeti.