Zaman aşımlarını ve son tarihleri yapılandırma

Bu belgede, Route Optimization API istekleri için zaman aşımı ve son tarih ayarlarının nasıl yapılandırılacağı açıklanmaktadır. Bu değerlerin ayarlanmaması veya yanlış ayarlanması, bağlantı ya da yanıt kalitesi sorunlarına neden olabilir.

Zaman aşımını istek gövdesinde, son tarihi ise istek başlığında tanımlarsınız. Route Optimization API, isteği bu parametrelerle tanımlanan zaman sınırı içinde işler ve en kısa süre değerini dikkate alır.

Zaman aşımlarını ve son tarihleri yapılandırarak işlem süresini aşağıdaki şekillerde yönetebilirsiniz:

• İşleme süresini artırma:
  • Karmaşık istekleri çözme
  • Daha kaliteli bir yanıt alma
• İşleme süresini kısaltma:
  • Düşük karmaşıklıktaki istekleri varsayılandan daha hızlı çözün.
  • İsteği daha kısa sürede çözmek ancak daha düşük kaliteli bir yanıt almak.

Zaman aşımı ve son tarih ihtiyaçlarınızı anlama

Zaman aşımlarınızı ve son tarihlerinizi yapılandırmadan önce bu bölümü inceleyerek uç nokta ve protokol seçimlerinizin bu ayarları nasıl etkilediğini anladığınızdan emin olun.

Aşağıdaki yönergeler, hedefleriniz için doğru kurulumu kullanıp kullanmadığınızı doğrulamanıza yardımcı olabilir.

• Sürekli ve tekrarlanan istekler ile daha uzun çözüm sürelerinden yararlanan karmaşık istekler için engellenmeyen uç noktaları kullanın.
• Küçük istekler ve sonuçların hızlı bir şekilde sunulması için engelleme uç noktalarını kullanın. Bu durumda kaliteden ödün vermeyi kabul etmiş olursunuz.
• Günlük iş akışınızda, özellikle de üretim uygulamaları için gRPC'yi kullanın.
• Test, deneme veya tek seferlik istekler için REST'i kullanın.

Bu dokümanın hangi bölümlerinin kurulumunuzla en alakalı olduğunu belirlemenize yardımcı olabilecek bir diyagramı görmek için aşağıdaki düğmeyi tıklayın.

Diyagramı ayrı sekmede açopen_in_new

timeout parametresini ayarlama

Sunucunun bir yanıt döndürmeden önce istek üzerinde çalışacağı maksimum süreyi belirtmek için istek gövdesindeki timeout parametresinin değerini ayarlayın. API, maksimum ayrılan süreye ulaşmadan önce optimum bir çözüm bulursa harcanan gerçek süre, ayrılan süreden daha kısa olabilir.

Süre protokol arabelleğini kullanarak timeout parametresini ayarlayın. Bu, 1 saniye ile 1.800 saniye arasında değişebilen saniye cinsinden bir süredir. allowLargeDeadlineDespiteInterruptionRisk kullanarak bu değeri 3.600 saniyeye kadar artırın.

Önerilen timeout değerleri

Aşağıdaki tabloda, istek karmaşıklığına, gönderi ve araç sayısına göre önerilen timeout değerleri listelenmiştir.

Teslim tarihini belirleme

Route Optimization API'nin bir isteği işlemek için harcayacağı maksimum süreyi tanımlamak üzere istek başlığında son tarihi ayarlayın. Aşağıdaki alt bölümlerde, REST ve gRPC istekleri için son tarihlerin nasıl ayarlanacağı açıklanmaktadır.

REST istekleri

Engelleme uç noktasını çağırmak için REST kullanırken son tarihi varsayılan 60 saniyenin ötesine uzatabilirsiniz. Bu süre genellikle karmaşık istekler için çok kısadır. İstek gövdesinde daha uzun bir son tarih belirtmiş olsanız bile bunu yapmanız gerekir. Bunun nedeni, varsayılan son tarihin, istek gövdesinde ayarlanan ve 60 saniyeden uzun olan tüm timeout değerlerini geçersiz kılmasıdır.

