Rota Optimizasyonu API'si iki yöntem sunar:
OptimizeTours
,OptimizeToursRequest
'e yanıt olarak optimize edilmiş bir rota döndüren eşzamanlı bir yöntemdir. İstemciler, istek işlenipOptimizeToursResponse
veya hata döndürülene kadar Route Optimization API ile açık bir bağlantıyı sürdürmelidir.BatchOptimizeTours
, bir veya daha fazlaOptimizeToursRequest
ve karşılık gelenOptimizeToursResponse
mesajı için URI'ları kabul eden eşzamansız bir yöntemdir ve toplu tamamlamayı kontrol etmek için kullanılan Uzun Süreli İşlem'in (LRO) (REST, gRPC) kaynak adını döndürür.OptimizeToursRequest
'lar arka planda işlenir. Böylece istemcilerin, Route Optimization API'ye yönelik açık bağlantıları yalnızcaBatchOptimizeToursRequest
GetOperation
BatchOptimizeTours
, Google Cloud Storage'dan istekleri okur ve yanıtları yazar.
Kullanım Alanları
OptimizeTours
, küçük ve basit istekleri veya birkaç dakika ya da daha kısa sürede çözülmesi gereken istekler için uygundur. Route Optimization API ile uzun süreli bağlantı kurulması, çözüm üretilmeden önce kesinti riskini artırır. Daha fazla bilgi için Zaman Aşımı ile Çalışma bölümüne bakın.
BatchOptimizeTours
, Route Optimization API'ye uzun süreli bağlantı gerektirmediğinden daha büyük istekleri ve istekleri daha uzun sürede ele alabilir.
Uzun Süreli İşlemler
LRO'lar, bir grubun tamamlanma durumunu kontrol etmek için GetOperation
yöntemi kullanılarak Route Optimization API'den okunur. LRO'lar, tüm grubun işlenmesinin tamamlanıp tamamlanmadığını belirten bir done
özelliği ve işleme sırasında karşılaşılan hataları bildiren bir error
alanı içerir. done
true (doğru) değerine ayarlanırsa ve hiç error
yoksa grup başarıyla tamamlanır. error
etiketinin varlığı, toplu işlemin bir kısmının veya tamamının işlenemediğini gösterir.
Bir BatchOptimizeTours
isteğinin tipik yaşam döngüsü aşağıdaki gibidir:
- Rota Optimizasyonu API'sine bir
BatchOptimizeToursRequest
gönderin. Bu API, LRO'nun kaynak adını döndürür. - LRO yanıtında
done
veyaerror
özellikleri görünene kadar döndürülen LRO kaynağı adını içerenGetOperation
anketi. done
doğruysa ve herhangi bir hata yoksaBatchOptimizeTours
isteğinde belirtilen Google Cloud Storage URI'larındanOptimizeToursResponses
öğesini okuyun.error
varsa hatayı inceleyin, Google Cloud Storage'daOptimizeToursRequest
öğelerini uygun şekilde güncelleyin ve gözlemlenen hataya bağlı olarak yeniden deneyin.
OptimizeTours
ve BatchOptimizeTours
isteklerini, komut satırından veya istemci kitaplığından yararlanarak çeşitli yollarla gönderebilirsiniz.