تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض 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 بعدة أنواع
إما من سطر الأوامر أو من خلال مكتبة البرامج.