Package google.maps.routeoptimization.v1

int32

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

Duration

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

Duration

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

Duration

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

Duration

Bir rota veya çözüm için toplam mola süresi.

Duration

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

Duration

Toplam süre, yukarıdaki tüm sürelerin toplamına eşit olmalıdır. Rotalar için şunlara da 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 (veya çözümdeki) her bir miktar için tüm rota (veya çözüm) boyunca ulaşılan maksimum yük. Tüm Transition.vehicle_loads (veya ShipmentRoute.metrics.max_loads.

int32

Zorunlu gönderimlerin sayısı.

Deneysel: Bu alanın davranışı veya varlığı gelecekte değişebilir.

double

Gerçekleştirilen gönderilerin Shipment.penalty_cost toplamı.

Deneysel: Bu alanın davranışı veya varlığı gelecekte değişebilir.

string

Zorunlu. Çağrı yapılacak hedef proje ve konum.

Biçim:

• projects/{project-id}
• projects/{project-id}/locations/-

Bölgesel {location-id} değerleri desteklenmez.

AsyncModelConfig

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

string

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

InputConfig

Zorunlu. Giriş modeliyle ilgili bilgiler.

OutputConfig

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

BreakRequest

Ara dizisi. BreakRequest mesajını inceleyin.

FrequencyConstraint

Birden fazla FrequencyConstraint geçerli olabilir. Bu BreakRule'ın BreakRequest'leri tarafından tüm koşullar karşılanmalıdır. FrequencyConstraint sayfasına göz atabilirsiniz.

Timestamp

Zorunlu. Aranın başlangıcı için alt sınır (dahil).

Timestamp

Zorunlu. Aranın başlangıcı için ü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. Negatif olmayan. FrequencyConstraint adlı yerin açıklamasını görüntüleyin.

Duration

Zorunlu. Rotada en azından kısmen duration >= min_break_duration mola içermeyen herhangi bir zaman aralığının izin verilen maksimum süresi. Pozitif olmalıdır.

int64

Mesafe değerini en fazla max_meters olacak şekilde kısıtlayan kesin bir sınır. Sınır, negatif olmayan bir değer olmalıdır.

int64

Maksimum mesafe sınırını zorunlu kılmayan ancak ihlal edildiğinde modelde tanımlanan diğer maliyetlere aynı birimle eklenen bir maliyete neden olan esnek bir sınırdır.

Tanımlanmışsa soft_max_meters, max_meters'tan küçük ve negatif olmayan bir değer olmalıdır.

double

Kilometre başına maliyet, soft_max_meters değerine kadar artar. Formül:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Bu maliyet route_distance_limit dilinde 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 olur. Aksi takdirde maliyeti hesaplamak için aşağıdaki formül kullanılır:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Maliyet negatif olmamalı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 çözeltinin rotaları. Bazı rotalar orijinal çözümden çıkarılabilir. Rotalar ve atlanan gönderiler, 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 esnetileceğini belirtir. Bu alan boşsa boş olmayan tüm araç rotaları tamamen kısıtlanır.

Relaxation

vehicle_indices içindeki araçların bulunduğu rotalardaki ziyaretler için geçerli olacak tüm ziyaret kısıtlaması esnetmeleri.

int32

Ziyaret kısıtlamasının relaxations geçerli olduğu araç dizinlerini belirtir. Boş bırakılırsa bu 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 değer olabilir. Diğer bir deyişle, en fazla bir kısıtlama gevşetme alanının boş bırakılmasına izin verilir vehicle_indices. Bir araç dizini, birden fazla constraint_relaxations içinde olsa bile yalnızca bir kez listelenebilir.

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

Level

threshold_time ve en az threshold_visit_count koşulları karşılandığında geçerli olan kısıtlama esnetme düzeyi.

Timestamp

level gevşetmesinin uygulanabileceği zaman veya bu zamandan sonraki bir zaman.

int32

level gevşetme işleminin uygulanabileceği ziyaret sayısı. threshold_visit_count 0 ise (veya ayarlanmamışsa) level doğrudan araç çalıştırıldığında uygulanabilir.

route.visits_size() + 1 ise level yalnızca aracın arka tarafına uygulanabilir. route.visits_size() + 1 değerinden 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

Ara noktanın coğrafi koordinatları.

int32

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

string

Zorunlu. Arama yapmak için hedef projeyi veya konumu seçin.

Biçim:

• projects/{project-id}
• projects/{project-id}/locations/-

Bölgesel {location-id} değerleri desteklenmez.

Duration

Bu zaman aşımı ayarlanırsa sunucu, zaman aşımı süresi dolmadan veya senkronize istekler için sunucu son tarihine ulaşılmadan önce (hangisi daha önce gerçekleşirse) bir yanıt döndürür.

Asenkron isteklerde sunucu, zaman aşımı süresi dolmadan önce bir çözüm üretir (mümkünse).

ShipmentModel

Çözülecek gönderi modeli.

SolvingMode

Varsayılan olarak, çözme modu DEFAULT_SOLVE (0) şeklindedir.

SearchMode

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

ShipmentRoute

Optimizasyon algoritmasını, önceki bir çözüme benzer bir ilk çözüm bulmaya yönlendirin.

İlk çözüm oluşturulduğunda model kısıtlanır. Bir rotada gerçekleştirilmeyen gönderiler, 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ıkta olmalı ve yinelenmemelidir.
• Tüm ziyaretler için shipment_index ve visit_request_index aralıkta olmalıdır.
• Bir gönderiye yalnızca bir rotada referans verilebilir.
• Teslim alma-teslimat gönderisinin teslim alınması, teslimattan önce gerçekleştirilmelidir.
• Bir gönderinin birden fazla teslim alma alternatifi veya teslimat alternatifi gerçekleştirilemez.
• Tüm rotalarda süreler artıyorsa (ör. vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• Gönderim yalnızca izin verilen bir araçla yapılabilir. Shipment.allowed_vehicle_indices boşsa veya vehicle_index, Shipment.allowed_vehicle_indices içinde yer alıyorsa araca izin verilir.

Eklenen çözüm uygun değilse doğrulama hatası döndürülmeyebilir ve bunun yerine uygunsuzluğu belirten bir hata döndürülebilir.

InjectedSolutionConstraint

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

Eklenen çözüm uygun değilse doğrulama hatası döndürülmeyebilir ve bunun yerine uygunsuzluğu belirten bir hata döndürülebilir.

ShipmentRoute

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

Kasım 2020 itibarıyla bu, 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 tutarsız olabilir.

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

Shipment.ignore ve Vehicle.ignore, davranış üzerinde etkili değildir. İlgili gönderilerin veya araçların yoksayılıp yoksayılmadığına bakılmaksızın, boş olmayan tüm rotalardaki tüm ziyaretler arasında çoklu çizgiler doldurulmaya devam eder.

bool

Doğruysa:

• Eklenen 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 değerini güncellemek için orijinal ShipmentRoute.vehicle_index ile yeni ShipmentRoute.vehicle_index arasındaki eşlemeyi yeniden kullanır ancak eşleme net olmalıdır (yani birden fazla ShipmentRoute aynı orijinal vehicle_index değerini paylaşmamalıdır).
• Enjekte edilen bir çözümdeki ziyaretleri istekteki gönderilerle eşleştirmek için shipment_index yerine ShipmentRoute.Visit.shipment_label kullanır.
• Eklenen çözümdeki atlanan gönderileri istek gönderileriyle eşleştirmek için SkippedShipment.index yerine SkippedShipment.label kullanır.

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

True (doğru) ise aşağıdaki kategorilerdeki etiketler, kendi kategorilerinde en fazla bir kez görünmelidir:

• İstekte Vehicle.label;
• İstekte Shipment.label;
• ShipmentRoute.vehicle_label, enjekte edilen çözeltide;
• Eklenen çözümde SkippedShipment.label ve ShipmentRoute.Visit.shipment_label (shipment_label iki kez görünmesi gereken teslim alma/teslimat ziyaret çiftleri hariç).

Eklenen çözümdeki bir vehicle_label, istek aracına karşılık gelmiyorsa ilgili rota, ziyaretleriyle birlikte çözümden kaldırılır. Eklenen çözümdeki bir shipment_label, istek gönderimiyle eşleşmiyorsa ilgili ziyaret çözümden kaldırılır. Eklenen çözümdeki bir SkippedShipment.label, istek gönderimiyle eşleşmiyorsa SkippedShipment çözümden kaldırılır.

Rota ziyaretlerini veya tüm rotaları eklenen bir çözümden kaldırmak, örtük kısıtlamaları etkileyebilir. Bu da çözümde değişikliğe, doğrulama hatalarına veya uygulanamazlığa yol açabilir.

NOT: Çağrıyı yapan taraf, her Vehicle.label (veya ) için Shipment.label), iki alakalı istekte kullanılan bir araç (veya gönderi) öğesini benzersiz şekilde tanımlar: eklenen çözümde kullanılan OptimizeToursResponse değerini üreten geçmiş istek ve eklenen çözümü içeren mevcut istek. Yukarıda açıklanan benzersizlik kontrolleri, bu şartın karşılanmasını garanti etmek için yeterli değildir.

bool

ShipmentRoute alanları Transition.travel_duration, Visit.start_time ve vehicle_end_time hesaplanırken, ShipmentRoute.has_traffic_infeasibilities alanı ayarlanırken ve OptimizeToursResponse.total_cost alanı hesaplanırken trafik tahmini dikkate alınır.

bool

Doğru ise yanıtlarda çoklu çizgiler doldurulur ShipmentRoute.

bool

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

bool

Bu ayar belirlenirse isteğin son tarihi (https://grpc.io/blog/deadlines adresine bakın) 60 dakikaya kadar olabilir. Aksi takdirde, maksimum süre yalnızca 30 dakikadır. Uzun süreli isteklerin kesintiye uğrama riskinin çok daha yüksek (ancak yine de düşü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 raporlanır.

double

use_geodesic_distances true olduğunda bu alanın ayarlanması gerekir 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 hatalarının sayısını kısaltır. Bu hatalar, solving_mode=VALIDATE_ONLY olmadığı sürece genellikle 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önderilerin listesi.

OptimizeToursValidationError

Bağımsız olarak tespit edebildiğimiz tüm doğrulama hatalarının listesi. OptimizeToursValidationError mesajı için "MULTIPLE ERRORS" açıklamasına bakın. solving_mode, DEFAULT_SOLVE olduğunda hatalar yerine uyarılar gösterilir.

OptimizeToursRequest

Bazı durumlarda, gelen isteği çözmeden önce değiştiririz (ör. maliyet ekleriz). solving_mode == TRANSFORM_AND_RETURN_REQUEST ise değiştirilen istek burada döndürülür.

Deneysel: Daha fazla bilgi için https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request adresini ziyaret edin.

Metrics

Bu çözüm için süre, mesafe ve kullanım metrikleri.

AggregatedMetrics

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

int32

Atlanan zorunlu gönderim 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ış olarak kabul edilir.

Timestamp

İkinci el araçlar için en erken başlangıç zamanı. Tüm ikinci el araçların ShipmentRoute.vehicle_start_time değerinin minimumu olarak hesaplanır.

Timestamp

Kullanılan bir araç için en geç bitiş zamanı. Tüm kullanılan araçların maksimum ShipmentRoute.vehicle_end_time değeri olarak hesaplanır.

map<string, double>

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

double

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

string

Zorunlu. Arama yapmak için hedef projeyi veya konumu seçin.

Biçim:

• projects/{project-id}
• projects/{project-id}/locations/-

Bölgesel {location-id} değerleri desteklenmez.

Uri

Zorunlu. OptimizeToursRequest içeren Cloud Storage nesnesinin URI'si.

Uri

Zorunlu. OptimizeToursResponse öğesini içerecek Cloud Storage nesnesinin URI'si.

Uri

İsteğe bağlıdır. JSON veya textproto olarak kodlanmış OptimizeToursResponse içeren Cloud Storage nesnesinin URI'si. Nesne JSON olarak kodlandıysa nesne adının uzantısı .json olur. Nesne, textproto olarak kodlanmışsa nesne adının uzantısı .txtpb olur.

Kaynağın crc32_checksum değeri, kaynak içeriğinin değiştirilmediğini doğrulamak için kullanılabilir.

int32

Doğrulama hatası, her zaman mevcut olan (code, display_name) çiftiyle tanımlanır.

Bu bölümden sonraki alanlar, hatayla ilgili daha fazla bilgi sağlar.

BİRDEN FAZLA HATA: Birden fazla hata olduğunda doğrulama işlemi, bunlardan birkaçını göstermeye çalışır. Derleyicilerde olduğu gibi bu da kusursuz bir süreç değildir. Bazı doğrulama hataları "önemli"dir. Bu hatalar, doğrulama sürecinin tamamını durdurur. Bu durum, display_name="UNSPECIFIED" hataları için de geçerlidir. Bazı hatalar, doğrulama işleminin diğer hataları atlamasına neden olabilir.

KARARLILIK: 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 eskisini gizlediği için belirli bir (geçersiz) isteğin farklı bir (code, display_name) çifti oluşturmasına neden olabilir. Örneğin, "MULTIPLE ERRORS" (BİRDEN FAZLA HATA) ifadesini görebilirsiniz.

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 teslim alma işlemine şu şekilde referans verilebilir:

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

Ancak fields öğesinin kardinalitesinin belirli bir hata kodu için değişmemesi gerektiğini unutmayın.

string

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

KARARLILIK: Kararlı değil: Belirli bir code ile ilişkili hata mesajı zaman içinde değişebilir (daha net hale getirmek için). Lütfen bunun yerine display_name ve code kullanın.

string

Alanların değerlerini içerebilir. Bu seçenek her zaman kullanılamayabilir. 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 yinelemeli olarak iç içe yerleştirilmiş alt alan.

int32

Yineleniyorsa alanın dizini.

string

Alan bir haritaysa anahtar.

DataFormat

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

GcsDestination

Çıkışın yazılacağı Google Cloud Storage konumu.

bool

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

bool

Mümkün olduğunda otoyollardan kaçınılıp kaçınılmayacağını belirtir. Otoyol içermeyen rotalara öncelik verilir. Yalnızca motorlu seyahat modları için geçerlidir.

bool

Mümkün olduğunda feribotlardan kaçınılıp kaçınılmayacağını belirtir. Feribotla seyahat içermeyen rotalara öncelik verilir. Yalnızca motorlu seyahat modları için geçerlidir.

bool

İsteğe bağlıdır. Mümkün olduğunda kapalı alanlarda gezinmekten kaçınılıp kaçınılmayacağını belirtir. Bina içi navigasyon içermeyen rotalara öncelik verilir. Yalnızca WALKING seyahat modu için geçerlidir.

string

Gönderinin kullanıcı tarafından tanımlanan görünen adı. En fazla 63 karakter uzunluğunda olabilir ve UTF-8 karakterleri kullanılabilir.

VisitRequest

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

VisitRequest

Gönderiyle ilişkili teslimat alternatifleri grubu. Belirtilmezse aracın yalnızca teslim alma işlemlerine karşılık gelen bir konumu ziyaret etmesi gerekir.

map<string, Load>

Gönderinin yük talepleri (ör. ağırlık, hacim, palet sayısı vb.) Eşlemedeki anahtarlar, ilgili yükün türünü açıklayan tanımlayıcılar olmalıdır. İdeal 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 boş olarak kabul edilir.

int32

Bu sevkiyatı gerçekleştirebilecek araç grubu. Boş bırakılırsa tüm araçlar bu görevi gerçekleştirebilir. Araçlar, ShipmentModel öğesinin vehicles listesindeki dizinleriyle verilir.

double

Bu gönderi her bir araç tarafından teslim edildiğinde ortaya çıkan maliyeti belirtir. Belirtilmesi durumunda şunlardan biri olmalıdır:

• 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 içermelidir. i. öğe, modelin i numaralı 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 kısıtlamasının geçerli olduğu araçların dizinleri. Boş değilse costs_per_vehicle ile aynı sayıda öğeye sahip olmalıdır. Bir araç dizini birden fazla kez belirtilemez. Bir araç costs_per_vehicle_indices kapsamı dışında tutulursa maliyeti sıfır olur.

Duration

Teslim alma noktasından teslimat noktasına kadar olan en kısa yola kıyasla maksimum mutlak sapma süresini belirtir. Belirtilmişse negatif olmamalı ve gönderi en az bir teslim alma ve bir 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önderi için hem göreceli hem de mutlak sınırlar belirtilirse her olası teslim alma/teslimat çifti için daha kısıtlayıcı sınır kullanılır. Ekim 2017 itibarıyla, sapmalar yalnızca seyahat süreleri araçlara bağlı olmadığında desteklenir.

Duration

Bir gönderinin teslim alma başlangıcından teslimat başlangıcına kadar geçen maksimum süreyi belirtir. Belirtilmişse negatif olmamalı ve gönderi en az bir teslim alma ve bir teslimat içermelidir. Bu durum, teslim alma ve teslimat 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önderi için "tür" belirten boş olmayan dize. Bu özellik, shipment_types arasındaki uyumsuzlukları veya gereksinimleri tanımlamak için kullanılabilir (ShipmentModel içindeki shipment_type_incompatibilities ve shipment_type_requirements bölümlerine bakın).

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

string

Bu gönderi için bir etiket belirtir. Bu etiket, ilgili ShipmentRoute.Visit öğesinin shipment_label alanındaki yanıtta bildirilir.

bool

Doğru ise bu gönderiyi atla ancak penalty_cost uygulama.

Modelde shipment_type_requirements varsa bir gönderinin yoksayılması doğrulama hatasına neden olur.

injected_first_solution_routes veya injected_solution_constraint içinde gerçekleştirilen bir sevkiyatın yoksayılmasına izin verilir. Çözücü, ilgili teslim alma/teslimat ziyaretlerini gerçekleştirme rotasından kaldırır. Yoksayılan gönderilere referans veren precedence_rules da yoksayılır.

double

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

ÖNEMLİ: Bu ceza belirtilmezse sonsuz olarak kabul edilir. Diğer bir deyişle, gönderimin tamamlanması gerekir.

double

Teslim alma noktasından teslimat noktasına kadar olan en kısa yola kıyasla maksimum göreceli sapma süresini belirtir. Belirtilmişse negatif olmamalı ve gönderi en az bir teslim alma ve bir 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önderi için hem göreceli hem de mutlak sınırlar belirtilirse her olası teslim alma/teslimat çifti için daha kısıtlayıcı sınır kullanılır. Ekim 2017 itibarıyla, sapmalar yalnızca seyahat süreleri araçlara bağlı olmadığında desteklenir.

int64

İlgili ziyareti gerçekleştiren aracın yükünün değişeceği miktar. Bu değer bir tam sayı olduğundan, kullanıcıların hassasiyet kaybını önlemek için uygun bir birim seçmeleri önerilir. 0'dan büyük veya 0'a eşit olmalıdır.

LatLng

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

Waypoint

Aracın bu VisitRequest işlemini gerçekleştirirken ulaştığı ara nokta. Gönderi modelinde süre mesafe matrisleri varsa arrival_waypoint belirtilmemelidir.

LatLng

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

Waypoint

Aracın bu VisitRequest tamamlandıktan sonra ayrıldığı ara nokta. 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

Ziyarete varış zamanını kısıtlayan zaman aralıkları. Bir aracın varış zaman aralığının dışında hareket edebileceğini unutmayın. Diğer bir deyişle, varış zamanı + sürenin bir zaman aralığı içinde olması gerekmez. Araç TimeWindow.start_time tarihinden önce gelirse bekleme süresi olabilir.

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

Zaman aralıkları ayrık olmalıdır. Yani hiçbir zaman aralığı birbiriyle çakışmamalı veya bitişik olmamalı ve artan sırada olmalıdır.

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

Duration

Ziyaret süresi, yani aracın varış ve ayrılış arasında geçirdiği süre (olası bekleme süresine eklenir; bkz. time_windows).

double

Bir araç rotasında bu ziyaret isteğini yerine getirmenin maliyeti. Bu, bir gönderinin her alternatif teslim alma veya teslimat seçeneği 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 yük talepleri. Bu, Shipment.load_demands alanına benzer ancak tüm Shipment yerine yalnızca bu VisitRequest için geçerlidir. Burada listelenen talepler, Shipment.load_demands içinde listelenen taleplere eklenir.

string

Ziyaret türlerini belirtir. Bu, bir aracın bu ziyareti tamamlaması için gereken ek süreyi tahsis etmek amacıyla kullanılabilir (bkz. Vehicle.extra_visit_duration_for_visit_type).

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

bool

Bu konumdaki sürüş rotalarında U dönüşlerinden kaçınılıp kaçınılmayacağını belirtir. U dönüşünden kaçınma özelliği, en iyi sonucu vermeye çalışır ancak tamamen kaçınma garanti edilmez. Bu, deneysel bir özelliktir ve davranışında değişiklikler olabilir.

Deneysel: Daha fazla bilgi için https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request adresini ziyaret edin.

Shipment

Modelde gerçekleştirilmesi gereken gönderi grubu.

Vehicle

Ziyaretleri gerçekleştirmek için kullanılabilecek araçlar.

Objective

Bu model için maliyetlere dönüştüreceğimiz hedef grubu. Boş değilse giriş modeli ücretsiz olmalıdır. Değiştirilen isteği almak için lütfen solving_mode = TRANSFORM_AND_RETURN_REQUEST kullanın. Bu durumda isteğin çözüme kavuşturulmayacağını unutmayın. İlgili belgelere bakın.

Deneysel: Daha fazla bilgi için https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request adresini ziyaret edin.

Timestamp

Modelin genel başlangıç ve bitiş zamanı: Bu aralığın dışındaki zamanlar geçerli kabul edilemez.

Modelin zaman aralığı bir yıldan kısa olmalıdır. Diğer bir deyişle, global_end_time ve global_start_time arasındaki fark 31.536.000 saniyeden az olmalıdır.

cost_per_*hour alanlarını kullanırken performansı artırmak için bu zaman aralığını 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 00:00:00 UTC, 1 Ocak 1970 (yani saniye: 0, nanosaniye: 0) kullanılır.

Timestamp

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

double

Genel planın "global 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, işi en kısa sürede tamamlamak için optimizasyon yapmak amacıyla bu miktara saatlik 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 ile duration_distance_matrix_dst_tags boş olamaz.

Kullanım örnekleri:

• İki konum vardır: locA ve locB.
• 1 araç, rotasına locA'da başlayıp locA'da bitiriyor.
• locB konumunda 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 var: locA, locB ve locC.
• "fast" matrisini kullanarak rotasına locA'da başlayıp locB'de bitiren 1 araç.
• 1 araç, "yavaş" matrisini kullanarak rotasına locB'de başlayıp locB'de bitiriyor.
• "Hızlı" matrisini kullanarak rotasına locB'de başlayıp locB'de biten 1 araç.
• locC konumunda 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) etiketli ziyaretlerden i matrisindeki diğer ziyaretlere olan süreleri ve mesafeleri tanımlar.

Etiketler VisitRequest.tags veya Vehicle.start_tags ile ilgilidir. Belirli bir VisitRequest veya Vehicle, bu alandaki tam olarak bir etiketle eşleşmelidir. Vehicle'nin kaynak, hedef ve matris etiketlerinin aynı olabileceğini, benzer şekilde VisitRequest'nin kaynak ve hedef etiketlerinin de aynı olabileceğini unutmayın. 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) (veya duration_distance_matrices(i).rows(j).meters(k)), i matrisinde duration_distance_matrix_src_tags(j) etiketli ziyaretlerden duration_distance_matrix_dst_tags(k) etiketli ziyaretlere yapılan seyahatin süresini (veya mesafesini) tanımlar.

