للحصول على معلومات عامة حول طريقة عمل المركبات في Fleet Engine، راجِع الأدلة التالية في قسم "أساسيات Fleet Engine":
توضّح المستندات في هذا القسم كيفية إنشاء المركبات وإدارتها في Fleet Engine. يمكنك إنشاء مركبات في بيئة خادم Fleet Engine لمحاكاة المركبات الفعلية في عملية التشغيل في العالم الحقيقي. يجب أن تتطابق مركبات Fleet Engine مع المركبات المستخدَمة في نظام الخلفية الذي تستخدمه لتحديد المركبات وتوجيهها.
يمكنك استخدام طريقة إنشاء لإنشاء مورد مركبة، إما باستخدام gRPC أو REST. تستخدم أسماء الحقول في هذا الدليل ترميز gRPC لتبسيطها.
الرحلات عند الطلب
CreateVehicleRequest(gRPC)providers.vehicle.create(REST)Vehicleالمورد (REST، gRPC)
المهام المُجدوَلة
CreateDeliveryVehicleRequest(gRPC)providers.deliveryVehicles.create(REST)-
DeliveryVehicle(REST وgRPC)
طلبات المركبات
بالنسبة إلى إمكانات المهام عند الطلب والمهام المجدوَلة، يمكنك إنشاء مركبة وتعديلها من خلال إصدار رسالة طلب تتضمّن حقولاً، كما هو موضّح أدناه:
- العنصر الرئيسي: سلسلة مرتبطة برقم تعريف مشروعك على Google Cloud، تُستخدَم لملء حقل الاسم الخاص بمثيل المركبة.
معرّف المركبة: سلسلة فريدة تُستخدَم لتعبئة حقل
nameالخاص بالمركبة.مثيل مركبة مع الحقول المطلوبة تعتمد هذه الحقول على إمكانية Fleet Engine التي تستخدمها.
تختلف المعلومات الواردة في نص الطلب حسب طبيعة الطلب. يمكنك الاطّلاع على هذه التفاصيل في الأدلة الخاصة بها.
رموز المصادقة والتفويض
يجب أن تتضمّن الطلبات المُرسَلة إلى Fleet Engine أيضًا بيانات اعتماد الوصول الصحيحة. تستند الأمثلة الواردة في هذا الدليل إلى الافتراضات التالية:
- تفترض أمثلة gRPC استخدام مكتبة التفويض للغة Java.
- توضّح أمثلة REST عنوان طلب HTTP، والذي يجب أن يحتوي على الحقل
AuthorizationبالقيمةBearer <token>، حيث يمثّل<token>رمز JSON مميز للويب تصدره أنت.
لمزيد من التفاصيل، يُرجى الاطّلاع على أدلة إعداد Fleet Engine.
حقول مرجع المركبة
يتضمّن مورد المركبة أنواع الحقول التالية:
- الحقول التي تعرض النتائج فقط: الحقول التي تضبطها الخدمة كنتيجة لطريقة أخرى ولا يمكن ضبطها مباشرةً أحد الحقول المهمة لهذا النوع هو حقل
name. يتجاهل Fleet Engine أي قيمة يتم تقديمها للحقلnameالخاص بالمركبة وفقًا لإرشادات Google AIP بشأن معرّفات يحدّدها المستخدم. إذا قدّمت قيمًا لهذه الحقول، ستعرض Fleet Engine خطأً. - الحقول المطلوبة تتطلّب المركبات التي يتم إنشاؤها في خدمة الرحلات عند الطلب ضبط حقول معيّنة عند الإنشاء. لا تحتوي المركبات التي تم إنشاؤها في خدمة المهام المجدوَلة على أي حقول مطلوبة لمورد المركبة.
- الحقول الاختيارية: تحتوي كلتا الخدمتين على حقول يمكنك ضبطها عند الإنشاء أو بعد ذلك. ويمكن العثور عليها في دليل المرجع الخاص بالخدمة التي تستخدمها.
اسم المركبة (النتائج فقط)
الحقل name هو نفسه تمامًا للرحلات عند الطلب وخدمات المهام المجدوَلة. تحدّد Fleet Engine الحقل عند إنشاء المركبة، استنادًا إلى حقلَين تحدّدهما عند إنشاء المركبة:
الحساب الرئيسي: سلسلة مرتبطة بمعرّف مشروعك على Google Cloud Platform بالتنسيق
providers/{provider}حيث{provider}هو معرّف مشروعك على Cloud. سيكون لكل مركبة تنشئها لمشروع معيّن مسار رئيسي واحد.يجب أن يتضمّن مشروع Cloud الذي تشير إليه هنا أيضًا أدوار حساب خدمة Fleet Engine للخدمة التي تستخدمها. راجِع حسابات الخدمة للاطّلاع على قائمة بحسابات الخدمة هذه. لا تتيح Fleet Engine إمكانية الوصول من مشاريع متعددة على Google Cloud.
معرّف المركبة، ويجب أن يكون فريدًا بين جميع المركبات في أسطولك وأن يكون سلسلة Unicode صالحة. هذا هو معرّف المورد الخاص بالمركبة. يتم استخدام هذا المعرّف لربط رحلة عند الطلب أو محطة مجدولة بالمركبة التي تنفّذها.
في الخدمات المستندة إلى Google Cloud، يجب أن تمثّل جميع واجهات برمجة التطبيقات الموارد كسلاسل. لمزيد من التفاصيل، يُرجى الاطّلاع على تسمية الموارد في Fleet Engine.
معرّفات الكيانات الفريدة
إنّ تنسيق وقيمة معرّفات الكيانات الفريدة المستخدَمة في طلبات الموارد غير معروفة لخدمة Fleet Engine. تأكَّد من أنّ المعرّف لا يحتوي على أي معلومات تحدّد الهوية الشخصية، مثل رقم هاتف السائق.
إعادة استخدام المركبات
بعد أن تكمل المركبة جميع المحطات في مسار معيّن، تظل متاحة لإعادة الاستخدام في Fleet Engine لمدة 7 أيام، ما يعني أنّه يمكنك إعادة استخدام مركبة في أيام العمل اللاحقة بدون الحاجة إلى إنشاء مركبة جديدة. في كل مرة تعيد فيها استخدام مركبة، يعيد Fleet Engine ضبط مدى توفّرها، وعندها يبدأ العد التنازلي لمدة 7 أيام من جديد.
الطريقة المقترَحة لإبقاء المركبة متاحة في Fleet Engine هي تعديل موقعها الجغرافي على فترات منتظمة. سيؤدي تعديل معظم الحقول الأخرى في الكيان Vehicle إلى تمديد مدة صلاحيته أيضًا، شرط أن تكون قيمة الحقل الجديدة مختلفة عن القيمة الحالية.
ملاحظة: بعض الحقول في عنصر Vehicle، مثل device_settings، هي معلومات تصحيح الأخطاء فقط ولا تحتفظ بها Fleet Engine. ولا يؤدي تعديلها إلى تمديد مدة صلاحية العنصر Vehicle.
لتحسين إحصاءات النظام، من الأفضل إعادة استخدام عملية الربط نفسها بين معرّف السائق ومعرّف المركبة يوميًا. يمكنك إجراء ذلك باستخدام معرّف المركبة نفسه المرتبط بالسائق في المحطات المجدوَلة السابقة أو الرحلات عند الطلب.