Method: projects.locations.optimizeTours

{
  "timeout": string,
  "model": {
    object (ShipmentModel)
  },
  "solvingMode": enum (SolvingMode),
  "searchMode": enum (SearchMode),
  "injectedFirstSolutionRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "injectedSolutionConstraint": {
    object (InjectedSolutionConstraint)
  },
  "refreshDetailsRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "interpretInjectedSolutionsUsingLabels": boolean,
  "considerRoadTraffic": boolean,
  "populatePolylines": boolean,
  "populateTransitionPolylines": boolean,
  "allowLargeDeadlineDespiteInterruptionRisk": boolean,
  "useGeodesicDistances": boolean,
  "label": string,
  "geodesicMetersPerSecond": number,
  "maxValidationErrors": integer
}

string (Duration format)

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

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

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

object (ShipmentModel)

Çözülmesi gereken gönderim modeli.

enum (SolvingMode)

Çözme modu varsayılan olarak DEFAULT_SOLVE (0) şeklindedir.

enum (SearchMode)

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

object (ShipmentRoute)

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

Model, ilk çözüm oluşturulduğunda kısıtlanır. Bir rota üzerinde gerçekleştirilmeyen tüm sevkiyatlar, ilk çözümde dolaylı olarak atlanır, ancak birbirini izleyen çözümlerde kullanılabilir.

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

• tüm rotalar için, vehicleIndex aralık dahilinde olmalı ve yinelenmemelidir.
• tüm ziyaretler için shipmentIndex ve visitRequestIndex aralık dahilinde olmalıdır.
• bir gönderime yalnızca bir rotada referans verilebilir.
• Teslim alınacak kargonun teslim alınması, teslimattan önce yapılmalıdır.
• bir kargo için en fazla bir teslim alma veya teslimat alternatifi gerçekleştirilemez.
• tüm rotalar için süre artıyor (ör. vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime) bilgileri gösterilir.
• Gönderim yalnızca izin verilen araçlarda yapılabilir. Shipment.allowed_vehicle_indices boşsa veya vehicleIndex özelliği Shipment.allowed_vehicle_indices içinde bulunuyorsa araca izin verilir.

Yerleştirilen çözüm uygulanabilir değilse doğrulama hatası her zaman döndürülmez ve bunun yerine uygulanabilir olmadığını belirten bir hata döndürülebilir.

object (InjectedSolutionConstraint)

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

Yerleştirilen çözüm uygulanabilir değilse doğrulama hatası her zaman döndürülmez ve bunun yerine uygulanabilir olmadığını belirten bir hata döndürülebilir.

object (ShipmentRoute)

Boş olmayan 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.

2020/11 itibarıyla bu işlem, yalnızca boş olmayan rotaların çoklu çizgilerini dolduruyor ve populatePolylines değerinin doğru olmasını gerektiriyor.

Geçilen rotaların routePolyline alanları, transitions rotasıyla tutarsız olabilir.

Bu alan, injectedFirstSolutionRoutes veya injectedSolutionConstraint ile birlikte kullanılmamalıdır.

Shipment.ignore ve Vehicle.ignore öğelerinin davranış üzerinde herhangi bir etkisi yoktur. İlgili gönderilerin veya araçların yoksayılıp sayılmadığından bağımsız olarak, boş olmayan tüm rotalardaki tüm ziyaretler arasında çoklu çizgiler doldurulmaya devam eder.

boolean

Eğer doğruysa:

• Enjekte edilen çözümdeki rotaları istekteki araçlarla eşleştirmek için vehicleIndex yerine ShipmentRoute.vehicle_label kullanır; Boş değilse ConstraintRelaxation.vehicle_indices öğesini güncellemek için orijinal ShipmentRoute.vehicle_index ile yeni ShipmentRoute.vehicle_index eşlemesini yeniden kullanır, ancak eşlemenin belirsiz olması gerekir (yani birden fazla ShipmentRoute aynı orijinal vehicleIndex öğesini paylaşmamalıdır).
• Yerleştirilen bir çözümdeki ziyaretleri, istekteki gönderilerle eşleştirmek için shipmentIndex yerine ShipmentRoute.Visit.shipment_label kullanır;
• enjekte edilen çözümdeki atlanan gönderileri istek gönderimleriyle eşleştirmek için SkippedShipment.index yerine SkippedShipment.label kullanır.