Etiketler VisitRequest.tags veya Vehicle.start_tags ile ilgilidir. Belirli bir VisitRequest veya Vehicle, bu alandaki tam olarak bir etiketle eşleşmelidir. Vehicle'nin kaynak, hedef ve matris etiketlerinin aynı olabileceğini, benzer şekilde VisitRequest'nin kaynak ve hedef etiketlerinin de aynı olabileceğini unutmayın. 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 kümeleri (ShipmentTypeIncompatibility bölümüne bakın).

ShipmentTypeRequirement

shipment_type şartları (ShipmentTypeRequirement bölümüne bakın).

PrecedenceRule

Modelde uygulanması gereken öncelik kuralları kümesi.

ÖNEMLİ: Öncelik kurallarının kullanılması, optimize edilebilecek sorunun boyutunu sınırlar. Çok sayıda gönderi içeren öncelik kurallarını kullanan istekler reddedilebilir.

int32

Etkin araçların maksimum sayısını kısıtlar. Rotası en az bir sevkiyat gerçekleştiriyorsa araç 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. 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 öğeye sahip olmalıdır.

string

Bu süre ve mesafe matrisinin hangi araçlar için geçerli olduğunu tanımlayan etiket. Boş bırakılırsa bu, tüm araçlar için geçerli olur 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 o matrisin) vehicle_start_tag değeriyle 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 öğeye sahip olmalıdır.

