البنية والمكونات

يتضمن تنفيذ Trip and Order Progress العمل مع العديد من مكوّنات حلول رحلات التسليم والتسليم عند الطلب مثل Fleet Engine وحزمة SDK الخاصة بالمستهلك وDriver SDK:

  • Fleet Engine هي خدمة خلفية مخصصة لحلول الرحلات والتسليمات عند الطلب. وهي مسئولة عن إدارة الرحلات وحالة المركبة. وهي تتعامل مع المعاملات بين Driver SDK وحزمة SDK للمستهلك وخدمة الخلفية التي يمكنها التواصل مع Fleet Engine من خلال إجراء استدعاءات REST أو gRPC.

  • حزمة SDK للمستهلك هي مكتبة عملاء تدمجها في تطبيقك الاستهلاكي. وهي مسؤولة عن تقديم تجربة مشاركة الرحلة، والتي تتضمن تتبُّع مسار السائق والمسافة المتبقية والوقت المقدَّر للوصول. يمكن أن تكون حزمة SDK الخاصة بالمستهلكين متوافقة مع الأجهزة الجوّالة (Android أو iOS) أو للويب (Javascript).

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

يوضح الرسم التخطيطي للبنية التالية العلاقة بين هذه المكونات:

هندسة معمارية

الرحلات والمركبات ونقاط الطرق

يتضمن إنشاء تطبيق تقدم الرحلة والطلب العمل في الرحلات والمركبات ونقاط الطريق.

الرحلات

الرحلة تمثل الرحلة -- الرحلة التي تنقل المستهلك (أو الوجبة التي طلبها) من موقع الاستلام إلى موقع التسليم، بما في ذلك نقاط الطريق المتوسطة على طول الطريق.

يتضمّن عنصر Trip بشكل آلي الموقع الجغرافي لاستلام الطلب والوجهة والموقع الجغرافي الحالي للمركبة ومسار الرحلة ونقاط الطريق الوسيطة ونوع الرحلة (سواء حصريًا أو مشترك).

مركبات

تشير المركبة إلى مركبة ضمن أسطولك. بشكل آلي، يتضمّن عنصر Vehicle الموقع الجغرافي للمركبة، وقائمة بالرحلات الحالية، وقائمة بنقاط الطريق الحالية.

نقاط الطريق

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

تحتوي كل من الرحلات والمركبات على نقاط طريق:

  • تحتوي مجموعة نقاط الطريق الخاصة بالرحلة على جميع نقاط الطرق ذات الصلة بالرحلة. وقد يتضمّن نقاط مسار للرحلات الأخرى في حال مشاركة الرحلة مع رحلات أخرى.

  • تحتوي مجموعة نقاط الطريق للمركبة على جميع نقاط الطريق المتبقية للمركبة، بما في ذلك نقاط الطريق لرحلات متعددة.

نموذج التدفق

ويعرِض المخطّط التالي المسار النموذجي للرحلة ومستوى تقدّم الطلب. ولمزيد من المعلومات، اطّلِع على إنشاء رحلة وجهة واحدة وعرضها.

الرسم التخطيطي للتسلسل

تصف الخطوات التالية كيفية إعداد تدفق العينة:

  1. يمكنك إنشاء مركبة وتفعيل ميزة "مشاركة الموقع الجغرافي" ثم ضبط حالة المركبة على متصل بالإنترنت. أنت تنشئ مركبات من خلال Fleet Engine. يمكنك ضبط حالة المركبة على متصل بالشبكة إما من خلال Fleet Engine أو من خلال Driver SDK.

  2. اختَر مطابقة عميل مع مركبتك. يمكنك استخدام طريقة SearchVehicles() للعثور على قائمة بالمركبات المحتمَلة من أسطولك.

  3. يمكنك إنشاء رحلة في Fleet Engine، وتعيين المركبة إلى تلك الرحلة، وربط هذه الرحلة بتطبيق المستهلكين، ومنح السائق مواقع الاستلام والتسليم.

  4. تعدِّل حزمة Driver SDK تلقائيًا الوقت المقدّر للوصول والمسافة والمسار أثناء الرحلة. أنت مسؤول عن تعديل حالة الرحلة.

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