OptimizeToursResponse

Her bir aracın izlediği rotaları, atlanan gönderileri ve çözümün toplam maliyetini içeren bir tur optimizasyonu problemini çözdükten sonra verilen yanıt.

JSON gösterimi 
{
  "routes": [
    {
      object (ShipmentRoute)
    }
  ],
  "requestLabel": string,
  "skippedShipments": [
    {
      object (SkippedShipment)
    }
  ],
  "validationErrors": [
    {
      object (OptimizeToursValidationError)
    }
  ],
  "metrics": {
    object (Metrics)
  }
}
Alanlar
routes[]

object (ShipmentRoute)

Her araç için hesaplanan rotalar; i'inci rota, modeldeki i'inci araca karşılık gelir.
requestLabel

string

İstekte bir etiket belirtilmişse OptimizeToursRequest.label öğesinin kopyası.
skippedShipments[]

object (SkippedShipment)

Atlanan tüm gönderimlerin listesi.
validationErrors[]

object (OptimizeToursValidationError)

Bağımsız olarak tespit edebildiğimiz tüm doğrulama hatalarının listesi. OptimizeToursValidationError mesajı için "ÇOKLU HATA" açıklamasına bakın. solvingMode değeri DEFAULT_SOLVE olduğunda bu, hatalar yerine uyarılar içerir.
metrics

object (Metrics)

Bu çözümün süresi, mesafesi ve kullanım metrikleri.

OptimizeToursValidationError

OptimizeToursRequest doğrulanırken karşılaşılan hata veya uyarıyı açıklar.

JSON gösterimi 
{
  "code": integer,
  "displayName": string,
  "fields": [
    {
      object (FieldReference)
    }
  ],
  "errorMessage": string,
  "offendingValues": string
}
Alanlar
code

integer

Doğrulama hatası, her zaman mevcut olan (code, displayName) çifti ile tanımlanır.

Bu bölümün ardından gelen alanlar, hatayla ilgili daha fazla bağlam bilgisi sağlar.

MULTIPLE ERRORS: Birden fazla hata olduğunda doğrulama işlemi, bunların birkaçını döndürmeye çalışır. Tıpkı bir derleyici gibi, bu da kusursuz bir süreç değildir. Bazı doğrulama hataları "önemli" olur. Bu, doğrulama işleminin tamamını durduracağı anlamına gelir. Bu durum, diğerlerinin yanı sıra displayName="UNSPECIFIED" hataları için de geçerlidir. Bazı hatalar, doğrulama işleminin diğer hataların atlanmasına neden olabilir.

KARARLILIĞ: code ve displayName çok kararlı olmalıdır. Ancak zamanla yeni kodlar ve görünen adlar görünebilir. Bu da, yeni hata eskisini gizlediğinden belirli (geçersiz) bir isteğin farklı (code, displayName) bir çift oluşturmasına neden olabilir. Örneğin, "BİRDEN ÇOK HATA" konusuna bakın.
displayName

string

Hatanın görünen adı.
fields[]

object (FieldReference)

Hata bağlamı 0, 1 (çoğu zaman) veya daha fazla alan içerebilir. Örneğin, 4 numaralı araca ve 2 numaralı gönderinin ilk teslimine referans verilebilir:

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 subField {name: "pickups" index: 0} }

Bununla birlikte, belirli bir hata kodu için fields işlevinin kardinalitesinin değişmemesi gerektiğini unutmayın.
errorMessage

string

Hatayı açıklayan, kullanıcıların okuyabileceği bir dize. code ile errorMessage arasında 1:1 eşleme vardır (kod != "UNSPECIFIED" olduğunda).

STABİLİTE: Kararlı değil: Belirli bir code ile ilişkili hata mesajı zaman içinde değişebilir (umarım daha net bir şekilde). Bunun yerine lütfen displayName ve code politikalarını kullanın.
offendingValues

string

Alanların değerlerini içerebilir. Bu seçenek her zaman kullanılamayabilir. Bu modele kesinlikle güvenmemeniz ve yalnızca manuel model hata ayıklaması için kullanmanız gerekir.

FieldReference

Doğrulama hatası için bir bağlam belirtir. FieldReference, her zaman bu dosyada belirli bir alanı ifade eder ve aynı hiyerarşik yapıyı uygular. Örneğin, 5 numaralı aracın startTimeWindows numaralı öğesini aşağıdakileri kullanarak belirtebiliriz:

name: "vehicles" index: 5 subField { name: "endTimeWindows" index: 2 }

Ancak mesajın kalabalıklaşmasını önlemek için OptimizeToursRequest veya ShipmentModel gibi üst düzey varlıkları atlıyoruz.

JSON gösterimi 
{
  "name": string,
  "subField": {
    object (FieldReference)
  },

  // Union field index_or_key can be only one of the following:
  "index": integer,
  "key": string
  // End of list of possible types for union field index_or_key.
}
Alanlar
name

string

Alanın adı (ör. "vehicles".
subField

object (FieldReference)

Gerekirse yinelemeli olarak iç içe yerleştirilmiş alt alan.

Birleştirme alanı index_or_key.

index_or_key şunlardan yalnızca biri olabilir:
index

integer

Tekrarlanırsa alanın dizini.
key

string

Alan bir harita ise anahtar.

Metrikler

Tüm rotalar için toplanan genel metrikler.

JSON gösterimi 
{
  "aggregatedRouteMetrics": {
    object (AggregatedMetrics)
  },
  "skippedMandatoryShipmentCount": integer,
  "usedVehicleCount": integer,
  "earliestVehicleStartTime": string,
  "latestVehicleEndTime": string,
  "costs": {
    string: number,
    ...
  },
  "totalCost": number
}
Alanlar
aggregatedRouteMetrics

object (AggregatedMetrics)

Rotalar genelinde toplanır. Her metrik, aynı ada sahip tüm ShipmentRoute.metrics alanlarının toplamıdır (veya yüklemeler için maksimum değeridir).
skippedMandatoryShipmentCount

integer

Atlanan zorunlu kargo sayısı.
usedVehicleCount

integer

Kullanılan araç sayısı. Not: Bir araç rotası boşsa ve Vehicle.used_if_route_is_empty doğruysa araç kullanılmış kabul edilir.
earliestVehicleStartTime

string (Timestamp format)

İkinci el bir araç için en erken başlangıç zamanı. ShipmentRoute.vehicle_start_time değerindeki tüm ikinci el araçlar üzerinden minimum olarak hesaplanır.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
latestVehicleEndTime

string (Timestamp format)

Bir ikinci el aracın en son bitiş zamanı. ShipmentRoute.vehicle_end_time türündeki tüm ikinci el araçlar için maksimum değer olarak hesaplanır.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
costs

map (key: string, value: number)

Maliyetle ilgili istek alanlarına göre dökümü alınmış çözüm maliyeti. Anahtarlar, giriş OptimizeToursRequest'a göre proto yollarıdır (ör. "model.shipments.pickups.cost") ve değerler, ilgili maliyet alanı tarafından oluşturulan ve çözümün tamamında toplanan toplam maliyettir. Başka bir deyişle maliyet["model.shipments.pickups.cost"], çözüm üzerinden tüm teslim alma maliyetlerinin toplamıdır. Modelde tanımlanan tüm maliyetler, 2022/01 itibarıyla yalnızca toplu olarak raporlanan TransitionAttributes ile ilgili maliyetler hariç burada ayrıntılı olarak raporlanır.
totalCost

number

Çözümün toplam maliyeti. Maliyet haritasındaki tüm değerlerin toplamı.