المهام المجدوَلة

يصف هذا المستند خدمة المهام المجدولة في Fleet Engine. يفترض أن أنك قرأت مقالة ما المقصود بـ Fleet Engine؟ وتطّلع على معلومات حول Fleet Engine إمكانية خدمة المحرّك التي تحتاجها.

أثناء قراءة هذه الوثائق، ضع في اعتبارك ما يلي:

  • يمكنك إنشاء المهام وربطها بمحطة توقف كوسيلة نمذجة الارتباط الواقعي بين المهمة والمكان الذي من المتوقع أن تتوقف المركبة حتى يتمكن السائق من إكمال المهمة. اطّلِع على مقالة مقدّمة عن المركبات لمعرفة معلومات أكثر حولها. لفهم كيفية عمل المركبات في Fleet Engine.
  • يستخدم Fleet Engine للمهام المُجدوَلة الموارد التالية: Task وDeliveryVehicle. يوفر Fleet Engine خدمة gRPC وREST. الواجهات:
    • Task: gRPC وREST
    • DeliveryVehicle: gRPC وREST
    • ولتبسيط الأمر، يستخدم هذا الدليل أمثلة على gRPC.

ما هي المهمة المُجدوَلة؟

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

  • لتوصيل سلعة إلى مكان الإقامة
  • استلام حزمة لإرجاعها إلى مستودع الشحن
  • التوقف في موقع جغرافي لتقديم خدمة في الموقع للعميل
  • للتوقّف بشكل مجدول عن تعبئة وقود المركبة

عناصر المهمة

توضح الصورة التالية عناصر المهام هذه بتنسيق قياسي رحلة لمركبة.

حقول المهام الأساسية

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

نموذج بيانات للمهام

توضّح المخطّطات التالية نموذج البيانات لمورد "Task" بجانب المخطّط البياني لمورد DeliveryVehicle المرتبط به. يمكنك ومراجعة كلا الرسمين البيانيين لاستكشاف العلاقات بين المصدرين، مع وضع ما يلي في الاعتبار:

  • الموقع الجغرافي المخطَّط: تم تحديد كل من محطات توقّف المركبة والمهام لمواقع جغرافية محدّدة مميزة عن بعضها البعض.
    • بالنسبة إلى المهام، يشير الموقع الجغرافي المُخطَّط له إلى مكان إجراء السائق حدوث ذلك. على سبيل المثال، يتم تسليم 15 حزمة إلى منزل كبير معقدة تتطلب التسليم إلى مواقع لغرف البريد المختلفة داخل نفس التعقيد.
    • بالنسبة إلى محطات المركبات، يشير الموقع الجغرافي المُخطَّط له إلى محطة المركبة أثناء إنجاز السائق المهام. على سبيل المثال، تتوقف مركبة عند مدخل مجمع سكني، ويتوقف ويقوم بتسليم الحزم يدويًا لفصل غرف البريد داخل المجمع.
  • الولاية: لكل من المهام ومحطات التوقف للمركبات حقل حالة يختلف عن بعضنا البعض.
    • تعكس حالة توقف المركبة التقدم المحرز للمركبة في المتعلقة بالمحطة، تُستخدم لأغراض تتبع الأساطيل.
    • تشير حالة المهمة إلى ما إذا كانت المهمة نشطة أم لا. هذا النمط تؤثر على العمليات الأخرى المطلوب إجراؤها على المهام، مثل تحديد النهائية أو تعيينها لمركبة.

  • محصلة المهمة: محصلة المهمة هي حقل مهم في نموذج البيانات، لأنها تُستخدم للإشارة إلى نجاح أو فشل مهمة ما، لحالة المهمة.

  • المعرّفات:

    • عند تعيين مهمة لمركبة، يملأ محرك الأسطول الحقل "deliveryVehicleId". يشير هذا الحقل للقراءة فقط إلى أن المركبة الذي تم إسناد المهمة إليه.
    • معرّفات المهام هي معرّفات فريدة في جميع المهام في نظامك.
    • تحدد معرّفات التتبع مهمة لغرض تتبع الشحنة.

نموذج بيانات المهام

نموذج بيانات المركبة

معرّفات المهام

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

تتكون هذه السلسلة بعد ذلك من اسم مورد المهمة نفسه، حقل إخراج فقط على الكائن Task. يشبه ذلك قدرة Fleet Engine على تنشئ موارد أسماء المركبات. يُرجى الاطّلاع على قسم تسمية الموارد في مقدّمة عن Fleet Engine