X-Server-Timeout istek başlığını ayarlayarak son tarihi varsayılan 60 saniyenin ötesine uzatın. İstek gövdesinden farklı olarak, başlığın değeri saniye cinsinden bir sayıdır ancak "s" son eki yoktur. Bu başlık için ayarlayabileceğiniz maksimum değer, timeout parametresinin kısıtlamalarıyla uyumludur.

Aşağıdaki kod örneğinde, X-Server-Timeout değerinin 1.800 saniye olarak ayarlandığı bir HTTP üstbilgisi gösterilmektedir.

curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/:optimizeTours' \
-H "Content-Type: application/json" \
-H "X-Server-Timeout: 1800" \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
--data @- << EOM
{
  "model": {
    ...
  }
}
EOM

İstemci kitaplıkları ve gRPC istekleri

İstemci kitaplıklarını veya gRPC'yi kullanırken son tarih yapılandırmanız gerekmez. Bu API'yi kullanırken varsayılan son tarih, bu API için maksimum istek süresi olan 3.600 saniyedir. İstek gövdesinde yalnızca zaman aşımı özelliğini ayarlayarak çözüm süresini yapılandırın.

Zaman aşımlarını ve son tarihleri etkileyen parametreler

Aşağıdaki parametreler hem zaman aşımlarının hem de son tarihlerin işleyişini etkiler:

• Maksimum istek son tarihini allowLargeDeadlineDespiteInterruptionRisk ile kontrol edin.
• searchMode ile çözüm kalitesini gecikmeye karşı dengeleyerek aramanın davranışını tanımlayın.

allowLargeDeadlineDespiteInterruptionRisk

allowLargeDeadlineDespiteInterruptionRisk parametresi, maksimum istek son tarihini 3.600 saniyeye çıkarır. Bu parametre ayarlanmazsa hem zaman aşımı hem de son tarih parametreleri için maksimum değer 1.800 saniyedir.

Zaman aşımı ve son tarih parametrelerinin değerini 3.600 saniyeye kadar artırmak için allowLargeDeadline DespiteInterruptionRisk değerini true olarak ayarlayın.

allowLargeDeadline DespiteInterruptionRisk için izin verilen değerler şunlardır:

• true: Kesinti riskini kabul ederek zaman aşımı ve son tarih parametrelerinin maksimum değerini 3.600 saniyeye çıkarır.
• false (varsayılan): Zaman aşımı ve son tarih parametreleri için maksimum 1.800 saniye değerini korur.

3.600 saniyeden daha uzun bir zaman aşımı süresine ihtiyacınız olduğunu düşünüyorsanız Google temsilcinizle iletişime geçin.

searchMode

searchMode parametresi, optimize edicinin çözümleri nasıl arayacağını kontrol ederek daha hızlı bir yanıt (daha düşük gecikme) veya daha yüksek kaliteli bir çözüme öncelik vermenizi sağlar.

Daha yüksek çözüm kalitesine öncelik verdiğinizde optimize edici, yüksek kaliteli bir çözüm bulmak için makul bir süre harcar. Bu daha uzun istekler için daha uzun bir zaman aşımı süresi ayarlamayı ve bağlantı sorunlarını önlemek için engellemeyen uç noktalar kullanmayı düşünebilirsiniz.

searchMode için izin verilen değerler şunlardır:

• SEARCH_MODE_UNSPECIFIED (varsayılan): Belirtilmemiş bir arama modu, RETURN_FAST ile eşdeğerdir.
• RETURN_FAST: İlk iyi çözümü bulduktan sonra aramayı durdurur.
• CONSUME_ALL_AVAILABLE_TIME: Daha iyi çözümler bulmak için mevcut tüm zamanını harcar. API, optimum çözümü erken bulursa mevcut sürenin tamamını kullanmaz.

