مقدمة: إنشاء المركبات

للحصول على معلومات عامة حول طريقة عمل المركبات في Fleet Engine، راجِع الأدلة التالية في قسم "أساسيات 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)

ملاحظة: تتشابه رسائل الطلبات وحقول الموارد لموردَي مركبات Fleet Engine إلى حد كبير، على الرغم من اختلاف بعض الأسماء بينهما.

طلبات المركبات

بالنسبة إلى إمكانات المهام عند الطلب والمهام المُجدوَلة، يمكنك إنشاء مركبة وتعديلها من خلال إصدار رسالة طلب تتضمّن حقولاً، كما هو موضّح أدناه:

1. العنصر الرئيسي: سلسلة مرتبطة برقم تعريف مشروعك على Google Cloud، تُستخدَم لملء حقل الاسم الخاص بنسخة المركبة.

2. معرّف المركبة: سلسلة فريدة تُستخدَم لتعبئة الحقل name الخاص بالمركبة.

   ملاحظة: تنطبق قيود معيّنة على سلاسل معرّفات المركبات. تجنَّب أرقام التعريف التي تزيد تلقائيًا وتأكَّد من أنّها لا تحتوي على أي معلومات تكشف الهوية الشخصية. للاطّلاع على تفاصيل حول القيود المفروضة على الأحرف، يُرجى الاطّلاع على حقل معرّف المركبة في CreateVehicleRequest أو CreateDeliveryVehicleRequest.

3. مثيل مركبة مع الحقول المطلوبة تعتمد هذه الحقول على إمكانية 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 بالتنسيق providers/{provider}، حيث {provider} هو رقم تعريف مشروعك على Cloud. سيكون لكل مركبة تنشئها لمشروع معيّن المسار الرئيسي نفسه.

  يجب أن يحتوي مشروع على السحابة الإلكترونية الذي تشير إليه هنا أيضًا على أدوار حساب خدمة Fleet Engine للخدمة التي تستخدمها. اطّلِع على حسابات الخدمة للاطّلاع على قائمة بحسابات الخدمة هذه. لا يتيح Fleet Engine الوصول من مشاريع Google Cloud متعددة.

• معرّف المركبة، ويجب أن يكون فريدًا بين جميع المركبات في أسطولك وأن يكون سلسلة Unicode صالحة. هذا هو معرّف المورد للمركبة. تستخدم كل من الرحلات عند الطلب والمحطات المجدوَلة هذه السمة لربط رحلة أو مهمة بالمركبة التي تنفّذها.

في الخدمات المستندة إلى Google Cloud، يجب أن تمثّل جميع واجهات برمجة التطبيقات الموارد كسلاسل. راجِع تسمية الموارد في Fleet Engine لمزيد من التفاصيل.

معرّفات الكيانات الفريدة

يكون تنسيق وقيمة معرّفات الكيانات الفريدة المستخدَمة في طلبات الموارد غير شفافة بالنسبة إلى Fleet Engine. تأكَّد من أنّ المعرّف لا يحتوي على أي معلومات تكشف الهوية الشخصية (PII)، مثل رقم هاتف السائق.

إعادة استخدام المركبات

بعد أن تكمل المركبة جميع محطات التوقف في برنامج رحلة معيّن، تظل متاحة لإعادة استخدامها في Fleet Engine لمدة 7 أيام، ما يعني أنّه يمكنك إعادة استخدام مركبة في أيام العمل اللاحقة بدون الحاجة إلى إنشاء مركبة جديدة. في كل مرة تعيد فيها استخدام مركبة، يعيد Fleet Engine ضبط مدى توفّرها، وعندها تبدأ فترة العد التنازلي لمدة 7 أيام من جديد.

الطريقة المقترَحة لإبقاء المركبة متاحة في Fleet Engine هي تعديل موقعها الجغرافي على فترات منتظمة. ستؤدي أيضًا التعديلات على معظم الحقول الأخرى في الكيان Vehicle إلى تمديد مدة صلاحيته، شرط أن تكون قيمة الحقل الجديد مختلفة عن القيمة الحالية.

ملاحظة: بعض الحقول في كيان Vehicle، مثل device_settings، هي معلومات تصحيح أخطاء فقط ولا يحتفظ بها محرّك Fleet Engine. ولا يؤدي تعديلها إلى تمديد مدة صلاحية الكيان "Vehicle".

لتحسين إحصاءات النظام، من الأفضل إعادة استخدام عملية الربط نفسها بين معرّف السائق ومعرّف المركبة يوميًا. يمكنك إجراء ذلك باستخدام معرّف المركبة نفسه المرتبط بالسائق في المحطات المجدوَلة السابقة أو الرحلات عند الطلب.

الخطوات التالية

• إنشاء مركبة للرحلات عند الطلب
• إنشاء أداة للمهام المجدوَلة