double

Belirli bir satırın mesafe değerleri. Modeldeki mesafelerle ilgili herhangi bir maliyet veya kısıtlama yoksa bu alan boş bırakılabilir. Aksi takdirde, durations kadar öğe içermelidir.

Type

Hedefin türü.

double

Bu hedefin diğerlerine kıyasla ne kadar önemli olduğu. Bu, negatif olmayan herhangi bir sayı olabilir. Ağırlıkların toplamının 1 olması gerekmez. Ağırlıklar varsayılan olarak 1,0 değerine ayarlanır.

bool

"İlk" etkinliğin teslimat olup olmadığını gösterir.

bool

"İkinci" etkinliğin bir teslimat olup olmadığını gösterir.

Duration

"İlk" ve "ikinci" etkinlik arasındaki fark. Negatif olabilir.

int32

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

int32

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

int32

Rotayı gerçekleştiren araç, kaynak ShipmentModel içindeki diziniyle tanımlanır.

string

Belirtilmişse bu rotayı izleyen aracın etiketi (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 sıralı ziyaret dizisi. visits[i], rotadaki i. ziyarettir. Bu alan boşsa araç kullanılmamış olarak kabul edilir.

Transition

Rota için sıralı geçiş listesi.

bool

OptimizeToursRequest.consider_road_traffic, "true" 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ı karşılanırken ilk ziyaretten önce veya son ziyaretten sonra trafiğe göre ayarlanmış seyahat, gecikme ve ziyaretler arasındaki molaları tamamlamak için yeterli süre olmayabilir. Örneğin,

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

Trafik nedeniyle seyahat süresi tahmini travel_duration(previous_visit, next_visit) arttığından, next_visit noktasına varış muhtemelen mevcut zaman aralığından daha geç gerçekleşecek. Ayrıca, seyahat süresi tahminlerindeki artış ve ziyaret veya mola zaman aralığı kısıtlamaları nedeniyle bir mola, ziyaretle çakışmaya zorlanabilir.

EncodedPolyline

Rotanın kodlanmış çoklu çizgi gösterimi. Bu alan yalnızca OptimizeToursRequest.populate_polylines doğru değerine ayarlanırsa doldurulur.

Break

Bu rotayı izleyen araç için planlanan molalar. breaks dizisi, her biri ilgili start_time değerinde başlayan ve duration saniye süren zaman aralıklarını temsil eder.

AggregatedMetrics

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

VehicleFullness

VehicleFullness alanı, sınırlı metriklerin ilgili araç sınırlarına ne kadar yakın olduğunu hesaplamak için kullanılır. Alanları, sınırlı bir metrik alanı (ör. AggregatedMetrics.travel_distance_meters) ile ilgili araç sınırı (ör. Vehicle.route_distance_limit) arasındaki oranlardır.

Deneysel: Bu alanın davranışı veya varlığı gelecekte değişebilir.

map<string, double>

Maliyetle ilgili istek alanlarına göre dökümü alınmış rota maliyeti. Anahtarlar, giriş OptimizeToursRequest'e göre proto yollarıdır (ör. "model.shipments.pickups.cost"). Değerler ise ilgili maliyet alanı tarafından oluşturulan ve tüm rota üzerinden toplanan toplam maliyettir. Diğer bir deyişle, costs["model.shipments.pickups.cost"], rota üzerindeki tüm teslim alma masraflarının toplamıdır. Modelde tanımlanan tüm maliyetler, yalnızca 2022/01 itibarıyla toplu olarak raporlanan TransitionAttributes ile ilgili maliyetler hariç olmak üzere burada ayrıntılı olarak raporlanır.

double

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

Timestamp

Aranın başlangıç zamanı.

Duration

Molanın 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 katedilen mesafe.

bool

Trafik OptimizeToursRequest.consider_road_traffic üzerinden istendiğinde ve trafik bilgileri Transition için alınamadığında bu boole değeri "true" olarak ayarlanır. Bu durum geçici (gerçek zamanlı trafik sunucularında nadiren görülen bir aksaklık) 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 (varsa) toplam süresi. Her aranın başlangıç zamanı ve süresiyle ilgili ayrıntılar ShipmentRoute.breaks içinde saklanır.

Duration

Bu geçiş sırasında beklemede geçen süre. Bekleme süresi, boşta kalma süresine karşılık gelir ve mola süresini içermez. Bu bekleme süresinin, bitişik olmayan birkaç aralığa bölünebileceğini de unutmayın.

Duration

Geçişin toplam süresi (kolaylık sağlamak için verilmiştir). Şuna eşittir:

• sonraki ziyaret start_time (veya bu son geçişse vehicle_end_time) - bu geçişin start_time;
• ShipmentRoute.has_traffic_infeasibilities yanlışsa 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 izlenen 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 yeni rota çizilmesi durumunda rota oluşturulurkenki asıl niyeti dikkate almak için Navigation SDK'ya iletilebilen 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, istekler arasında değerini 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, bu aracın Vehicle.load_limits değerinde görünen veya bu rotada gerçekleştirilen bazı gönderilerde sıfır olmayan Shipment.load_demands değerine sahip her tür için araç yükleri.

İlk geçiş sırasındaki yükler, araç rotasının başlangıç yükleridir. Ardından, her ziyaretten sonra, ziyaretin load_demands, ziyaretin teslim alma veya teslimat olmasına bağlı olarak bir sonraki geçişin yüklerini elde etmek için eklenir veya çıkarılır.

int64

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

int32

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

bool

Doğruysa ziyaret, Shipment teslim alma işlemine 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 yerine bu saatten daha erken varabileceğini unutmayın. Saatler ShipmentModel ile tutarlıdır.

map<string, Load>

Toplam ziyaret yükü talebi, gönderi ve ziyaret isteğinin toplamıdır load_demands. Ziyaret bir teslimat ise değerler negatiftir. Talepler, Transition.loads ile aynı türler için raporlanır (bu alana bakın).

Duration

Ziyaretten önce rotada ziyaret edilen gönderiler ve zaman aralıklarının neden olduğu potansiyel bekleme süresi nedeniyle ek rota değiştirme süresi. Ziyaret bir teslimat ise sapma, 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, araç start_location değerinden 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 öğesinin kopyası.

string

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

VisitType

İsteğe bağlıdır. Ziyaretin türünü belirtir. Visit.is_pickup alanını geçersiz kılar.

int32

Ziyaret edilen konumla ilgili bilgileri temsil eden opak bir jeton.

Bu ziyaret için VisitRequest.avoid_u_turns true olarak ayarlandıysa veya OptimizeToursRequest isteğinde ShipmentModel.avoid_u_turns true olarak ayarlandıysa bu alan, sonuç rotalarının ziyaretlerinde doldurulabilir.

Deneysel: Daha fazla bilgi için https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request adresini ziyaret edin.

string

Uyumsuz türlerin listesi. Listelenenler arasında farklı shipment_types değerine sahip iki gönderi "uyumsuz" olarak kabul edilir.

IncompatibilityMode

Uyumsuzluğa uygulanan mod.

string

dependent_shipment_types için gereken alternatif gönderim türlerinin listesi.

string

dependent_shipment_types alanında bir tür bulunan tüm gönderiler için aynı rotada en az bir required_shipment_type_alternatives türü gönderinin ziyaret edilmesi gerekir.

NOT: Bir shipment_type öğesinin kendisine bağlı olduğu şart zincirlerine izin verilmez.

RequirementMode

Şarta uygulanan mod.

int32

Dizin, kaynak ShipmentModel içindeki gönderinin dizinine karşılık gelir.

string

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

Reason

Gönderimin neden atlandığını açıklayan nedenlerin listesi. Yukarıdaki Reason yorumuna bakın. Bir gönderimin neden atlandığını anlayamazsak nedenler ayarlanmaz.

double

Bu, Shipment.penalty_cost kopyasıdır ve atlanan bir gönderimin önem derecesini daha kolay görmenizi sağlamak için buraya eklenmiştir.

Deneysel: Bu alanın davranışı veya varlığı gelecekte değişebilir.

double

Aşağıdaki nedenlerden en az biri nedeniyle bu sevkiyatı gerçekleştiremeyen araçların tahmini oranı. Not: Bu alan yalnızca nedenler bir araçla ilgili olduğunda doldurulur.

Deneysel: Bu alanın davranışı veya varlığı gelecekte değişebilir.

Code

Kodun yorumlarına bakın.

int32

example_vehicle_index ile aynıdır ancak tanımlanan birden fazla aracın listesini sağlarız. Bu liste tam kapsamlı olmayabilir. Bu alan yalnızca [fill_example_vehicle_indices_in_skipped_reasons][] doğru olduğunda doldurulur.

Deneysel: Bu alanın davranışı veya varlığı gelecekte değişebilir.

string

Neden kodu DEMAND_EXCEEDS_VEHICLE_CAPACITY ise aşılan bir kapasite türünü belgeler.

int32

Neden, gönderi-araç uyumsuzluğuyla ilgiliyse bu alan, ilgili bir aracın dizinini sağlar.

Timestamp

Kesin zaman aralığının başlangıç zamanı. Belirtilmezse ShipmentModel.global_start_time olarak ayarlanır.

Timestamp

Kesin zaman aralığının bitiş zamanı. Belirtilmezse ShipmentModel.global_end_time olarak ayarlanır.

Timestamp

Zaman aralığının esnek başlangıç zamanı.

Timestamp

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

double

Etkinlik soft_start_time'dan ö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 ayarlanmışsa 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 ayarlanmışsa ayarlanabilir.

string

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

Kaynak ziyaret veya araç başlangıcı, yalnızca VisitRequest.tags ya da Vehicle.start_tags değerinin src_tag değerini içermesi veya excluded_src_tag değerini içermemesi durumunda (bu iki alandan hangisinin boş olmadığına bağlı olarak) eşleşir.

string

Şu sayfaya göz atın: src_tag. src_tag ve excluded_src_tag alanlarından yalnızca biri boş olmamalıdır.

string

Bir varış noktası ziyareti veya araç sonu, yalnızca VisitRequest.tags ya da Vehicle.end_tags değeri dst_tag değerini içeriyorsa veya excluded_dst_tag değerini 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 alanlarından yalnızca biri boş olmamalıdır.

double

Bu geçişi gerçekleştirmenin maliyetini belirtir. Bu değer, modeldeki diğer tüm maliyetlerle aynı birimdedir ve negatif olmamalıdır. Bu ücret, mevcut diğer tüm maliyetlere ek olarak uygulanır.

double

Bu geçiş gerçekleştirilirken kat edilen mesafeye uygulanan kilometre başına maliyeti belirtir. Araçlarda belirtilen Vehicle.cost_per_kilometer değerine eklenir.

DistanceLimit

Bu geçişi gerçekleştirirken kat edilen mesafe için bir sınır belirtir.

Haziran 2021 itibarıyla yalnızca esnek sınırlar desteklenmektedir.

Duration

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

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

string

Kaynağın URI'si. Kaynak henüz mevcut olmayabilir.

Kaynağın içeriği JSON veya textproto olarak kodlanır. Yalnızca Google Cloud Storage kaynakları desteklenir. Kaynak JSON olarak kodlanmışsa kaynak adının sonuna .json eklenmelidir. Kaynak, textproto olarak kodlanmışsa kaynak adının sonuna .txtpb eklenmelidir. Örneğin, JSON kodlu bir dosyanın Google Cloud Storage URI'si şu şekilde görünebilir: gs://bucket/path/input/object.json.

string

Aracın kullanıcı tarafından tanımlanan görünen adı. En fazla 63 karakter uzunluğunda olabilir ve UTF-8 karakterleri kullanılabilir.

TravelMode

Aracın kullanabileceği yolları ve hızını etkileyen seyahat modu. travel_duration_multiple başlıklı makaleyi de inceleyin.

RouteModifiers

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

LatLng

Aracın herhangi bir gönderiyi teslim almadan önce yola çıktığı coğrafi konum. Belirtilmezse araç ilk teslim alma noktasından başlar. Gönderi modelinde süre ve mesafe matrisleri varsa start_location belirtilmemelidir.

Waypoint

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

LatLng

Aracın son VisitRequest görevini tamamladıktan sonra ulaştığı coğrafi konum. Belirtilmezse aracın ShipmentRoute, son VisitRequest tamamlandığında hemen sona erer. Gönderi modelinde süre ve mesafe matrisleri varsa end_location belirtilmemelidir.

Waypoint

Aracın son VisitRequest görevini tamamladıktan sonra ulaştığı coğrafi konumu temsil eden ara nokta. end_waypoint veya end_location belirtilmezse aracın ShipmentRoute, son VisitRequest tamamlandığında hemen sona erer. Gönderi modelinde süre ve mesafe matrisleri varsa end_waypoint belirtilmemelidir.

string

Aracın rotasının başlangıcı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ı. Genel zaman sınırları içinde olmalıdır (ShipmentModel.global_* alanlarına bakın). Belirtilmezse bu genel zaman sınırları dışında bir sınırlama yoktur.

Aynı yinelenen alana ait zaman pencereleri birbirinden ayrı olmalıdır. Diğer bir deyişle, hiçbir zaman penceresi birbiriyle çakışamaz veya bitişik olamaz ve 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 varabileceği zaman aralıkları. Genel zaman sınırları içinde olmalıdır (ShipmentModel.global_* alanlarına bakın). Belirtilmezse bu genel zaman sınırları dışında bir sınırlama yoktur.

Aynı yinelenen alana ait zaman pencereleri birbirinden ayrı olmalıdır. Diğer bir deyişle, hiçbir zaman penceresi birbiriyle çakışamaz veya bitişik olamaz ve 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 boşaltma politikası uygulanıyor.

map<string, LoadLimit>

Aracın kapasitesi (ör. ağırlık, hacim, palet sayısı) Eşlemedeki 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 eşlemede yoksa ilgili kapasite sınırsız olarak kabul edilir.

double

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

Araç rotasının saat başına maliyeti. Bu maliyet, rotanın toplam süresine uygulanır ve seyahat süresi, bekleme süresi ve ziyaret süresini içerir. Yalnızca cost_per_traveled_hour yerine cost_per_hour kullanmak ek gecikmeye neden olabilir.

double

Araç rotasının seyahat edilen saat başına maliyeti. Bu maliyet yalnızca rota tarafından kullanılan seyahat süresine (yani ShipmentRoute.transitions içinde bildirilen süreye) uygulanır ve bekleme süresi ile ziyaret süresini hariç tutar.

double

Araç rotasının kilometre başına maliyeti. Bu maliyet, ShipmentRoute.transitions içinde bildirilen mesafeye uygulanır ve tek bir VisitRequest için arrival_location ile departure_location arasında dolaylı olarak kat edilen mesafeye uygulanmaz.

double

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

bool

Bu alan, yalnızca rotaları herhangi bir gönderiye hizmet vermeyen 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önderi teslim etmese bile başlangıç konumundan bitiş konumuna gider ve başlangıç --> bitiş yolculuğundan kaynaklanan zaman ve mesafe maliyetleri hesaba katılır.

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

DurationLimit

Aracın rotasının toplam süresine uygulanan sınır. Belirli bir OptimizeToursResponse için 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 için rota seyahat süresi, tüm transitions.travel_duration değerlerinin toplamıdır.

DistanceLimit

Aracın rotasının toplam mesafesine uygulanan sınır. Belirli bir OptimizeToursResponse için rota mesafesi, tüm transitions.travel_distance_meters değerlerinin 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 değerine ek olarak harcanacak 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ğinde birden fazla tür varsa haritadaki her tür için bir süre eklenir.

BreakRule

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

string

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

bool

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

injected_first_solution_routes içinde yok sayılan bir araç tarafından gerçekleştirilen sevkiyatlar ilk çözümde atlanır ancak yanıtta gerçekleştirilebilir.

injected_solution_constraint içinde yok sayılan bir araç tarafından bir sevkiyat gerçekleştirilirse ve ilgili teslim alma/teslimat, araçta kalacak şekilde kısıtlanırsa (yani RELAX_ALL_AFTER_THRESHOLD düzeyine gevşetilmezse) yanıtta atlanır. Bir gönderinin allowed_vehicle_indices alanı boş değilse ve izin verilen tüm araçlar yoksayılırsa yanıtta bu gönderi atlanır.

double

Bu aracın seyahat sürelerini artırmak veya azaltmak için kullanılabilecek bir çarpma faktörü belirtir. Örneğin, bu değeri 2,0 olarak ayarlarsanız bu araç daha yavaş olur ve seyahat süreleri standart araçların iki katı olur. Bu çarpan, ziyaret sürelerini etkilemez. cost_per_hour veya cost_per_traveled_hour belirtilmişse maliyeti etkiler. Bu değer [0,001, 1000,0] aralığında olmalıdır. Bu değer ayarlanmazsa araç standarttır ve bu çarpan 1,0 olarak kabul edilir.

UYARI: Seyahat süreleri, bu kat sayı uygulandıktan sonra ancak herhangi bir sayısal işlem yapılmadan önce en yakın saniyeye yuvarlanır. Bu nedenle, küçük bir kat sayı 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 olacak şekilde kısıtlayan kesin bir sınır.

Duration

Maksimum süre sınırını zorunlu kılmayan ancak ihlal edildiğinde rotanın maliyetini artıran esnek bir sınırdır. Bu maliyet, modelde tanımlanan diğer maliyetlere aynı birimle eklenir.

Tanımlanmışsa soft_max_duration negatif olmamalıdır. max_duration da tanımlanmışsa soft_max_duration, max_duration'dan küçük olmalıdır.

Duration

Maksimum süre sınırını zorunlu kılmayan ancak ihlal edildiğinde rotanın maliyetini artıran esnek bir sınır. Bu maliyet, sürenin karesiyle orantılıdır. Bu maliyet, modelde tanımlanan diğer maliyetlere aynı birimle eklenir.

quadratic_soft_max_duration ayarlanırsa aşağıdaki koşulların karşılanması gerekir:

• Negatif olmamalıdır.
• max_duration tanımlanmalıdır.
• quadratic_soft_max_duration, max_duration değerinden küçük olmalıdır.
• Fark en fazla bir gün olmalıdır: max_duration - quadratic_soft_max_duration <= 86400 seconds

double

soft_max_duration eşiği ihlal edilirse saatlik maliyet. Süre eşiğin altındaysa ek maliyet 0 olur. Aksi takdirde maliyet, süreye bağlı olarak aşağıdaki gibi değişir:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

Maliyet negatif olmamalıdır.

double

quadratic_soft_max_duration eşiği ihlal edilirse tahakkuk eden saat başına maliyet.

Süre eşiğin altındaysa ek maliyet 0 olur. Aksi takdirde maliyet, süreye bağlı olarak aşağıdaki gibi hesaplanır:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

Maliyet negatif olmamalıdır.

int64

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

double

Bu aracın rotası boyunca yük soft_max_load değerini aşarsa şu 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. Esnek sınırlar, yalnızca model genelinde yalnızca teslim alma veya yalnızca teslimat için geçerli olan türlerde tanımlanabilir.

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

LoadCost

Bu araç için bir birim yükün bir kilometre taşınmasının maliyeti. Bu, yakıt tüketimi için bir proxy olarak kullanılabilir: Yük bir ağırlıksa (Newton cinsinden), yük*kilometre bir enerji boyutuna sahiptir.

Deneysel: Daha fazla bilgi için https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request adresini ziyaret edin.

LoadCost

Bu araç için bir saat boyunca bir birim yükle seyahat etmenin maliyeti.

Deneysel: Daha fazla bilgi için https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request adresini ziyaret edin.

int64

Kabul edilebilir minimum yük. 0 veya daha büyük olmalıdır. Her ikisi de belirtilmişse min, max değerinden küçük veya bu değere eşit olmalıdır.

int64

Kabul edilebilir maksimum yük. 0 veya daha büyük olmalıdır. Belirtilmezse maksimum yük bu mesajla kısıtlanmaz. Her ikisi de belirtilmişse min, max değerinden küçük veya bu değere eşit olmalıdır.

int64

Bir yük birimini taşıma maliyetinin cost_per_unit_below_threshold değerinden cost_per_unit_above_threshold değerine değiştiği yük miktarı. 0'dan büyük veya 0'a eşit olmalıdır.

double

0 ile eşik arasındaki her birim için bir yük birimini taşıma maliyeti. Sonlu bir değer ve >= 0 olmalıdır.

double

Eşik değerin üzerindeki her birim için bir yük birimini taşıma maliyeti. Eşik = 0 olan özel durumda bu, birim başına sabit bir maliyettir. Sonlu bir değer ve >= 0 olmalıdır.

double

Bu mesajdaki diğer tüm alanların maksimum değeri.

double

AggregatedMetrics.travel_distance_meters ile Vehicle.route_distance_limit arasındaki oran. Vehicle.route_distance_limit ayarlanmazsa bu alan da ayarlanmaz.

double

[AggregatedMetrics.travel_duration_seconds][] ile Vehicle.travel_duration_limit arasındaki oran. Vehicle.travel_duration_limit ayarlanmazsa bu alan da ayarlanmaz.

double

[AggregatedMetrics.total_duration_seconds][] ile Vehicle.route_duration_limit arasındaki oran. Vehicle.route_duration_limit ayarlanmazsa bu alan da ayarlanmaz.

double

Tüm [AggregatedMetrics.max_load][] türleri ve ilgili Vehicle.load_limits arasındaki maksimum oran. Tüm Vehicle.load_limits alanları ayarlanmamışsa bu alan da ayarlanmaz.

double

Belirli bir araç için (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) oranı. Payda yoksa bunun yerine (ShipmentModel.global_end_time - ShipmentModel.global_start_time) kullanılır.

bool

İsteğe bağlıdır. Bu ara noktanın konumu, aracın yolun belirli bir tarafında durması için bir tercih olduğunu gösterir. Bu değeri ayarladığınızda rota, konumdan geçer. Böylece araç, yolun merkezinden konuma doğru eğimli olan tarafında durabilir. Bu seçenek, "YÜRÜYEREK" seyahat modu için kullanılamaz.

bool

Ara noktanın, araçların yolcu almak veya indirmek için durması gereken bir yer olduğunu gösterir. Bu seçenek yalnızca "SÜRÜŞ" seyahat modu ve "location_type" değeri "location" olduğunda kullanılabilir.

Deneysel: Bu alanın davranışı veya varlığı gelecekte değişebilir.

Location

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

string

Ara noktayla ilişkili ÖY yer kimliği.

Bir VisitRequest'in varış veya kalkış konumunu belirtmek için yer kimliği kullanırken, yere navigasyon için LatLng konumunu belirleyecek kadar spesifik bir yer kimliği kullanın. Örneğin, bir binayı temsil eden yer kimliği uygundur ancak bir yolu temsil eden yer kimliği önerilmez.