Keepalive ping'lerini etkinleştir

Zaman aşımı süresi 60 saniyeden uzun olan engelleme uç noktalarına istek gönderdiğinizde, bağlantıda kalma ping'leri yanıt beklerken bağlantı kaybını önlemeye yardımcı olur. Keepalive ping'leri, bağlantı etkinliğini sürdürmek ve bağlantı kaybını tespit edip önlemek için gönderilen küçük paketlerdir.

Bu parametreleri, kullandığınız API protokolüne göre yapılandırın:

• REST: Keepalive'ı TCP bağlantı düzeyinde yapılandırın.
• gRPC: Temel TCP soketinde veya doğrudan gRPC protokolünde bağlantıyı etkin tutma ping'lerini yapılandırın.

Aşağıdaki bölümlerde, her iki protokol için de keepalive ping'lerinin nasıl ayarlanacağı açıklanmaktadır.

REST keepalive

REST kullanırken keepalive ping'lerini yapılandırmak, HTTP istemci kitaplığınıza bağlıdır. curl gibi istemci kitaplıkları ve araçları, belirli yapılandırma seçenekleri sunabilir veya ping'leri otomatik olarak etkinleştirebilir.

Kitaplığınız temel TCP soketini gösteriyorsa SO_KEEPALIVE gibi seçenekleri kullanarak bağlantıyı canlı tutma ping'lerini doğrudan TCP soketinde yapılandırabilirsiniz. Bunu yapmak için setsockopt() gibi işlevleri veya bunların eşdeğerlerini kullanın.

GitHub'da barındırılan bu işlev, Python'un yerleşik HTTP istemcisi için bu ayarın nasıl doğru şekilde yapılacağını gösterir.

TCP düzeyinde keepalive hakkında daha fazla bilgiyi TLDP keepalive genel bakış sayfasında veya HTTP istemci kitaplığı belgelerinizde bulabilirsiniz.

gRPC keepalive

gRPC, protokolün bir parçası olarak kendi yerleşik bağlantı sürdürme mekanizmasını sunar. Bunu istemci dilinizde nasıl ayarlayacağınızla ilgili talimatlar için gRPC keepalive kılavuzuna bakın.

Etkin tutma özellikli gRPC örnek isteği

Aşağıdaki örnekte, Python istemci kitaplığı ve gRPC düzeyinde bağlantıda kalma ping'leri kullanılarak nasıl optimizeTours isteği gönderileceği gösterilmektedir.

from google.maps import routeoptimization_v1 as ro
from google.maps.routeoptimization_v1.services.route_optimization.transports import grpc as grpc_transport
import sys

_REQUEST_TIMEOUT_SECONDS = 1800
_KEEPALIVE_PING_SECONDS = 30

def create_channel(*args, **kwargs):
  raw_options = kwargs.pop("options", ())
  options = dict(raw_options)
  options["grpc.keepalive_time_ms"] = _KEEPALIVE_PING_SECONDS * 1000
  options["grpc.keepalive_timeout_ms"] = 5000
  # Allow any number of pings between the request and the response.
  options["grpc.http2.max_pings_without_data"] = 0
  print(f"Using options: {options}", file=sys.stderr)
  return grpc_transport.RouteOptimizationGrpcTransport.create_channel(
      *args,
      options=list(options.items()),
      **kwargs,
  )

def create_grpc_transport(*args, **kwargs):
  if "channel" in kwargs:
    raise ValueError(
        "`channel` is overridden by this function, and must not be provided."
    )
  return grpc_transport.RouteOptimizationGrpcTransport(
      *args,
      channel=create_channel,
      **kwargs,
  )

def run_optimize_tours(request):
  client = ro.RouteOptimizationClient(transport=create_grpc_transport)
  return client.optimize_tours(request, timeout=_REQUEST_TIMEOUT_SECONDS)