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

للحصول على معلومات عامة عن طريقة عمل المركبات في Fleet Engine، اطّلِع على الأدلة التالية في قسم أساسيات Fleet Engine:

• ما هو Fleet Engine؟
• مقدّمة عن المركبات

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

يمكنك استخدام طريقة إنشاء لإنشاء مورد مركبة، إما باستخدام gRPC أو REST. تستخدم أسماء الحقول في هذا الدليل أسلوب gRPC للتبسيط.

الرحلات عند الطلب

• ‫CreateVehicleRequest (gRPC)
• providers.vehicle.create (REST)
• Vehicle resource (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 استخدام مكتبة Authorization لبرنامج 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. سيكون لكل مركبة تنشئها لمشروع معيّن المسار الرئيسي نفسه.

  يجب أن يتضمّن مشروع Cloud الذي تشير إليه هنا أيضًا أدوار حساب الخدمة لمحرك Fleet للخدمتَين اللتين تستخدمهما. راجِع حسابات الخدمة للحصول على قائمة بحسابات الخدمة هذه. لا تتيح أداة 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.

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

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

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