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