متطلبات معرّف المهمة
الموقع الوصف
التميّز يجب أن يكون كل معرّف مهمة فريدًا في تنفيذ Fleet Engine لتجنُّب حدوث أي التباس وضمان تحديد الهوية بشكل مناسب.
التنسيق
  • عدم توفّر معلومات تحديد الهوية الشخصية أو بيانات نصية واضحة
  • سلاسل Unicode صالحة
  • 64 حرفًا كحدّ أقصى
  • استبعد الأحرف التالية: / : \ ? #
  • تمت تسويتها وفقًا نموذج تسوية يونيكود.
أمثلة على معرّفات المهام
أمثلة على معرّفات المهام الجيدة
  • 566c33d9-2a31-4b6a-9cd4-80ba1a0c643b
  • e4708eabcfa39bf2767c9546c9273f747b4626e8cc44e9630d50f6d129013d38
  • NTA1YTliYWNkYmViMTI0ZmMzMWFmOWY2NzNkM2Jk
معرّفات المهام غير المسموح بها
  • 8/31/2019-20:48-46.70746,-130.10807,-85.17909,61.33680
  • JohnDoe-577b484da26f-Cupertino-SantaCruz
  • 4R0oXLToF"112 Summer Dr. East Hartford, CT06118"577b484da26f8a

أنواع المهام

يدعم Fleet Engine أنواعًا مختلفة من المهام لتمثيل إجراءات مختلفة داخل وعمليات النقل. يتم توضيح هذه الإجراءات هنا بالإضافة إلى مستوى رؤيتها وتفاصيل الفوترة.

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

دورة حياة المهام والرحلة

يوفّر هذا القسم تفاصيل حول دورة حياة مهمة التسليم في Fleet. المحرك. ترتبط دورة حياة المهمة برحلة المركبة لأن أن تنتقل المركبة إلى محطة توقف ليتمكن السائق من إنجاز مهمة ما في الموقع المخطط له.

1. إنشاء المهام

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

خصائص المهام
الموقع الوصف
الحالة ضبط على OPEN
أرقام التعريف تحديد المهمة ورقم تعريف التتبُّع إذا كنت تستخدم ميزة تتبُّع الشحن للمستهلكين.
التوقيت المدة المخططة للمهمة وفترة الوقت المستهدفة. عرض توقيت المَهمّة لمعرفة التفاصيل.
الموقع الجغرافي المخطط تعيين الإحداثي الجغرافي الدقيق حيث يجب أن تكون المهمة مكتملة.

2. إسناد المهمّة

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

3- قيد التقدم

وتكون حالة المهمة إما "مفتوحة" أو "مغلقة". ومع ذلك، بمجرد تعيين مهمة إلى المركبة، يمكنك تتبع تقدمها من خلال ارتباطها بالمركبة ومكان وجود المركبة بالنسبة للمحطة حيث تكون المهمة مكتملة.

عقب انطلاق المركبة من محطة أو بدء التنقل، تظهر حالة من المفترض أن تتغير المحطة إلى ENROUTE. بهذه الطريقة، يمكن لتتبع شحنة المستهلك تحديث المستلم لمهمة ما بعدد مرات التوقف المتبقية والمقدر وقت الوصول. يدعم هذا أيضًا أي تصور في الوقت الفعلي للمستهلكين لتتبع الشحنة أو لتتبع الأسطول.

4. الوصول ونتائج المهمة

عندما تصل المركبة إلى محطة ما، يجب تعيين حالة المحطة على ARRIVED وكما هي الحال في حالة التوقّف: ENROUTE، لن يؤثّر ذلك في حالة المهمة نفسها، ولكنه يتوافق مع كل من إشعارات المستهلك وأي إشعارات فورية إعداد تقارير عن تتبُّع الأسطول الذي يستخدمه مشغّلو الأسطول. كما أنها تقوم بتمكينها لاحقًا والتحليلات وإعداد التقارير عن عمليتك التي ستستخدمها لتقديم التحسينات.

بعد وصول المركبة إلى المحطة، يمكن لنظامك معالجة بقية المهمة باستخدام أحد الأساليب التالية:

  • أغلِق المهام عند اكتمالها.

    عندما يضع السائق علامة على المهمة باعتبارها مكتملة، يمكن للنظام إزالتها من ولكن اترك المحطة مع مهام أخرى تم تعيينها إليها.

  • أزِل المحطة من المركبة بالكامل.

    عندما يكمل السائق جميع المهام وتصبح المركبة في طريقها إلى المحطة التالية، يمكنك إزالة المحطة بالكامل من المركبة. محرّك أسطول يغلق تلقائيًا جميع المهام المرتبطة بإيقاف تمت إزالته.

لا يشير إغلاق المهمة إلى النجاح أو الفشل

يشير إغلاق المهمة فقط إلى أن المهمة لم تعد قيد التقدم. بالنسبة إلى المهام في الحالة CLOSED، يمكنك ضبط نتيجتها على SUCCEEDED أو FAILED ويكون هذا ضروريًا للإشارة إلى النتيجة الفعلية للشحن للتتبع والفواتير المناسبة. تحصّل Fleet Engine مهام التسليم فقط من خلال حالة SUCCEEDED.

