Package google.maps.routeoptimization.v1

int32

Gerçekleştirilen gönderim sayısı. Bir teslim alma ve teslim etme çiftinin yalnızca bir kez sayıldığını unutmayın.

Duration

Bir rota veya çözümün toplam seyahat süresi.

Duration

Bir rota veya çözümün toplam bekleme süresi.

Duration

Bir rota veya çözümün toplam gecikme süresi.

Duration

Bir rota veya çözümün toplam ara süresi.

Duration

Bir rota veya çözümün toplam ziyaret süresi.

Duration

Toplam süre, yukarıdaki tüm sürelerin toplamına eşit olmalıdır. Rotalar için aşağıdakilere de karşılık gelir:

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

Bir rota veya çözüm için toplam seyahat mesafesi.

map<string, VehicleLoad>

Bu rotadaki (sırasıyla çözümdeki) her bir miktar için rotanın (sırasıyla çözümün) tamamında elde edilen maksimum yük. Tüm Transition.vehicle_loads (sırasıyla ShipmentRoute.metrics.max_loads.

string

Zorunlu. Telefon görüşmesi yapmak için projeyi ve konumu hedefleyin.

Biçim: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Konum belirtilmezse otomatik olarak bir bölge seçilir.

AsyncModelConfig

Zorunlu. Her satın alma modelinin giriş/çıkış bilgileri (ör. dosya yolları ve veri biçimleri).

string

İsteğe bağlı. Kullanıcı tanımlı model adı, kullanıcılar tarafından modelleri takip etmek için takma ad olarak kullanılabilir.

InputConfig

Zorunlu. Giriş modeli hakkında bilgi.

OutputConfig

Zorunlu. İstenilen çıkış konumu bilgileri.

BreakRequest

Araların sırası. BreakRequest mesajını inceleyin.

FrequencyConstraint

Birkaç FrequencyConstraint geçerli olabilir. Bu BreakRule'un BreakRequest'leri tarafından tümü karşılanmalıdır. FrequencyConstraint inceleyin.

Timestamp

Zorunlu. Aranın başlangıcındaki alt sınır (dahil).

Timestamp

Zorunlu. Aranın başlangıcındaki üst sınır (dahil).

Duration

Zorunlu. Aranın minimum süresi. Pozitif olmalıdır.

Duration

Zorunlu. Bu kısıtlama için minimum ara süresi. Sıfırdan büyük. FrequencyConstraint öğesinin açıklamasını inceleyin.

Duration

Zorunlu. Rotadaki, en azından kısmen duration >= min_break_duration ara vermeden geçen herhangi bir zaman aralığı için izin verilen maksimum süre. Pozitif olmalıdır.

int64

Mesafeyi en fazla max_meters olacak şekilde kısıtlayan katı bir sınır. Sınır pozitif olmalıdır.

int64

Maksimum mesafe sınırı uygulamayan ancak ihlal edildiğinde modelde tanımlanan diğer maliyetlerle aynı birimde toplanan bir maliyete neden olan yumuşak sınır.

Tanımlanmışsa soft_max_meters, max_meters değerinden küçük ve pozitif olmalıdır.

double

Aşağıdaki formül kullanılarak soft_max_meters'e kadar artan, kilometre başına maliyet:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Bu maliyet route_distance_limit'te desteklenmiyor.

double

Mesafe soft_max_meters sınırının üzerindeyse kilometre başına maliyet. Mesafe sınırın altındaysa ek maliyet 0'dır. Aksi takdirde maliyeti hesaplamak için kullanılan formül şudur:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Maliyet pozitif olmalıdır.

string

Zorunlu. Google Cloud Storage URI'si.

string

Zorunlu. gs://bucket/path/to/object biçiminde bir Google Cloud Storage nesnesinin URI'si.

ShipmentRoute

Enjekte edilecek çözümün yolları. Bazı rotalar orijinal çözümden çıkarılabilir. Rotalar ve atlanan gönderimler, injected_first_solution_routes için listelenen temel geçerlilik varsayımlarını karşılamalıdır.

SkippedShipment

Enjekte edilecek çözümün atlanan gönderimleri. Bazıları orijinal çözümden çıkarılabilir. routes alanına bakın.

ConstraintRelaxation

Sıfır veya daha fazla araç grubu için kısıtlamaların ne zaman ve ne kadar gevşetileceğini belirtir. Bu alan boşsa boş olmayan tüm araç rotaları tamamen kısıtlanır.

Relaxation

vehicle_indices'te araç bulunan rotalardaki ziyaretler için geçerli olacak tüm ziyaret kısıtlaması kolaylaştırmaları.

int32

Ziyaret kısıtlamasının relaxations uygulandığı araç dizinlerini belirtir. Boş bırakılırsa varsayılan olarak kabul edilir ve relaxations, diğer constraint_relaxations öğelerinde belirtilmeyen tüm araçlar için geçerli olur. En fazla bir varsayılan olabilir. Yani en fazla bir kısıtlama gevşetme alanının boş olmasına izin verilir vehicle_indices. Bir araç dizini, birden fazla constraint_relaxations içinde olsa bile yalnızca bir kez listelenmelidir.

interpret_injected_solutions_using_labels doğruysa araç dizini ShipmentRoute.vehicle_index ile aynı şekilde eşlenir (fields yorumuna bakın).

Level

threshold_time veya sonrasındaki koşullar VE en az threshold_visit_count koşulu karşılandığında geçerli olan kısıtlama gevşetme düzeyi.

Timestamp

Gevşemenin level uygulanabileceği zaman veya bu zaman sonrasındaki süre.

int32

Gevşetme level'nin uygulanabileceği ziyaret sayısı veya bu ziyaretten sonraki ziyaret sayısı. threshold_visit_count 0 ise (veya ayarlanmamışsa) level doğrudan aracın başlatılmasında uygulanabilir.

route.visits_size() + 1 ise level yalnızca araç tarafına uygulanabilir. route.visits_size() + 1'ten fazlaysa level bu rota için hiç uygulanmaz.

DataFormat

Zorunlu. Giriş verisi biçimi.

GcsSource

Google Cloud Storage konumu. Bu, tek bir nesne (dosya) olmalıdır.

LatLng

Yol noktasının coğrafi koordinatları.

int32

Trafik akışının yönüyle ilişkili pusula yönü. Bu değer, teslim alma ve bırakma için kullanılacak yolun tarafını belirtmek için kullanılır. Yön değerleri 0 ile 360 arasında olabilir. 0 değeri kuzey yönünü, 90 değeri doğu yönünü vb. belirtir.

string

Zorunlu. Arama yapmak için projeyi veya konumu hedefleyin.

Biçim: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Konum belirtilmezse otomatik olarak bir bölge seçilir.

Duration

Bu zaman aşımı ayarlanırsa sunucu, zaman aşımı süresi dolmadan veya eşzamanlı isteklerin sunucu için son tarihi dolmadan önce (hangisi önceyse) bir yanıt döndürür.

Asenkron istekler için sunucu, zaman aşımı dolmadan önce (mümkünse) bir çözüm oluşturur.

ShipmentModel

Çözülecek gönderim modeli.

SolvingMode

Çözüm modu varsayılan olarak DEFAULT_SOLVE (0) şeklindedir.

SearchMode

İsteği çözmek için kullanılan arama modu.

ShipmentRoute

Önceki bir çözüme benzer ilk çözümü bulma konusunda optimizasyon algoritmasına rehberlik edin.

İlk çözüm oluşturulduğunda model kısıtlanır. Bir rotada gerçekleştirilmeyen tüm gönderimler ilk çözümde dolaylı olarak atlanır ancak sonraki çözümlerde gerçekleştirilebilir.

Çözüm, bazı temel geçerlilik varsayımlarını karşılamalıdır:

• tüm rotalar için vehicle_index aralık içinde olmalı ve kopyalanmamalıdır.
• tüm ziyaretler için shipment_index ve visit_request_index aralıkta olmalıdır.
• Kargo yalnızca bir rotada referans verilebilir.
• Alım ve teslimat işleminin yapıldığı gönderimlerde teslimat öncesinde teslim alma işlemi yapılmalıdır.
• Bir gönderim için en fazla bir teslim alma veya teslimat alternatifi gerçekleştirilebilir.
• tüm rotalar için süreler artıyor (ör. vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• Gönderim yalnızca izin verilen bir araçta yapılabilir. Shipment.allowed_vehicle_indices boşsa veya vehicle_index değeri Shipment.allowed_vehicle_indices içindeyse araca izin verilir.

Enjekte edilen çözüm uygun değilse doğrulama hatası döndürülmeyebilir ve bunun yerine uygun olmadığını belirten bir hata döndürülebilir.

InjectedSolutionConstraint

Önceki bir çözüme benzer nihai bir çözüm bulmak için optimizasyon algoritmasını kısıtlayın. Örneğin, bu özellik, tamamlanmış veya tamamlanacak ancak değiştirilmemesi gereken rotaların bölümlerini dondurmak için kullanılabilir.

Enjekte edilen çözüm uygun değilse doğrulama hatası döndürülmeyebilir ve bunun yerine uygun olmadığını belirten bir hata döndürülebilir.

ShipmentRoute

Boş değilse belirli rotalar, temel ziyaret sırası veya seyahat süreleri değiştirilmeden yenilenir. Yalnızca diğer ayrıntılar güncellenir. Bu işlem, modeli çözmez.

2020/11 itibarıyla bu işlev yalnızca boş olmayan rotaların çoklu çizgilerini doldurur ve populate_polylines değerinin doğru olmasını gerektirir.

İletilen rotaların route_polyline alanları, transitions rotasıyla tutarlı olmayabilir.

Bu alan injected_first_solution_routes veya injected_solution_constraint ile birlikte kullanılmamalıdır.

Shipment.ignore ve Vehicle.ignore'un davranış üzerinde herhangi bir etkisi yoktur. İlgili gönderimlerin veya araçların yoksayılıp yoksayılmamasına bakılmaksızın, boş olmayan tüm rotalardaki tüm ziyaretler arasında çoklu çizgiler doldurulur.

bool

Doğruysa:

• Enjekte edilen bir çözümdeki rotaları istekteki araçlarla eşleştirmek için vehicle_index yerine ShipmentRoute.vehicle_label kullanır; boş değilse ConstraintRelaxation.vehicle_indices'i güncellemek için orijinal ShipmentRoute.vehicle_index ile yeni ShipmentRoute.vehicle_index eşlemesini yeniden kullanır ancak eşleme net olmalıdır (yani birden fazla ShipmentRoute aynı orijinal vehicle_index'yi paylaşmamalıdır).
• Enjekte edilen bir çözümdeki ziyaretleri istekteki gönderimlerle eşleştirmek için shipment_index yerine ShipmentRoute.Visit.shipment_label kullanır;
• SkippedShipment.index yerine SkippedShipment.label kullanır. Bu sayede, eklenmiş çözümdeki atlanan gönderimleri istek gönderimleriyle eşleştirir.

Bu yorum injected_first_solution_routes, injected_solution_constraint ve refresh_details_routes alanları için geçerlidir. Çözüm oluşturulduktan sonra istekteki gönderi veya araç dizinleri değiştiğinde (ör. gönderi veya araçlar istekten kaldırıldığı veya isteğe eklendiği için) kullanılabilir.

Bu değer doğruysa aşağıdaki kategorilerdeki etiketler kategorilerinde en fazla bir kez görünmelidir:

• Vehicle.label isteğinde;
• Shipment.label isteğinde;
• ShipmentRoute.vehicle_label, enjekte edilen çözeltide;
• Enjekte edilen çözümde SkippedShipment.label ve ShipmentRoute.Visit.shipment_label (shipment_label değerlerinin iki kez görünmesi gereken teslim alma/teslimat ziyareti çiftleri hariç).

Enjekte edilen çözümdeki bir vehicle_label, istek aracına karşılık gelmiyorsa ilgili rota, ziyaretleriyle birlikte çözümden kaldırılır. Enjekte edilen çözümdeki bir shipment_label, istek gönderimine karşılık gelmiyorsa ilgili ziyaret çözümden kaldırılır. Enjekte edilen çözümdeki bir SkippedShipment.label, istek gönderimine karşılık gelmiyorsa SkippedShipment çözümden kaldırılır.

Rota ziyaretlerinin veya rotaların tamamının enjekte edilmiş bir çözümden kaldırılması, ima edilen kısıtlamaları etkileyebilir. Bu da çözümde değişikliğe, doğrulama hatalarına veya uygulanamazlığa neden olabilir.

NOT: Arayan, her Vehicle.label (veya Shipment.label), ilgili iki istekte kullanılan bir araç (veya gönderi) öğesini benzersiz şekilde tanımlar: Enjekte edilen çözümde kullanılan OptimizeToursResponse öğesini oluşturan geçmiş istek ve enjekte edilen çözümü içeren mevcut istek. Yukarıda açıklanan benzersizlik kontrolleri, bu koşulu garanti etmek için yeterli değildir.

bool

ShipmentRoute alanları Transition.travel_duration, Visit.start_time ve vehicle_end_time'i hesaplarken, ShipmentRoute.has_traffic_infeasibilities alanını ayarlarken ve OptimizeToursResponse.total_cost alanını hesaplarken trafik tahminini göz önünde bulundurun.

bool

Doğru ise yanıt ShipmentRoute'lerine çoklu çizgiler doldurulur.

bool

Doğru ise ShipmentRoute.transitions yanıtında çoklu çizgiler ve rota jetonları doldurulur.

bool

Bu ayar belirlenirse istek için 60 dakikaya kadar bir son tarih (https://grpc.io/blog/deadlines adresine bakın) belirlenebilir. Aksi takdirde, maksimum son tarih yalnızca 30 dakikadır. Uzun süreli isteklerin kesinti riskinin önemli ölçüde daha yüksek (ancak yine de küçük) olduğunu unutmayın.

bool

Doğru ise seyahat mesafeleri Google Haritalar mesafeleri yerine jeodezik mesafeler kullanılarak hesaplanır ve seyahat süreleri geodesic_meters_per_second tarafından tanımlanan bir hızla jeodezik mesafeler kullanılarak hesaplanır.

string

Bu isteği tanımlamak için kullanılabilecek etiket. OptimizeToursResponse.request_label içinde bildirilir.

double

use_geodesic_distances doğru olduğunda bu alan ayarlanmalıdır ve seyahat sürelerini hesaplamak için uygulanan hızı tanımlar. Değeri en az 1,0 metre/saniye olmalıdır.

int32

Döndürülen doğrulama hatası sayısını kısaltır. Bu hatalar genellikle solving_mode=VALIDATE_ONLY olmadığı sürece INVALID_ARGUMENT hata yüküne BadRequest hata ayrıntısı (https://cloud.google.com/apis/design/errors#error_details) olarak eklenir: OptimizeToursResponse.validation_errors alanına bakın. Bu değer varsayılan olarak 100'dür ve 10.000 ile sınırlıdır.

ShipmentRoute

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

string

İstekte bir etiket belirtilmişse OptimizeToursRequest.label kopyası.

SkippedShipment

Atlanan tüm gönderimlerin listesi.

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. solving_mode değeri DEFAULT_SOLVE olduğunda bu, hatalar yerine uyarılar içerir.

Metrics

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

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

int32

Atlanan zorunlu gönderi sayısı.

int32

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.

Timestamp

ShipmentRoute.vehicle_start_time marka ikinci el araçların en erken başlangıç zamanı.

Timestamp

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.

map<string, double>

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. Diğer bir deyişle, costs["model.shipments.pickups.cost"], çözümdeki 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.

double

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

int32

Doğrulama hatası, her zaman mevcut olan (code, display_name) ç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. Derleyiciye benzer şekilde, bu işlem de kusursuz değildir. Bazı doğrulama hataları "önemli"dir. Bu, doğrulama sürecinin tamamını durdurdukları anlamına gelir. Bu durum, diğerlerinin yanı sıra display_name="UNSPECIFIED" hataları için de geçerlidir. Bazı hatalar, doğrulama sürecinin diğer hataları atlamasına neden olabilir.

KARARLILIĞ: code ve display_name çok kararlı olmalıdır. Ancak zaman içinde yeni kodlar ve görünen adlar görünebilir. Bu durum, yeni hata eski hatayı gizlediği için belirli bir (geçersiz) isteğin farklı bir (code, display_name) çifti oluşturmasına neden olabilir. Örneğin, "ÇOKLU HATA"ya bakın.

string

Hatanın görünen adı.

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 sub_field {name: "pickups" index: 0} }

Ancak fields değerinin belirli bir hata kodu için değişmeyeceğini unutmayın.

string

Hatayı açıklayan, kullanıcıların okuyabileceği bir dize. code ile error_message arasında 1:1 eşleme vardır (code != "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 display_name ve code politikalarını kullanın.

string

Alanların değerlerini içerebilir. Bu seçenek her zaman kullanılamaz. Bu yönteme kesinlikle güvenmemeli ve yalnızca manuel model hata ayıklama için kullanmalısınız.

string

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

FieldReference

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

int32

Yinelenen alanın dizini.

string

Alan bir harita ise anahtar.

DataFormat

Zorunlu. Çıkış veri biçimi.

GcsDestination

Çıktının yazılacağı Google Cloud Storage konumu.

bool

Makul olduğunda ücretli yollardan kaçınılıp kaçınılmayacağını belirtir. Ücretli yol içermeyen rotalara öncelik verilir. Yalnızca motorlu seyahat modları için geçerlidir.

bool

Makul olduğunda otoyolların kullanılıp kullanılmayacağını belirtir. Otoyol içermeyen rotalara öncelik verilir. Yalnızca motorlu seyahat modları için geçerlidir.

bool

Makul olduğunda feribotlardan kaçınılıp kaçınılmayacağını belirtir. Feribot seyahati içermeyen rotalara öncelik verilir. Yalnızca motorlu seyahat modları için geçerlidir.

bool

İsteğe bağlı. Mümkün olduğunda kapalı alanlarda gezinmekten kaçınılmasını belirtir. Kapalı mekan navigasyonu içermeyen rotalara öncelik verilir. Yalnızca WALKING seyahat modu için geçerlidir.

string

Gönderinin kullanıcı tanımlı görünen adı. 63 karaktere kadar uzun olabilir ve UTF-8 karakterleri içerebilir.

VisitRequest

Gönderimle ilişkili teslim alma alternatifleri grubu. Belirtilmemişse aracın yalnızca teslimatlara karşılık gelen bir konumu ziyaret etmesi gerekir.

VisitRequest

Gönderimle ilişkili teslimat alternatifleri grubu. Belirtilmemişse aracın yalnızca teslim alma noktalarına karşılık gelen bir konumu ziyaret etmesi gerekir.

map<string, Load>

Gönderinin yükleme talepleri (ör. ağırlık, hacim, palet sayısı vb.). Haritadaki anahtarlar, ilgili yükün türünü açıklayan tanımlayıcılardır (ideal olarak birimleri de içermelidir). Örneğin: "weight_kg", "volume_gallons", "pallet_count" vb. Belirli bir anahtar haritada görünmüyorsa ilgili yük geçersiz olarak kabul edilir.

int32

Bu gönderimi gerçekleştirebilecek araç grubu. Boşsa tüm araçlar tarafından gerçekleştirilebilir. Araçlar, ShipmentModel'nın vehicles listesinde yer alan dizinlerine göre verilir.

double

Bu gönderim her araç tarafından teslim edildiğinde ortaya çıkan maliyeti belirtir. Belirtilmişse ŞUNLARDAN BİRİNİ içermelidir:

• costs_per_vehicle_indices ile aynı sayıda öğe içermelidir. costs_per_vehicle[i], modelin costs_per_vehicle_indices[i] aracına karşılık gelir.
• modeldeki araç sayısı kadar öğe olmalıdır. i. öğe, modelin i. aracına karşılık gelir.

Bu maliyetler penalty_cost ile aynı birimde olmalı ve negatif olmamalıdır. Bu tür maliyetler yoksa bu alanı boş bırakın.

int32

costs_per_vehicle değerinin geçerli olduğu araçların dizinleri. Boş değilse costs_per_vehicle ile aynı sayıda öğeye sahip olmalıdır. Araç dizini birden fazla kez belirtilemez. costs_per_vehicle_indices hariç tutulan araçların maliyeti sıfırdır.

Duration

Alınma noktasından teslimat noktasına giden en kısa yola kıyasla maksimum mutlak ek süreyi belirtir. Belirtiliyse pozitif olmalıdır ve gönderim en az bir teslim alma ve teslimat içermelidir.

Örneğin, t, seçilen teslim alma alternatifinden doğrudan seçilen teslimat alternatifine gitmek için gereken en kısa süre olsun. Ardından pickup_to_delivery_absolute_detour_limit ayarı şunları zorunlu kılar:

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

Aynı gönderimde hem göreceli hem de mutlak sınırlar belirtilirse her olası teslim alma/teslim etme çifti için daha kısıtlayıcı sınır kullanılır. 10/2017 itibarıyla, yalnızca seyahat süreleri araçlara bağlı olmadığında dolambaçlar desteklenir.

Duration

Bir gönderinin teslim alınma başlangıcından teslimat başlangıcına kadar geçen maksimum süreyi belirtir. Belirtiliyse pozitif olmalıdır ve gönderim en az bir teslim alma ve teslimat içermelidir. Bu süre, teslimat ve teslim alma için hangi alternatiflerin seçildiğine veya araç hızına bağlı değildir. Bu, maksimum sapma kısıtlamalarıyla birlikte belirtilebilir: Çözüm her iki spesifikasyona da uyar.

string

Bu gönderim için "tür" belirten boş olmayan dize. Bu özellik, shipment_types (ShipmentModel'teki shipment_type_incompatibilities ve shipment_type_requirements'ye bakın) arasında uyumsuzlukları veya koşulları tanımlamak için kullanılabilir.

Tek bir ziyaret için belirtilen visit_types ile farklıdır: Aynı gönderime ait tüm teslim alma/teslim etme işlemleri aynı shipment_type değerini paylaşır.

string

Bu gönderim için bir etiket belirtir. Bu etiket, yanıtta ilgili ShipmentRoute.Visit öğesinin shipment_label alanında raporlanır.

bool

Doğruysa bu gönderimi atlayın ancak penalty_cost uygulamayın.

Modelde shipment_type_requirements varsa bir gönderim göz ardı edildiğinde doğrulama hatası oluşur.

injected_first_solution_routes veya injected_solution_constraint'te gerçekleştirilen bir gönderinin yoksayılmasına izin verilir; çözümleyici, ilgili teslim alma/teslim etme ziyaretlerini gerçekleştiren rotadan kaldırır. precedence_rules yoksayılan gönderimlere atıfta bulunanlar da yoksayılır.

double

Gönderim tamamlanmazsa bu ceza, rotaların toplam maliyetine eklenir. Bir kargo, teslim alma ve teslimat seçeneklerinden biri ziyaret edilirse tamamlanmış kabul edilir. Maliyet, modeldeki diğer tüm maliyetle ilgili alanlar için kullanılan birimle ifade edilebilir ve pozitif olmalıdır.

ÖNEMLİ: Bu ceza belirtilmezse sonsuz olarak kabul edilir. Yani gönderim tamamlanmalıdır.

double

Alınma noktasından teslimat noktasına giden en kısa yola kıyasla maksimum göreli ek süreyi belirtir. Belirtiliyse pozitif olmalıdır ve gönderim en az bir teslim alma ve teslimat içermelidir.

Örneğin, t, seçilen teslim alma alternatifinden doğrudan seçilen teslimat alternatifine gitmek için gereken en kısa süre olsun. Ardından pickup_to_delivery_relative_detour_limit ayarı şunları zorunlu kılar:

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

Aynı gönderimde hem göreceli hem de mutlak sınırlar belirtilirse her olası teslim alma/teslim etme çifti için daha kısıtlayıcı sınır kullanılır. 10/2017 itibarıyla, yalnızca seyahat süreleri araçlara bağlı olmadığında dolambaçlar desteklenir.

int64

İlgili ziyareti gerçekleştiren aracın yükünün ne kadar değişeceği. Tam sayı olduğundan kullanıcıların, hassasiyet kaybı yaşamamak için uygun bir birim seçmeleri önerilir. ≥ 0 olmalıdır.

LatLng

Bu VisitRequest işlemini gerçekleştirirken aracın ulaştığı coğrafi konum. Gönderi modelinde süre mesafe matrisleri varsa arrival_location belirtilmemelidir.

Waypoint

Bu VisitRequest işlemini gerçekleştirirken aracın ulaştığı yol noktası. Gönderi modelinde süre mesafe matrisleri varsa arrival_waypoint belirtilmemelidir.

LatLng

Bu VisitRequest tamamlandıktan sonra aracın ayrıldığı coğrafi konum. arrival_location ile aynıysa atlanabilir. Gönderi modelinde süre mesafe matrisleri varsa departure_location belirtilmemelidir.

Waypoint

Bu VisitRequest tamamlandıktan sonra aracın ayrıldığı yol noktası. arrival_waypoint ile aynıysa atlanabilir. Gönderi modelinde süre mesafe matrisleri varsa departure_waypoint belirtilmemelidir.

string

Ziyaret isteğine eklenen etiketleri belirtir. Boş veya yinelenen dizelere izin verilmez.

TimeWindow

Ziyaretlerin varış zamanını kısıtlayan zaman aralıkları. Bir aracın, varış zamanı aralığının dışında hareket edebileceğini unutmayın. Yani varış zamanı + sürenin bir zaman aralığında olması gerekmez. Araç TimeWindow.start_time'ten önce gelirse bekleme süresi yaşanabilir.

TimeWindow değerinin olmaması, aracın bu ziyareti istediği zaman gerçekleştirebileceği anlamına gelir.

Zaman aralıkları birbirinden ayrı olmalıdır.Yani hiçbir zaman aralığı diğeriyle örtüşmemeli veya bitişik olmamalıdır. Ayrıca zaman aralıkları artan düzende olmalıdır.

cost_per_hour_after_soft_end_time ve soft_end_time yalnızca tek bir zaman aralığı varsa ayarlanabilir.

Duration

Ziyaretin süresi, yani aracın varış ile ayrılış arasında geçirdiği süre (olası bekleme süresine eklenir; time_windows bölümüne bakın).

double

Bir araç rotasında bu ziyaret isteğini yerine getirmenin maliyeti. Bu, bir gönderimin her alternatif teslim alma veya teslimat işlemi için farklı maliyetler ödemek amacıyla kullanılabilir. Bu maliyet, Shipment.penalty_cost ile aynı birimde olmalı ve negatif olmamalıdır.

map<string, Load>

Bu ziyaret isteğinin taleplerini yükleyin. Bu, Shipment alanının tamamı yerine yalnızca bu VisitRequest için geçerli olması dışında Shipment.load_demands alanına benzer. Burada listelenen talepler, Shipment.load_demands içinde listelenen taleplere eklenir.

string

Ziyaretin türlerini belirtir. Bu, bir aracın bu ziyareti tamamlaması için gereken ek süreyi tahsis etmek amacıyla kullanılabilir (Vehicle.extra_visit_duration_for_visit_type bölümüne bakın).

Bir tür yalnızca bir kez görünebilir.

string

Bu VisitRequest için bir etiket belirtir. Bu etiket, yanıtta ilgili ShipmentRoute.Visit içinde visit_label olarak raporlanır.

Shipment

Modelde yapılması gereken kargolar grubu.

Vehicle

Ziyaret yapmak için kullanılabilecek araç grubu.

Timestamp

Modelin genel başlangıç ve bitiş zamanı: Bu aralık dışındaki hiçbir zaman geçerli kabul edilemez.

Modelin zaman aralığı bir yıldan kısa olmalıdır. Yani global_end_time ve global_start_time birbirinden 31536000 saniye içinde olmalıdır.

cost_per_*hour alanlarını kullanırken performansı artırmak için bu aralığı daha küçük bir aralığa ayarlamak isteyebilirsiniz (ör. tek bir günü modelliyorsanız genel zaman sınırlarını o güne ayarlamanız gerekir). Ayarlanmazsa varsayılan olarak 1 Ocak 1970, 00:00:00 (UTC) (ör. saniye: 0, nanosaniye: 0) kullanılır.

Timestamp

Ayarlanmazsa varsayılan olarak 1 Ocak 1971, 00:00:00 UTC (ör. saniye: 31536000, nanosaniye: 0) kullanılır.

double

Genel planın "küresel süresi", tüm araçların en erken geçerli başlangıç zamanı ile en geç geçerli bitiş zamanı arasındaki farktır. Kullanıcılar, örneğin en kısa sürede iş tamamlama için optimizasyon yapmaya çalışmak üzere bu miktara saat başına bir maliyet atayabilir. Bu maliyet, Shipment.penalty_cost ile aynı birimde olmalıdır.

DurationDistanceMatrix

Modelde kullanılan süre ve mesafe matrislerini belirtir. Bu alan boşsa use_geodesic_distances alanının değerine bağlı olarak Google Haritalar veya jeodezik mesafeler kullanılır. Boş değilse use_geodesic_distances doğru olamaz ve duration_distance_matrix_src_tags ya da duration_distance_matrix_dst_tags boş olamaz.

Kullanım örnekleri:

• İki konum vardır: locA ve locB.
• Rotasını locA'da başlatıp locA'da bitiren 1 araç.
• locB adresinde 1 teslim alma ziyareti isteği.

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• Üç konum vardır: locA, locB ve locC.
• "Hızlı" matrisini kullanarak rotasını locA'da başlatıp locB'de bitiren 1 araç.
• "slow" matrisini kullanarak rotasını locB'de başlatıp locB'de bitiren 1 araç.
• "Hızlı" matrisini kullanarak rotasını locB'de başlatıp locB'de bitiren 1 araç.
• locC adresinde 1 teslim alma ziyareti isteği.

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

Süre ve mesafe matrislerinin kaynaklarını tanımlayan etiketler; duration_distance_matrices(i).rows(j), duration_distance_matrix_src_tags(j) etiketine sahip ziyaretlerden i matrisindeki diğer ziyaretlere kadar olan süreleri ve mesafeleri tanımlar.

Etiketler VisitRequest.tags veya Vehicle.start_tags değerine karşılık gelir. Belirli bir VisitRequest veya Vehicle, bu alandaki tam olarak bir etiketle eşleşmelidir. Bir Vehicle'nin kaynak, hedef ve matris etiketlerinin aynı olabileceğini unutmayın. Benzer şekilde, bir VisitRequest'nin kaynak ve hedef etiketleri de aynı olabilir. Tüm etiketler farklı olmalıdır ve boş dize olamaz. Bu alan boş değilse duration_distance_matrices boş olmamalıdır.

string

Süre ve mesafe matrislerinin hedeflerini tanımlayan etiketler; duration_distance_matrices(i).rows(j).durations(k) (sırasıyla duration_distance_matrices(i).rows(j).meters(k)), i matrisinde duration_distance_matrix_src_tags(j) etiketine sahip ziyaretlerden duration_distance_matrix_dst_tags(k) etiketine sahip ziyaretlere yapılan seyahatin süresini (veya mesafesini) tanımlar.

Etiketler VisitRequest.tags veya Vehicle.start_tags değerine karşılık gelir. Belirli bir VisitRequest veya Vehicle, bu alandaki tam olarak bir etiketle eşleşmelidir. Bir Vehicle'nin kaynak, hedef ve matris etiketlerinin aynı olabileceğini unutmayın. Benzer şekilde, bir VisitRequest'nin kaynak ve hedef etiketleri de aynı olabilir. Tüm etiketler farklı olmalıdır ve boş dize olamaz. Bu alan boş değilse duration_distance_matrices boş olmamalıdır.

TransitionAttributes

Modele geçiş özellikleri eklendi.

ShipmentTypeIncompatibility

Uyumsuz shipment_types grupları (ShipmentTypeIncompatibility bölümüne bakın).

ShipmentTypeRequirement

shipment_type koşulları grupları (ShipmentTypeRequirement bölümüne bakın).

PrecedenceRule

Modelde uygulanması gereken öncelik kuralları grubu.

int32

Maksimum etkin araç sayısını kısıtlar. Rotasında en az bir gönderim yapılan araçlar etkindir. Bu, sürücü sayısının araç sayısından az olduğu ve araç filosunun heterojen olduğu durumlarda rota sayısını sınırlamak için kullanılabilir. Ardından optimizasyon, kullanılacak en iyi araç alt kümesini seçer. Kesinlikle pozitif olmalıdır.

Row

Süre ve mesafe matrisinin satırlarını belirtir. ShipmentModel.duration_distance_matrix_src_tags kadar öğe içermelidir.

string

Bu süre ve mesafe matrisinin hangi araçlara uygulandığını tanımlayan etiket. Boşsa tüm araçlar için geçerlidir ve yalnızca tek bir matris olabilir.

Her araç başlangıcı tam olarak bir matrisle eşleşmelidir. Yani start_tags alanlarından tam olarak biri, bir matrisin (ve yalnızca bu matrisin) vehicle_start_tag alanıyla eşleşmelidir.

Tüm matrislerin farklı bir vehicle_start_tag değeri olmalıdır.

Duration

Belirli bir satırın süre değerleri. ShipmentModel.duration_distance_matrix_dst_tags kadar öğe içermelidir.

double

Belirli bir satırın mesafe değerleri. Modeldeki mesafelere atıfta bulunan hiçbir maliyet veya kısıtlama yoksa bu alan boş bırakılabilir. Aksi takdirde durations kadar öğe içermelidir.

bool

"İlk" etkinliğin bir yayın olup olmadığını belirtir.

bool

"İkinci" etkinliğin bir yayın olup olmadığını belirtir.

Duration

"ilk" ve "ikinci" etkinlik arasındaki ofset. Negatif olabilir.

int32

"ilk" etkinliğin gönderi dizini. Bu alan belirtilmelidir.

int32

"İkinci" etkinliğin gönderi dizini. Bu alan belirtilmelidir.

int32

Rotayı gerçekleştiren araç. Kaynaktaki diziniyle ShipmentModel tanımlanır.

string

Bu rotayı gerçekleştiren aracın etiketi. Belirtilmişse ShipmentModel.vehicles(vehicle_index).label değerine eşittir.

Timestamp

Aracın rotasına başladığı zaman.

Timestamp

Aracın rotasını tamamladığı zaman.

Visit

Bir rotayı temsil eden ziyaretlerin sıralı dizisi. visits[i], rotada i. ziyarettir. Bu alan boşsa araç kullanılmamış olarak kabul edilir.

Transition

Rotanın geçişlerinin sıralı listesi.

bool

OptimizeToursRequest.consider_road_traffic doğru olarak ayarlandığında bu alan, rota zamanlamalarındaki tutarsızlıkların trafiğe dayalı seyahat süresi tahminleri kullanılarak tahmin edildiğini gösterir. Ziyaret ve araç zaman aralıklarını karşılarken trafik koşullarına göre ayarlanmış seyahat, gecikmeler ve ziyaretler arasındaki araları tamamlamak için yeterli zaman olmayabilir. Örneğin,

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

Trafik nedeniyle artan seyahat süresi tahmini travel_duration(previous_visit, next_visit) nedeniyle, next_visit adresine varış büyük olasılıkla mevcut zaman aralığından daha geç gerçekleşecektir. Ayrıca, seyahat süresi tahminlerindeki artış ve ziyaret ya da ara verme süresi aralığı kısıtlamaları nedeniyle ara verme zamanının bir ziyaretle çakışma ihtimali de vardır.

EncodedPolyline

Rotayı kodlanmış çoklu çizgi temsili. Bu alan yalnızca OptimizeToursRequest.populate_polylines doğru değerine ayarlanırsa doldurulur.

Break

Bu rotayı yapan araç için planlanan aralar. breaks dizisi, her biri ilgili start_time değerinden başlayıp duration saniye süren zaman aralıklarını temsil eder.

AggregatedMetrics

Bu rotanın süresi, mesafesi ve yük metrikleri. AggregatedMetrics alanları, bağlama bağlı olarak tüm ShipmentRoute.transitions veya ShipmentRoute.visits için toplanır.

map<string, double>

Maliyetle ilgili istek alanlarına göre dökümü alınmış rota maliyeti. Anahtarlar, giriş OptimizeToursRequest'a göre proto yollar ("model.shipments.pickups.cost" gibi) ve değerler, ilgili maliyet alanı tarafından oluşturulan toplam maliyetin tüm rota boyunca toplanmış halidir. Diğer bir deyişle, costs["model.shipments.pickups.cost"], rotadaki tüm teslim alma maliyetlerinin toplamıdır. Modelde tanımlanan tüm maliyetler, TransitionAttributes ile ilgili maliyetler hariç olmak üzere burada ayrıntılı olarak raporlanır. TransitionAttributes ile ilgili maliyetler ise 01.2022 itibarıyla yalnızca toplu olarak raporlanır.

double

Rotanın toplam maliyeti. Maliyet haritasındaki tüm maliyetlerin toplamı.

Timestamp

Aranın başlangıç zamanı.

Duration

Mola süresi.

string

Çoklu çizginin kodlanmış noktalarını temsil eden dize.

Duration

Bu geçiş sırasındaki seyahat süresi.

double

Geçiş sırasında kat edilen mesafe.

bool

OptimizeToursRequest.consider_road_traffic üzerinden trafik istendiğinde ve Transition için trafik bilgileri alınamadığında bu boole değeri true (doğru) olarak ayarlanır. Bu durum geçici (anlık trafik sunucularında nadir görülen bir kesinti) veya kalıcı (bu konum için veri yok) olabilir.

Duration

Bu geçişe uygulanan gecikme sürelerinin toplamı. Gecikme varsa bir sonraki etkinlikten (ziyaret veya araç sonu) tam olarak delay_duration saniye önce başlar. Şu sayfaya göz atın: TransitionAttributes.delay.

Duration

Bu geçiş sırasında gerçekleşen araların süresinin toplamı (varsa). Her molanın başlangıç zamanı ve süresi ShipmentRoute.breaks içinde saklanır.

Duration

Bu geçiş sırasında bekleme süresi. Bekleme süresi, boşta kalma süresine karşılık gelir ve ara verme süresini içermez. Ayrıca bu bekleme süresinin, birbirine bitişik olmayan birkaç aralığa bölünebileceğini unutmayın.

Duration

Kolaylık olması açısından geçişin toplam süresi. Şuna eşittir:

• sonraki ziyaret start_time (veya son geçişse vehicle_end_time) - bu geçişin start_time;
• ShipmentRoute.has_traffic_infeasibilities yanlışsa ek olarak aşağıdakiler de geçerlidir: `total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Bu geçişin başlangıç zamanı.

EncodedPolyline

Geçiş sırasında takip edilen rotanın kodlanmış çoklu çizgi gösterimi. Bu alan yalnızca populate_transition_polylines doğru değerine ayarlanırsa doldurulur.

string

Yalnızca çıkış. Navigasyon sırasında rotayı yeniden oluşturmak ve yeniden yönlendirme durumunda rotanın oluşturulduğu orijinal amacı dikkate almak için Navigation SDK'ya iletilebilecek opak bir jeton. Bu jetonu opak bir blob olarak değerlendirin. Hizmet tam olarak aynı rotayı döndürse bile değeri değişebileceğinden, değerini istekler arasında karşılaştırmayın. Bu alan yalnızca populate_transition_polylines doğru değerine ayarlanırsa doldurulur.

map<string, VehicleLoad>

Bu geçiş sırasında araç yüklemeleri. Bu araçta Vehicle.load_limits görünen veya bu rotada yapılan bazı gönderimlerde sıfır olmayan Shipment.load_demands değerine sahip her tür için.

İlk geçiş sırasındaki yükler, araç rotasının başlangıç yükleridir. Ardından, her ziyaretten sonra ziyaretin load_demands değeri, ziyaretin teslimat mı yoksa teslim alma mı olduğuna bağlı olarak bir sonraki geçişin yüklerini almak için eklenir veya çıkarılır.

int64

Belirtilen tür için araçtaki yük miktarı. Yük birimi genellikle türe göre belirtilir. Şu sayfaya göz atın: Transition.vehicle_loads.

int32

Kaynak ShipmentModel içindeki shipments alanının dizini.

bool

Doğru ise ziyaret, bir Shipment'ün teslim alınmasına karşılık gelir. Aksi takdirde, bir teslimata karşılık gelir.

int32

Shipment öğesinin teslim alma veya teslimat alanındaki VisitRequest dizini (is_pickup bölümüne bakın).

Timestamp

Ziyaretin başladığı zaman. Aracın ziyaret konumuna bu saatten daha erken ulaşabileceğini unutmayın. Saatler ShipmentModel ile tutarlıdır.

map<string, Load>

Gönderim ve ziyaret isteğinin toplamı olarak toplam ziyaret yükleme talebi load_demands. Ziyaret bir yayınsa değerler negatiftir. Talepler, Transition.loads ile aynı türlerde raporlanır (bu alana bakın).

Duration

Ziyaretten önce rota üzerinde ziyaret edilen gönderimler ve zaman aralıkları nedeniyle ortaya çıkan olası bekleme süresi nedeniyle ek yan yol süresi. Ziyaret bir teslimat ise yan yol, ilgili teslim alma ziyaretinden hesaplanır ve şuna eşittir:

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

Aksi takdirde, start_location aracından hesaplanır ve şuna eşittir:

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

Shipment içinde belirtilmişse ilgili Shipment.label kopyası.

string

VisitRequest içinde belirtilmişse ilgili VisitRequest.label kopyası.

string

Uyumsuz türlerin listesi. Listelenenler arasında farklı shipment_types değerine sahip iki gönderim "uyumlu değildir".

IncompatibilityMode

Uyumsuzluk için uygulanan mod.

string

dependent_shipment_types tarafından istenen alternatif gönderim türlerinin listesi.

string

dependent_shipment_types alanında türü required_shipment_type_alternatives olan tüm gönderimlerin, aynı rotada en az bir required_shipment_type_alternatives türü gönderimin ziyaret edilmesi gerekir.

NOT: shipment_type'ün kendisine bağlı olduğu şart zincirlerine izin verilmez.

RequirementMode

Koşula uygulanan mod.

int32

Dizin, kaynak ShipmentModel'teki gönderinin dizinine karşılık gelir.

string

Shipment içinde belirtilmişse ilgili Shipment.label kopyası.

Reason

Gönderimin neden atlandığını açıklayan nedenlerin listesi. Reason numaralı yoruma bakın. Bir gönderimin neden atlandığını anlayamazsak neden ayarlanmaz.

Code

Kodun yorumlarına bakın.

string

Neden kodu DEMAND_EXCEEDS_VEHICLE_CAPACITY ise aşılmış bir kapasite türünü belirtir.

int32

Neden, gönderim aracıyla ilgili bir uyumsuzlukla ilgiliyse bu alanda ilgili bir aracın dizini sağlanır.

Timestamp

Zorunlu zaman aralığının başlangıç zamanı. Belirtilmemişse ShipmentModel.global_start_time olarak ayarlanır.

Timestamp

Sabit zaman aralığının bitiş zamanı. Belirtilmemişse ShipmentModel.global_end_time olarak ayarlanır.

Timestamp

Zaman aralığının yumuşak başlangıç zamanı.

Timestamp

Zaman aralığının esnek bitiş zamanı.

double

Etkinlik soft_start_time değerinden önce gerçekleşirse modeldeki diğer maliyetlere eklenen saat başına maliyet. Şu şekilde hesaplanır:

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

Bu maliyet pozitif olmalıdır ve alan yalnızca soft_start_time ayarlandıysa ayarlanabilir.

double

Etkinlik soft_end_time tarihinden sonra gerçekleşirse modeldeki diğer maliyetlere eklenen saat başına maliyet. Şu şekilde hesaplanır:

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

Bu maliyet pozitif olmalıdır ve alan yalnızca soft_end_time ayarlandıysa ayarlanabilir.

string

Bu özelliklerin geçerli olduğu (src->dst) geçiş grubunu tanımlayan etiketler.

Bir kaynak ziyareti veya araç başlatma işlemi, VisitRequest.tags veya Vehicle.start_tags'i src_tag içeriyorsa ya da excluded_src_tag içermiyorsa eşleşir (bu iki alandan hangisinin boş olmadığına bağlı olarak).

string

Şu sayfaya göz atın: src_tag. src_tag ve excluded_src_tag'den tam olarak biri boş olmamalıdır.

string

Bir hedef ziyaret veya araç sonu, VisitRequest.tags veya Vehicle.end_tags'si dst_tag içeriyorsa ya da excluded_dst_tag içermiyorsa (bu iki alandan hangisinin boş olmadığına bağlı olarak) eşleşir.

string

Şu sayfaya göz atın: dst_tag. dst_tag ve excluded_dst_tag'den tam olarak biri boş olmamalıdır.

double

Bu geçişin maliyetini belirtir. Bu değer, modeldeki diğer tüm maliyetlerle aynı birimdedir ve negatif olmamalıdır. Mevcut diğer tüm maliyetlerin üzerine uygulanır.

double

Bu geçiş sırasında kat edilen mesafeye uygulanan kilometre başına maliyeti belirtir. Araçlarda belirtilen tüm Vehicle.cost_per_kilometer değerlerini içerir.

DistanceLimit

Bu geçiş sırasında kat edilen mesafeyle ilgili bir sınır belirtir.

2021/06 itibarıyla yalnızca yumuşak sınırlar desteklenmektedir.

Duration

Bu geçişi gerçekleştirirken oluşan gecikmeyi belirtir.

Bu gecikme her zaman kaynak ziyareti tamamlandıktan sonra ve hedef ziyareti başlatılmadan önce gerçekleşir.

string

Aracın kullanıcı tanımlı görünen adı. En fazla 63 karakter uzunluğunda olabilir ve UTF-8 karakterleri içerebilir.

TravelMode

Aracın kullanabileceği yolları ve hızını etkileyen ulaşım şekli. Ayrıca travel_duration_multiple sayfasını da inceleyin.

RouteModifiers

Belirli bir araç için rotaların hesaplanma şeklini etkileyen ve karşılanması gereken bir koşul grubu.

LatLng

Araç, kargoyu teslim almaya başlamadan önce hangi coğrafi konumdadır? Belirtilmemişse araç ilk teslimatında başlar. Gönderi modelinde süre ve mesafe matrisleri varsa start_location belirtilmemelidir.

Waypoint

Aracın herhangi bir kargoyu teslim almadan önce başladığı coğrafi konumu temsil eden yol noktası. start_waypoint veya start_location belirtilmezse araç ilk teslimat noktasından başlar. Gönderi modelinde süre ve mesafe matrisleri varsa start_waypoint belirtilmemelidir.

LatLng

Aracın son VisitRequest'ünü tamamladıktan sonra sona erdiği coğrafi konum. Belirtilmemişse aracın ShipmentRoute, son VisitRequest'unu tamamladığında hemen sona erer. Gönderi modelinde süre ve mesafe matrisleri varsa end_location belirtilmemelidir.

Waypoint

Aracın son VisitRequest'ünü tamamladıktan sonra sona erdiği coğrafi konumu temsil eden yol noktası. end_waypoint veya end_location belirtilmezse aracın ShipmentRoute özelliği, son VisitRequest'ı tamamladığında hemen sona erer. Gönderi modelinde süre ve mesafe matrisleri varsa end_waypoint belirtilmemelidir.

string

Aracın rotasının başına eklenen etiketleri belirtir.

Boş veya yinelenen dizelere izin verilmez.

string

Aracın rotasının sonuna eklenen etiketleri belirtir.

Boş veya yinelenen dizelere izin verilmez.

TimeWindow

Aracın başlangıç konumundan ayrılabileceği zaman aralıkları. Bu değerler, genel zaman sınırları içinde olmalıdır (ShipmentModel.global_* alanlarına bakın). Belirtilmemişse bu genel zaman sınırlarının dışında herhangi bir sınır yoktur.

Aynı tekrarlanan alana ait zaman aralıkları ayrı olmalıdır.Yani hiçbir zaman aralığı başka bir zaman aralığıyla çakışamaz veya başka bir zaman aralığına bitişik olamaz. Ayrıca zaman aralıkları kronolojik sırayla olmalıdır.

cost_per_hour_after_soft_end_time ve soft_end_time yalnızca tek bir zaman aralığı varsa ayarlanabilir.

TimeWindow

Aracın bitiş konumuna ulaşabileceği zaman aralıkları. Bu değerler, genel zaman sınırları içinde olmalıdır (ShipmentModel.global_* alanlarına bakın). Belirtilmemişse bu genel zaman sınırlarının dışında herhangi bir sınır yoktur.

Aynı tekrarlanan alana ait zaman aralıkları ayrı olmalıdır.Yani hiçbir zaman aralığı başka bir zaman aralığıyla çakışamaz veya başka bir zaman aralığına bitişik olamaz. Ayrıca zaman aralıkları kronolojik sırayla olmalıdır.

cost_per_hour_after_soft_end_time ve soft_end_time yalnızca tek bir zaman aralığı varsa ayarlanabilir.

UnloadingPolicy

Araçta kargo boşaltma politikası uygulanıyor.

map<string, LoadLimit>

Aracın kapasiteleri (ör. ağırlık, hacim, palet sayısı). Haritadaki anahtarlar, Shipment.load_demands alanının anahtarlarıyla tutarlı olan yük türünün tanımlayıcılarıdır. Belirli bir anahtar bu haritada yoksa ilgili kapasitenin sınırsız olduğu kabul edilir.

double

Araç maliyetleri: Tüm maliyetler toplanır ve Shipment.penalty_cost ile aynı birimde olmalıdır.

Araç rotasının saatlik maliyeti. Bu maliyet, rotanın toplam süresine uygulanır ve seyahat süresini, bekleme süresini ve ziyaret süresini içerir. Yalnızca cost_per_traveled_hour yerine cost_per_hour kullanılması ek gecikmeye neden olabilir.

double

Araç rotasının kat edilen her saati başına maliyet. Bu maliyet yalnızca rotanın aldığı seyahat süresine (yani ShipmentRoute.transitions'te raporlanan süreye) uygulanır ve bekleme süresi ile ziyaret süresini içermez.

double

Araç rotasının kilometre başına maliyeti. Bu maliyet, ShipmentRoute.transitions içinde raporlanan mesafeye uygulanır ve tek bir VisitRequest'ın arrival_location ile departure_location arasında dolaylı olarak kat edilen mesafe için geçerli değildir.

double

Bu araç bir gönderiyi işlemek için kullanılıyorsa uygulanan sabit maliyet.

bool

Bu alan yalnızca rotalarında kargo hizmeti verilmeyen araçlar için geçerlidir. Bu durumda aracın ikinci el olarak kabul edilip edilmeyeceğini belirtir.

Doğru ise araç, herhangi bir gönderim hizmeti sunmasa bile başlangıç konumundan bitiş konumuna gider ve başlangıç ile bitiş arasındaki seyahat nedeniyle oluşan zaman ve mesafe maliyetleri dikkate alınır.

Aksi takdirde, başlangıç konumundan bitiş konumuna gitmez ve bu araç için break_rule veya gecikme (TransitionAttributes'ten itibaren) planlanmaz. Bu durumda, aracın ShipmentRoute öğesinde araç dizini ve etiketi dışında herhangi bir bilgi bulunmaz.

DurationLimit

Aracın rotasının toplam süresi için uygulanan sınır. Belirli bir OptimizeToursResponse'de, bir aracın rota süresi vehicle_end_time ile vehicle_start_time arasındaki farktır.

DurationLimit

Aracın rotasının seyahat süresine uygulanan sınır. Belirli bir OptimizeToursResponse'de rota seyahat süresi, tüm transitions.travel_duration'ların toplamıdır.

DistanceLimit

Aracın rotasının toplam mesafesine uygulanan sınır. Belirli bir OptimizeToursResponse'te rota mesafesi, tüm transitions.travel_distance_meters'ların toplamıdır.

map<string, Duration>

visit_types dizelerinden sürelere bir eşleme belirtir. Süre, belirtilen visit_types ile yapılan ziyaretlerde VisitRequest.duration'e ek olarak alınacak süredir. cost_per_hour belirtilirse bu ek ziyaret süresi maliyeti artırır. Anahtarlar (ör. visit_types) boş dize olamaz.

Bir ziyaret isteği birden fazla türdeyse haritaya her tür için bir süre eklenir.

BreakRule

Bu araçta uygulanacak ara verme programını açıklar. Boş bırakılırsa bu araç için ara verme planlanmaz.

string

Bu araç için bir etiket belirtir. Bu etiket, yanıtta ilgili ShipmentRoute öğesinin vehicle_label değeri olarak raporlanır.

bool

Doğruysa used_if_route_is_empty yanlış olmalıdır ve bu araç kullanılmaz.

Bir gönderim injected_first_solution_routes içinde yoksayılan bir araç tarafından gerçekleştirilirse ilk çözümde atlanır ancak yanıtta gerçekleştirilebilir.

Bir gönderim injected_solution_constraint'te yoksayılan bir araç tarafından gerçekleştirilirse ve ilgili teslim alma/teslim etme işlemi, araçta kalması için kısıtlanmışsa (yani RELAX_ALL_AFTER_THRESHOLD düzeyine gevşetilmemişse) yanıtta atlanır. Bir gönderinin allowed_vehicle_indices alanı boş değilse ve izin verilen tüm araçlar yoksayılıyorsa bu gönderi yanıtta atlanır.

double

Bu aracın seyahat sürelerini artırmak veya azaltmak için kullanılabilecek bir çarpma faktörünü belirtir. Örneğin, bu değeri 2,0 olarak ayarlamak, bu aracın daha yavaş olduğu ve seyahat sürelerinin standart araçlara kıyasla iki kat daha uzun olduğu anlamına gelir. Bu çarpan, ziyaret sürelerini etkilemez. cost_per_hour veya cost_per_traveled_hour belirtilirse maliyeti etkiler. Bu değer [0,001; 1000,0] aralığında olmalıdır. Ayarlanmamışsa araç standarttır ve bu çarpan 1,0 olarak kabul edilir.

UYARI: Seyahat süreleri, bu çarpan uygulandıktan sonra ancak herhangi bir sayısal işlem yapılmadan önce en yakın saniyeye yuvarlanır. Bu nedenle, küçük bir çarpan hassasiyet kaybına neden olabilir.

Aşağıdaki extra_visit_duration_for_visit_type bölümüne de bakın.

Duration

Süreyi en fazla max_duration olarak kısıtlayan katı bir sınır.

Duration

Maksimum süre sınırı uygulamayan ancak ihlal edildiğinde rotanın maliyete maruz kalmasına neden olan yumuşak sınır. Bu maliyet, modelde tanımlanan diğer maliyetlerle (aynı birimde) toplanır.

Tanımlanmışsa soft_max_duration pozitif olmalıdır. max_duration da tanımlanmışsa soft_max_duration, max_duration'dan kısa olmalıdır.

Duration

Maksimum süre sınırı uygulamayan ancak ihlal edildiğinde rotanın süreye bağlı olarak karesel bir maliyete maruz kalmasına neden olan yumuşak sınır. Bu maliyet, modelde tanımlanan diğer maliyetlerle (aynı birimde) toplanır.

Tanımlanmışsa quadratic_soft_max_duration pozitif olmalıdır. max_duration de tanımlanmışsa quadratic_soft_max_duration, max_duration'ten küçük olmalı ve fark bir günden fazla olmamalıdır:

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

soft_max_duration eşiği ihlal edildiğinde oluşan saatlik maliyet. Süre eşik değerinin altındaysa ek maliyet 0'dır. Aksi takdirde maliyet, süreye bağlı olarak aşağıdaki gibidir:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

Maliyet pozitif olmalıdır.

double

quadratic_soft_max_duration eşiği ihlal edilirse metrekare başına saatlik maliyet.

Süre eşik değerinin altındaysa ek maliyet 0'dır. Aksi takdirde maliyet, süreye bağlı olarak aşağıdaki gibidir:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

Maliyet pozitif olmalıdır.

int64

Yükün yumuşak sınırı. Şu sayfaya göz atın: cost_per_unit_above_soft_max.

double

Bu aracın rotasında yük soft_max_load'ü aşarsa aşağıdaki maliyet cezası uygulanır (araç başına yalnızca bir kez): (yük - soft_max_load) * cost_per_unit_above_soft_max. Tüm maliyetler toplanır ve Shipment.penalty_cost ile aynı birimde olmalıdır.

Interval

Rotanın başlangıcında aracın kabul edilebilir yük aralığı.

Interval

Rotanın sonunda aracın kabul edilebilir yük aralığı.

int64

Kabul edilebilir maksimum yük miktarı.

int64

Kabul edilebilir minimum yük. ≥ 0 olmalıdır. Her ikisi de belirtilmişse min, max'ten küçük olmalıdır.

int64

Kabul edilebilir maksimum yük. ≥ 0 olmalıdır. Belirtilmemişse maksimum yük bu mesaj tarafından kısıtlanmaz. Her ikisi de belirtilmişse min, max'ten küçük olmalıdır.

bool

İsteğe bağlı. Bu yol işaretinin konumunun, aracın yolun belirli bir tarafında durması için tercih edildiğini belirtir. Bu değeri ayarlarsanız rota, aracın yolun ortasından konuma doğru eğimli olan tarafında durabilmesi için konumdan geçer. Bu seçenek "YÜRÜYÜŞ" seyahat modunda kullanılamaz.

Location

İsteğe bağlı bir başlık da dahil olmak üzere coğrafi koordinatlar kullanılarak belirtilen bir nokta.

string

Dönüm noktasıyla ilişkili ÖY yer kimliği.