تعرض Route Optimization API طريقتَين:
OptimizeToursهي طريقة متزامنة تعرض مسارًا محسّنًا استجابةً لـOptimizeToursRequest. يجب أن يحافظ العملاء على اتصال مفتوح بواجهة برمجة تطبيقات Route Optimization API حتى تتم معالجة الطلب وعرض خطأOptimizeToursResponseأو خطأ.BatchOptimizeToursهي طريقة غير متزامنة تقبل معرفات الموارد المنتظمة (URI) لرسالةOptimizeToursRequestواحدة أو أكثر ورسائلOptimizeToursResponseالمقابلة، حيث تعرض اسم المورد لعملية طويلة الأمد (LRO) (REST، gRPC) يتم استخدامها للتحقق من اكتمال الدُفعة.OptimizeToursRequestتتم معالجة المعرّفات في الخلفية حتى يحتفظ العملاء باتصالات مفتوحة بواجهة برمجة تطبيقات تحسين المسار لفترة طويلة بما يكفي لإرسال {1 LRO / الحالة" لطلبBatchOptimizeToursRequestGetOperationيقرأ "BatchOptimizeTours" الطلبات من Google Cloud Storage ويكتب الردود عليها.
حالات الاستخدام
إنّ "OptimizeTours" مناسب لحل الطلبات الصغيرة والبسيطة، أو للطلبات التي لا تزيد مدتها عن بضع دقائق أو أقل. يؤدي الحفاظ على اتصالات طويلة الأمد
بواجهة برمجة تطبيقات Route Optimization API إلى زيادة خطر انقطاع الخدمة قبل
إرجاع الحلّ.
وبإمكان "BatchOptimizeTours" التعامل مع الطلبات والطلبات الأكبر حجمًا التي تستغرق وقتًا أطول للحلّ
لأنّها لا تتطلب اتصالاً طويل الأمد بواجهة Route
Optimization API.
عمليات طويلة المدى
تتم قراءة مركبات LRO من واجهة برمجة تطبيقات Route Optimization API باستخدام طريقة GetOperation
للتحقّق من حالة اكتمال الدفعة. تتضمّن الطلبات المتنقلة (LRO) السمة done التي تشير إلى ما إذا كانت معالجة الدفعة بأكملها قد اكتملت أم لا وحقل error
يبلغ عن الأخطاء التي حدثت أثناء المعالجة. إذا كانت القيمة done صحيحة ولم يتم
وجود error، يعني ذلك أنّ الدُفعة مكتملة بنجاح. يشير ظهور العلامة
error إلى تعذُّر معالجة جزء من الدفعة أو كلّها.
في ما يلي مراحل النشاط المعتادة لطلب BatchOptimizeTours:
- إرسال
BatchOptimizeToursRequestإلى Route Optimization API، التي تعرض اسم مورد LRO. - الاستطلاع
GetOperationمع اسم مورد LRO الذي تم عرضه إلى أن تظهر السمتانdoneأوerrorفي استجابة LRO. - إذا كانت القيمة
doneصحيحة ولم يظهر أي خطأ، يُرجى الاطّلاع علىOptimizeToursResponsesمن معرّفات الموارد المنتظمة (URI) لخدمة Google Cloud Storage المحدّدة في طلبBatchOptimizeTours. في حال ظهورerror، افحص الخطأ وعدِّل رموزOptimizeToursRequestوفقًا لذلك في Google Cloud Storage وأعِد المحاولة على النحو المناسب بناءً على الخطأ الذي تم رصده.
يمكنك إرسال طلبَي OptimizeTours وBatchOptimizeTours بعدة طرق، إمّا من سطر الأوامر أو باستخدام مكتبة برامج.