المقارنة بين OptimizeTours وBatchOptimizeTours

تعرض Route Optimization API طريقتَين:

  • OptimizeTours هي طريقة متزامنة تعرض مسارًا محسّنًا استجابةً للسمة OptimizeToursRequest. على العملاء الحفاظ على اتصال مفتوح بواجهة برمجة تطبيقات Route Optimization API حتى تتمّ معالجة الطلب ويتم عرض OptimizeToursResponse أو خطأ.
  • BatchOptimizeTours هي طريقة غير متزامنة تقبل معرّفات الموارد المنتظمة (URI) لرسالة OptimizeToursRequest واحدة أو أكثر ورسالة OptimizeToursResponse مقابلة، وتعرض اسم المورد لعملية طويلة التشغيل (LRO) (REST, gRPC) التي يتم استخدامها للتحقق من اكتمال المجموعة. تتم معالجة معرّفات الموارد المنتظمة (URI) في الخلفية، بحيث يحتفظ العملاء باتصالات مفتوحة بواجهة برمجة تطبيقات Route Optimization API لفترة كافية فقط لإرسال {1 BatchOptimizeToursRequest أو إلىOptimizeToursRequestGetOperation يقرأ BatchOptimizeTours الطلبات من Google Cloud Storage ويكتب الردود عليها.

حالات الاستخدام

إنّ "OptimizeTours" مناسب للتعامل مع الطلبات الصغيرة والبسيطة أو للطلبات التي لا تستغرق سوى بضع دقائق أو أقلّ. يؤدي الحفاظ على اتصالات طويلة الأمد بواجهة برمجة تطبيقات Route Optimization API إلى زيادة خطر انقطاع الخدمة قبل عرض الحلّ. راجِع انتهاء مهلة العمل للحصول على مزيد من التفاصيل.

بإمكان BatchOptimizeTours التعامل مع الطلبات الكبيرة والطلبات التي تستغرق وقتًا أطول للحلّ لأنّها لا تتطلّب اتصالاً طويل الأمد بواجهة برمجة تطبيقات Route Optimization API.

عمليات التشغيل لفترة طويلة

تتم قراءة هذه المهام من خلال Route Optimization API باستخدام طريقة GetOperation للتحقّق من حالة اكتمال دفعة. تتضمّن تقارير LRO خاصية done تشير إلى ما إذا كانت معالجة المجموعة بأكملها قد اكتملت وحقل error يبلِّغ عن الأخطاء التي حدثت أثناء المعالجة. إذا كانت قيمة done صحيحة ولا تتضمن error، تكون المجموعة قد اكتملت بنجاح. يشير توفُّر السمة error إلى تعذّر معالجة بعض الدفعة أو كلها.

في ما يلي دورة الحياة المعتادة لطلب BatchOptimizeTours:

  1. إرسال BatchOptimizeToursRequest إلى Route Optimization API، وعرض اسم مورد LRO.
  2. استطلاع الرأي GetOperation باستخدام اسم مورد LRO المعروض حتى تظهر السمتين done أو error في استجابة LRO.
  3. في حال ضبط السياسة done على "صحيح" وعدم ظهور أي خطأ، يُرجى الاطّلاع على OptimizeToursResponses من معرّفات الموارد المنتظمة (URI) لخدمة Google Cloud Storage المحدّدة في طلب BatchOptimizeTours. في حال توفُّر error، افحص الخطأ، وعدِّل OptimizeToursRequest وفقًا لذلك في Google Cloud Storage، ثم أعِد المحاولة حسب الاقتضاء بناءً على الخطأ الذي تم رصده.

يمكنك إرسال طلبات OptimizeTours وBatchOptimizeTours بطرق متعدّدة، إمّا من سطر الأوامر أو باستخدام مكتبة برامج.

التالي: إرسال طلب