تعرض Route Optimization API طريقتَين:
OptimizeTours
هي طريقة متزامنة تعرض مسارًا محسّنًا استجابةً لـOptimizeToursRequest
. يجب أن يحافظ العملاء على اتصال مفتوح بواجهة برمجة تطبيقات Route Optimization API حتى تتم معالجة الطلب وعرض خطأOptimizeToursResponse
أو خطأ.BatchOptimizeTours
هي طريقة غير متزامنة تقبل معرفات الموارد المنتظمة (URI) لرسالةOptimizeToursRequest
واحدة أو أكثر ورسائلOptimizeToursResponse
المقابلة، حيث تعرض اسم المورد لعملية طويلة الأمد (LRO) (REST، gRPC) يتم استخدامها للتحقق من اكتمال الدُفعة.OptimizeToursRequest
تتم معالجة المعرّفات في الخلفية حتى يحتفظ العملاء باتصالات مفتوحة بواجهة برمجة تطبيقات تحسين المسار لفترة طويلة بما يكفي لإرسال {1 LRO / الحالة" لطلبBatchOptimizeToursRequest
GetOperation
يقرأ "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
بعدة طرق، إمّا من سطر الأوامر أو باستخدام مكتبة برامج.