Bu yorum injectedFirstSolutionRoutes, injectedSolutionConstraint ve refreshDetailsRoutes alanları için geçerlidir. Çözüm oluşturulduktan sonra talepteki gönderim veya araç endeksleri değiştiğinde (talepten gönderilerin ya da araçların çıkarılması veya eklenmesi gibi) kullanılabilir.

Doğru değerine ayarlanırsa aşağıdaki kategorilerdeki etiketler, kategorilerinde en fazla bir kez görünmelidir:

• İstekte Vehicle.label;
• İstekte Shipment.label;
• Enjekte edilen çözeltide ShipmentRoute.vehicle_label;
• Yerleştirilen çözümdeki SkippedShipment.label ve ShipmentRoute.Visit.shipment_label (shipmentLabel öğesinin iki kez görünmesi gereken teslim alma/teslimat ziyaret çiftleri hariç).

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

Yerleştirilen bir çözümden rota ziyaretlerini veya rotaların tamamını kaldırmak, ima edilen kısıtlamaları etkileyebilir ve bu da çözümde, doğrulama hatalarında veya uygulanabilirlikte değişikliğe yol açabilir.

NOT: Arayan, her bir Vehicle.label (resp. Shipment.label), iki ilgili istekte kullanılan araç (resp. sevkiyat) tüzel kişiliğini benzersiz bir şekilde tanımlar: enjekte edilen çözümde kullanılan OptimizeToursResponse öğesini üreten geçmiş istek ve eklenen çözümü içeren mevcut istek. Yukarıda açıklanan benzersizlik kontrolleri bu koşulu garanti etmek için yeterli değildir.

boolean

Transition.travel_duration, Visit.start_time ve vehicleEndTime ShipmentRoute alanlarını hesaplarken trafik tahminini göz önünde bulundurun; ShipmentRoute.has_traffic_infeasibilities alanının ayarlanmasında ve OptimizeToursResponse.total_cost alanının hesaplanmasında kullanılır.

boolean

Doğru değerine ayarlanırsa yanıt ShipmentRoute'lerinde çoklu çizgiler doldurulur.

boolean

Doğru değerine ayarlanırsa ShipmentRoute.transitions yanıtında çoklu çizgiler doldurulur.

boolean

Bu ayarlanırsa isteğin son tarihi 60 dakikadır (bkz. https://grpc.io/blog/deadlines). Aksi takdirde, maksimum son tarih yalnızca 30 dakikadır. Uzun süreli isteklerin çok daha büyük (ancak yine de küçük) kesinti riskinin olduğunu unutmayın.

boolean

Doğru değerine ayarlanırsa seyahat mesafeleri, Google Haritalar'daki mesafeler yerine jeodezik mesafeler kullanılarak ve seyahat süreleri, geodesicMetersPerSecond tarafından tanımlanan hıza sahip jeodezik mesafeler kullanılarak hesaplanır.

string

Bu isteği tanımlamak için kullanılabilecek etiket (OptimizeToursResponse.request_label) bildirilmiştir.

number

useGeodesicDistances Doğru değerine ayarlandığında 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.

integer

Döndürülen doğrulama hatalarının sayısını kısaltır. Bu hatalar genellikle bir INVALID_CHANGES hata yüküne BadRequest hata ayrıntısı olarak eklenir (https://cloud.google.com/apis/design/errors#error_details). resolveMode=METRICATE_ONLY: OptimizeToursResponse.validation_errors alanına bakın. Bu değer varsayılan olarak 100'e ayarlanır ve üst sınır 10.000'dir.