للحصول على معلومات عامة حول كيفية عمل المركبات في 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 المميّز للويب الذي تصدره
لمزيد من التفاصيل، يُرجى الاطّلاع على أدلة إعداد مجموعة الأجهزة.
حقول موارد المركبات
يضم مورد المركبات الأنواع التالية من الحقول:
- حقول النتائج فقط: الحقول التي تضبطها الخدمة باعتبارها ناتجًا لـ
طريقة أخرى ولا يمكن ضبطها مباشرةً. من الحقول المهمة في هذا
النوع هو الحقل
name. يتجاهل Fleet Engine أي قيمة مقدمة حقل واحد (name) للمركبة لكل إرشادات من Google AIP التي حدّدها المستخدم المعرّفات في حال توفير قيم لهذه الحقول، سيُنشئ Fleet Engine بإرجاع خطأ. - الحقول المطلوبة: تتطلّب المركبات التي يتم إنشاؤها في خدمة الرحلات عند الطلب أن يتم تعيين حقول معينة عند الإنشاء. المركبات التي تم إنشاؤها في الجدول الزمني المهام في الخدمة الخاصة بها لا تحتوي على حقول موارد المركبات المطلوبة.
- الحقول الاختيارية. تحتوي كلتا الخدمتَين على حقول يمكنك ضبطها عند الإنشاء. أو بعد ذلك. يمكنك العثور على هذه العناصر في الدليل المرجعي ذي الصلة الخدمة التي تستخدمها.
اسم المركبة (الناتج فقط)
يتطابق الحقل name تمامًا مع الرحلات عند الطلب والمهام المجدوَلة.
يحدد Fleet Engine الحقل عند إنشاء المركبة، بناءً على
حقلَين تضبطهما عند إنشاء المركبة:
المصدر: سلسلة مرتبطة برقم تعريف مشروعك على Google Cloud النموذج
providers/{provider}حيث يكون{provider}هو رقم تعريف السحابة الإلكترونية مشروعك. سيكون لكل مركبة تقوم بإنشائها لمشروع معين نفس المسار الأصلي.يجب أن يحتوي المشروع على Google 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.
لتحسين إحصاءات النظام، من الأفضل إعادة استخدام رقم تعريف مركبة السائق نفسه الاقتران من يوم لآخر. يمكنك إجراء ذلك باستخدام رقم تعريف المركبة نفسه المرتبط السائق لمحطات توقف مجدولة سابقة أو رحلات عند الطلب.