بمجرد تعيين نتيجة المهمة، لا يمكنك تغييرها

عند وضع علامة على نتيجة مهمة، يملأ Fleet Engine المهمة تلقائيًا وموقع نتائج البحث مع آخر موقع معروف للمركبة. ومع ذلك، يمكنك تعديل وقت نتيجة المهمة وموقع نتيجة المهمة بعد تحديدها لن يلغي Fleet Engine هذه الحقول.

5- سيناريوهات المهام الأخرى

لا تتناسب كل المهام التي تصممها في Fleet Engine مع مسار الرحلة النموذجي. بالنسبة مثال:

  • مهام الاستلام: عندما يكون لديك مهمة استلام الطلب لإعادة طرد إلى المستودع لمعالجته لاحقًا، عليك إنشاء نموذج delivery لهذه الحزمة، مع ضبط الموقع المخطط له على المستودع. بخلاف ذلك، تتبع مهام الاستلام عادةً نفس التدفق لمهام التسليم.
  • إعادة إسناد المهمّة: لا يمكنك إعادة تعيين مهمة مباشرةً إلى مهمة أخرى المركبة. بدلاً من ذلك، لنقل مهمة من مركبة إلى أخرى، أغلق الأصلية ثم إعادة إنشائها قبل تخصيص المركبة الجديدة لها. في حال حذف يمكنك تحديث ترتيب المهمة لمهمة تم تعيينها بالفعل مركبة مختلفة، ينتج عن Fleet Engine خطأ.
  • حذف المهام. كما هو الحال مع المركبات، يحذف Fleet Engine المهام التي لم تم تحديثها بعد سبعة أيام. إذا حاولت إعادة استخدام معرف مهمة لأحد التطبيقات التي تم إغلاقها سابقًا، يعرض Fleet Engine رسالة خطأ إذا تم استخدام هذا المعرّف خلال الأيام السبعة الماضية وعلى العكس، إذا كنت تريد الاحتفاظ ببيانات المهمة لفترة أطول لمدة تزيد عن سبعة أيام، يجب تنفيذ هذه الإمكانية بنفسك، من خلال لمهمة مجدولة لإعادة تعيين الساعة البالغة 7 أيام.

مشاركة رحلة المهام

من خلال مشاركة رحلة المهام في Fleet Engine، يمكنك مراقبة تقدم المهام في في الوقت الفعلي ومشاركة رحلة السائق بطريقتَين رئيسيتَين:

  • مشاركة رحلة المستهلك مع المستهلكين لمعرفة حالة طلبات الشحن أو طلب الخدمة المطلوب.
  • تتبُّع عدد الأسطول من أجل تتبُّع حالة الأسطول وتحليلها من المركبات في الأسطول.

مشاركة رحلة المستهلك

لدمج مشاركة رحلة المستهلك في عملياتك، يجب إعداد رحلتك باستخدام "حزمة SDK الخاصة بمستخدمي JavaScript" وباستخدام SDK، يمكنك تحسين تجربة مرئية للويب أو تطبيق الهاتف المحمول حتى يتمكن المستهلكون من مراقبة حالة الشحن إلى جانب الأوقات المقدرة للوصول وتحديثات الموقع في الوقت الفعلي لمركبة التسليم. اطّلِع على نظرة عامة حول مشاركة رحلة المستهلك للموقع الإلكتروني المهام المُجدوَلة.

تحتوي حزمة تطوير البرامج (SDK) لمشاركة رحلة المستهلك على خريطة JavaScript ومكوّنات بيانات. والمكونات للاتصال بـ Fleet Engine. الخريطة هي بديل مكان كائن google.maps.Map عادي. يجب أن يصادق العميل على بطاقتك المستخدمين واستخدام دور المستهلك التسليم من مشروعك على Google Cloud إلى إرجاع المعلومات الخاصة بالعميل فقط. فلاتر Fleet Engine وإخفاء كل العناصر والمعلومات الأخرى في الردود. على سبيل المثال، أثناء مَهمّة عدم التوفّر، عدم مشاركة أي معلومات عن الموقع الجغرافي مع المستخدم النهائي

في Fleet Engine، يمكنك تفعيل الإعدادات التالية لرحلة المستهلك المشاركة:

  • تستخدم "مهام Google" السمة TaskTrackingViewConfig. اختياريّ.
  • تستخدم المهام رقم تعريف تتبع، والذي تحتاجه المكتبة لتحديده ذا الصلة المهام للمستهلك.

تتبُّع عدد الطائرات

