Bu sayfa, Cloud Translation API ile çevrilmiştir.

Maliyet modeli

Maliyet özellikleri, ShipmentModel.shipments.Shipment ve ShipmentModel.vehicles.Vehicle altında tanımlanır.

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 şekilde yapılandırılır:

Shipment, penaltyCost özelliğini içerir.
Vehicle aşağıdaki özellikleri içerir:

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.

Optimizasyon için maliyetler gereklidir. Maliyet içermeyen bir istek, API'nin uzun aktarmalı anlamsız rotalar döndürmesine neden olur.

Araç başına en az bir costPerHour, costPerKilometer veya costPerTraveledHour belirtmelisiniz.

Daha karmaşık optimizasyon hedeflerine ulaşmak için istek başına birden fazla maliyet özelliği kullanabilirsiniz.

Maliyet özellikleri belirli bir para birimine bağlı değildir.

Bir maliyet biriminin temsil ettiği değere siz karar verirsiniz ve bu değer, istekteki tüm maliyet özelliklerine uygulanır.

Özellikler

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

Ebeveyn	Mülk adı	Tesis türü	Şu başına maliyet:	Tesis açıklaması
`Shipment`	`penaltyCost`	sayı	Atlanan gönderim	Gönderimin atlanması nedeniyle oluşan maliyet. API, tamamlanma maliyeti ceza maliyetini aştığında gönderimi atlar. `penaltyCost` ayarı, daha yüksek maliyetli gönderilerin teslimatına öncelik verir. Kargo `penaltyCost` ayarlanmadığında kargo zorunlu olur. Bir kargonun `penaltyCost` değerinin açıkça sıfır olarak ayarlanması, diğer kısıtlamalar gerektirmediği sürece API'nin kargoyu her zaman atlamasına neden olur.
`Vehicle`	`fixedCost`	sayı	Kargo	Bu araç bir gönderiyi işlemek için kullanılıyorsa sabit maliyet uygulanır.
	`costPerHour`	sayı	Saat	Transit, bekleme, ziyaret ve mola süreleri dahil olmak üzere araç çalıştırmanın saatlik maliyeti. Bu maliyet arttıkça optimizasyon aracı, en kısa rotalar olmayabilecek daha hızlı rotalar bulmaya çalışır. Bu özellik, basitliği ve eksiksizliği nedeniyle araç başına etkili bir bağımsız maliyet olabilir.
	`costPerKilometer`	sayı	Kilometre	Yakıt maliyetleri ve amortize edilmiş araç bakım maliyetleri gibi, araçla kat edilen kilometre başına maliyet.
	`costPerTraveledHour`	sayı	Saat	Bekleme, ziyaret ve mola süreleri hariç olmak üzere yalnızca transit halindeyken bir aracı saatlik çalıştırmanın maliyeti. Bu ayar, daha kısa rotalar yerine daha hızlı seyahat rotalarına öncelik verir.

Örnekler

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

Maliyet modeli özelliklerinin yapısını gösteren kod örnekleri.
Maliyet modeli özelliklerini kullanarak bir işletme hedefine ulaşmanın bir yolunu gösteren örnek senaryo.
Bir istek örneği: Değerler, örnek senaryoda ayarlanır.

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şi yaptığınız 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ç operasyonlarıyla 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:

Mülk	Değer	Senaryo
`penaltyCost`	10	Müşterilerinize, köpeğini planlanan günde almadığı için uyguladığınız cezayı gösterir. Köpeği planlanan bir günde almadığınızda müşterinin hizmet toplamından 40 ABD doları indirim yapılır.
`fixedCost`	30	Araç kredisi ödemelerinizin günlük maliyetini (günde 30 ABD doları) gösterir.
`costPerKilometer`	0,08	Aracınızın kilometre başına ne kadar benzin harcadığını gösterir. Aracınızın hareket etmesi için kilometre başına 0, 15 litre yakıt gerekiyor ve bölgenizde galon başına maliyet 2 ABD doları.
`costPerHour`	27	Aracınızı sürmesi için sürücüye ödediğiniz tutarı gösterir. Sürücüye saatlik 27 ABD doları ödüyorsunuz.
`costPerTraveledHour`	2.5	Yoldayken köpekler için aracın klimasına saat başına ne kadar ödemeniz gerektiğini gösterir. Araç hareket etmediği sürece sürücü arka kapıları açabilir ve klimayı kapatabilir.

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

Aşağıdaki şemada, trafikten kaçınmak için yeşil kesikli çizgide daha uzun ancak daha hızlı bir rota seçilebileceği bir örnek gösterilmektedir.

Araç için iki olası rota vardır. Biri yeşil kesikli çizgiyle gösterilir ve daha uzundur ancak herhangi bir olay içermez. Diğeri ise kırmızı noktalı çizgiyle gösterilir ve daha kısadır ancak ortasında bir araba kazası vardır.

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 bir 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.

Maliyet modeli Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.