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