تتيح لك مكتبة JavaScript Fleet Tracking Library عرض مواقع المركبات في أساطيلهم في الوقت الفعلي تقريبًا. تستخدم المكتبة Fleet Engine API لتقديم تمثيل مرئي لمركبات التسليم، بالإضافة إلى بشأن المهام المسندة إليهم. وكما هي الحال في حزمة تطوير البرامج (SDK) الخاصة بمستخدمي JavaScript، فهي تحتوي على JavaScript مكوّن الخريطة الذي يشكّل بديلًا نهائيًا لـ google.maps.Map عادي بمكونات البيانات التي تستخدمها للاتصال بـ Fleet Engine.

تعرض هذه المكتبة إمكانية الاطّلاع على مركبات التسليم فور الوصول إليها. الذي تم إنشاؤه في Fleet Engine. لتنفيذ هذا الإجراء، يمكنك استخدام Fleet Engine. دور خدمة المستخدم المتميِّز في Cloud IAM، وتقديم مطالبة بالرمز المميّز للويب Java والوصول إلى مركبات التسليم والمهام المرتبطة بها.

سيناريوهات المهام المُجدوَلة

يعرض هذا القسم مجموعة متنوعة من سيناريوهات المهام التي تلخص المعلومات المقدمة في هذه المرحلة من الدليل. والغرض منها هو مساعدتك على فهم طرق متنوعة يمكنك من خلالها تصميم عمليات النقل في Fleet Engine، اعتمادًا على نشاطك التجاري.

التسليم مع إمكانية التتبع

يعرض سيناريو التسليم هذا مهمة إيقاف مجدول إلى المستودع عند المغادرة من المستودع في بداية الرحلة والوصول إلى المستودع في نهاية الرحلة. وكذلك تعرض مهمتي تسليم للتوقف، إحداهما فشلت. استخدام هذه المسودة المهمة لتمكين التتبع من وإلى المستودع كطريقة لنمذجة أوقات البدء والتوقف لليوم. بلا فوترة يحدث مع مهام الإيقاف المجدولة.

الاستلام مع التسليم من المستودع

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

مركبة نقل عبوة

يوضح هذا السيناريو عمليتي تسليم مع محطة توقف مجدولة في المنتصف لمركبة تغذية، حيث يكون الغرض هو تمكين مركبة التوصيل وإرجاعه إلى المستودع مع عدد من الحزم التي سيتم شحنها. إِنْتَ يمكننا أيضًا تصميم نموذج لمركبة تقديم التغذية بمحطة توقف مجدولة.

توقيت المهمة

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

مدة المهمة

يتم ضبط مدة المهمة باستخدام الحقل task_duration، وهو حقل مطلوب تضع نماذج للوقت المتوقع الذي يقضيه السائق في إكمال المهام في محطة أو أخذ استراحة. بالنسبة إلى محطات التوقف، يشمل ذلك جميع الأنشطة اللازمة بعد الوصول إلى المحطة، مثل تفريغ الحزم والتفاعل مع المستلم. وكلما كانت هذه المعلومات أكثر تحديدًا، استطاع Fleet Engine بشكل أفضل وتوفير أوقات وصول واقعية وأوقات وصول واقعية للمحطات اللاحقة في الرحلة. لمعرفة تفاصيل الحقول، يُرجى الاطّلاع على المدة في مستندات المخازن المؤقتة للبروتوكولات.

الفترة الزمنية المستهدفة

يحدد الوقت المستهدف نطاقًا زمنيًا مقترحًا لمهمة ما، يستخدم عادةً التواصل مع العملاء أو لأغراض التخطيط الداخلي. يمكنك ضبط هذا باستخدام الحقل target_time_window، والذي يتكون من وقت البدء ووقت الانتهاء. هذا لا يؤثر بشكل مباشر على أي حسابات للمسار، ولكن يمكن استخدامه مثل تنبيه المستهلك عن فترة زمنية للطرد التسليم، أو موعد وصول عامل خدمة مجدول.

سمات المهام

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

القيود والقيود

  • إنشاء سمات مخصصة: يحد Fleet Engine من عدد والسمات التي يمكنك تحديدها لكل مهمة. يُرجى التواصل مع ممثل المبيعات وطلب زيادة لهذه الحدود.
  • إمكانات الفلترة: مع توفير مرونة فلترة المهام، لا تحل محل حقول بيانات المهام الأساسية. يمكن استخدامها من أجل الإضافية استنادًا إلى احتياجاتك الخاصة.
  • يجب أن يكون لكل سمة مفتاح فريد.
  • لا تُدرج معلومات تحديد الهوية الشخصية أو معلومات حساسة أخرى. المعلومات في قيمة السمة، فيتم عرضها للمستخدم.
  • التحقّق من صحة البيانات: تأكّد من أنّ أنواع البيانات وتنسيقاتها المخصّصة مع متطلبات Fleet Engine.

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