يمكنك تخصيص تجربة المستهلك للرحلات عند الطلب من خلال السماح للمستهلكين بمتابعة الرحلة لطلب أو رحلة أو خدمة أخرى تقدّمها لهم.
ما هي حزمة Consumer SDK؟
حزمة Consumer SDK هي جزء من Fleet Engine للرحلات عند الطلب. توفّر هذه الحزمة واجهات تمثّل بيانات الرحلة وتتتبّع الرحلات في Fleet Engine، كما توفّر فئات يمكنك استخدامها لإنشاء عرض غني يستند إلى الخريطة لمشاركة الرحلات مع مستخدمي المستهلكين. يمكنك دمج حزمة Consumer SDK في تطبيقك وضبط ملفات الأدوار المناسبة ضِمن Fleet Engine لإنشاء تجربة المستهلك هذه.
تتيح لك واجهات برمجة التطبيقات الخاصة بالمنصة في حزمة Consumer SDK إنشاء إمكانية مشاركة الرحلات بشكلٍ أصلي في تطبيقاتك. تتوفّر حزمة Consumer SDK للمنصات التالية:
ما هي مزايا استخدام حزمة Consumer SDK؟
يتيح لك دمج حزمة Consumer SDK في تطبيقات الرحلات عند الطلب توفير تجربة شاملة للمستهلكين، مع تعديلات الموقع الجغرافي في الوقت الفعلي تقريبًا والمواضع التي تم ضبطها على الطريق. يمكن للمستهلكين الاطّلاع على مسار المركبة فوق الخريطة، بما في ذلك تفاصيل التقدّم التي تساعدهم في معرفة مكان رحلتهم أو عملية التسليم.
ما هي الإجراءات التي يمكن تنفيذها باستخدام حزمة Consumer SDK؟
يمكنك استخدام المعلومات من حزمة Driver SDK وFleet Engine لإنشاء تجارب مخصّصة للمستهلكين، بما في ذلك الميزات التالية:
تخصيص واجهة مستخدم الخريطة لتناسب احتياجات علامتك التجارية
تتبُّع الموقع الجغرافي الحالي للمركبة أثناء تحرّكها على طول المسار، مع تعديل موضعها بشكلٍ دوري
عرض الوقت المقدَّر للوصول إلى مواقع الاستلام والتسليم
عرض المسافة المتبقية
عرض حركة المرور المباشرة على المسار
آلية عمل حزمة Consumer SDK
تعتمد حزمة Consumer SDK بشكلٍ أساسي على الآليات التالية:
- الحصول على أدوار Fleet Engine المناسبة حتى يتمكّن تطبيق مصادَق عليه من تتبُّع الرحلة المرتبطة بطلب المستهلك
- ربط المستهلك بالرحلة، كما يوفّرها نظامك الخلفي
- فئتا حزمة SDK
TripModelوJourneySharingSessionاللتان تمثّلان بيانات الرحلة وتشاركان جلسات الرحلة في تطبيق المستهلك
توفّر حزمة Consumer SDK أيضًا واجهات وفئات أخرى حتى تتمكّن من إنشاء تجربة تطبيق غنية تتضمّن تفاصيل مثل حركة المرور وعلامات الخريطة والوقت المقدَّر للوصول وبيانات المسار.
يعرض هذا الجدول تدفق رحلة يتتبّعها تطبيق مستهلك.
| 1 | يطلب تطبيق المستهلك رحلة | يتلقّى الخادم الخلفي طلب رحلة عند الطلب وينفّذ ما يلي:
|
| 2 | يقبل السائق الرحلة | يحصل تطبيق السائق على رقم تعريف الرحلة ومعلوماتها، ويقبل السائق الرحلة. |
| 3 | يطلب تطبيق المستهلك الوصول لتتبُّع الرحلة | يحصل تطبيق المستهلك على رقم تعريف الرحلة من الخادم الخلفي و يطلب بدء تتبُّع الرحلة. |
| 4 | يبدأ السائق الرحلة | عندما يستخدم السائق تطبيق السائق للإشارة إلى بدء الرحلة، يُرسِل التطبيق إشعارًا إلى الخادم الخلفي من خلال حزمة Driver SDK. على سبيل المثال، عندما يكون السائق على وشك مغادرة المطعم أو القيادة إلى موقع الاستلام |
| 5 | يبدأ Fleet Engine في إرسال معلومات الرحلة | يبدأ Fleet Engine في تتبُّع الرحلة ومشاركة تقدّمها مع تطبيق المستهلك. |
| 6 | يعرض تطبيق المستهلك معلومات الرحلة | يُرسِل تطبيق المستهلك إشعارًا إلى المستهلك ويبدأ في عرض معلومات الرحلة له، مع تعديل الرحلة أثناء تقدّمها. |
| 7 | تم إلغاء الرحلة أو إكمالها | عندما يلغي السائق الرحلة أو يكملها، يوقف تطبيق السائق تتبُّع الموقع الجغرافي، ويطلب الخادم الخلفي من Fleet Engine وضع علامة على الرحلة على أنّها ملغاة أو مكتملة. |
| 8 | يتوقف تطبيق المستهلك عن تتبُّع الرحلة | تظهر الرحلة على أنّها ملغاة أو مكتملة. |
| 9 | يتم تكرار العملية للرحلة التالية | يتم إنشاء رحلة جديدة وتكرار العملية. |
كيفية استخدام حزمة Consumer SDK
اختَر منصتك للاطّلاع على كيفية بدء تتبُّع الرحلات في تطبيقات المستهلكين.
Android
| 1 | إعداد حزمة Consumer SDK في Android | لتتبُّع الرحلات عند الطلب في تطبيقك، عليك إعداد حزمة Consumer SDK. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الحصول على حزمة Android Consumer SDK. |
| 2 | إعداد الواجهة المرئية | يمكنك تحديد خريطة وإضافة دعم للخرائط المتجهة لإعداد تجربة المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد خريطة. |
| 3 | تتبُّع رحلة | يمكنك تتبُّع رحلة لمشاركة موقع المركبة المناسبة مع المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تتبُّع رحلة. |
| 5 | تعديل تقدّم الرحلة والتعامل مع أخطاء الرحلة | يمكنك تعديل تفاصيل رحلاتك، مثل مسافة السفر والوقت المقدَّر للوصول، والتعامل مع أي أخطاء تحدث أثناء الرحلة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي تعديل تقدّم الرحلة و التعامل مع أخطاء الرحلة. |
| 5 | عند اكتمال الرحلة، توقَّف عن تتبُّعها | يمكنك التوقّف عن تتبُّع رحلة لإيقاف مشاركة موقع المركبة مع المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التوقّف عن تتبُّع رحلة. |
iOS
| 1 | إعداد حزمة Consumer SDK في iOS | لتتبُّع الرحلات عند الطلب في تطبيقك، عليك إعداد حزمة Consumer SDK. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الحصول على حزمة iOS Consumer SDK. |
| 2 | إعداد الواجهة المرئية | يمكنك تهيئة طريقة عرض الخريطة والتعامل مع أحداث الخريطة لإعداد تجربة المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد خريطة. |
| 3 | تتبُّع رحلة | يمكنك تتبُّع رحلة لمشاركة موقع المركبة المناسبة مع المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تتبُّع رحلة. |
| 5 | تعديل تقدّم الرحلة والتعامل مع أخطاء الرحلة | يمكنك تعديل تفاصيل رحلاتك، مثل مسافة السفر والوقت المقدَّر للوصول، والتعامل مع أي أخطاء تحدث أثناء الرحلة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي تعديل تقدّم الرحلة و التعامل مع أخطاء الرحلة. |
| 5 | عند اكتمال الرحلة، توقَّف عن تتبُّعها | يمكنك التوقّف عن تتبُّع رحلة لإيقاف مشاركة موقع المركبة مع المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التوقّف عن تتبُّع رحلة. |
JavaScript
| 1 | إعداد حزمة Consumer SDK في JavaScript | لتتبُّع الرحلات عند الطلب في تطبيقك، عليك إعداد حزمة Consumer SDK. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد حزمة JavaScript Consumer SDK. |
| 2 | تحميل خريطة وتخصيصها | يمكنك تفعيل Maps JavaScript API وإعداد التفويض لإعداد تجربة المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد خريطة. |
| 3 | تتبُّع رحلة | يمكنك تتبُّع رحلة لمشاركة موقع المركبة المناسبة مع المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تتبُّع رحلة. |
| 5 | تعديل تقدّم الرحلة والتعامل مع أخطاء الرحلة | يمكنك تعديل تفاصيل رحلاتك، مثل مسافة السفر والوقت المقدَّر للوصول، والتعامل مع أي أخطاء تحدث أثناء الرحلة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي تعديل تقدّم الرحلة وتتبُّعه والتعامل مع أخطاء الرحلة . |
| 5 | عند اكتمال الرحلة، توقَّف عن تتبُّعها | يمكنك التوقّف عن تتبُّع رحلة لإيقاف مشاركة موقع المركبة مع المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التوقّف عن تتبُّع رحلة. |
المكونات
يلخّص هذا القسم مكوّنَين ضروريَين لتتبُّع رحلة:
يمكنك أيضًا تخصيص تجربة المستهلك باستخدام هذَين المكوّنَين:
أداة جلب الرمز المميّز للمصادقة
للتحكّم في الوصول إلى بيانات الموقع الجغرافي المخزّنة في Fleet Engine، عليك تنفيذ ما يلي:
تنفيذ خدمة إنشاء رمز JSON المميّز للويب (JWT) لـ Fleet Engine على خادمك لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إصدار رموز JWT.
تنفيذ أداة جلب الرمز المميّز للمصادقة في تطبيقات الويب أو الأجهزة الجوّالة لمصادقة الوصول إلى بيانات الموقع الجغرافي لمزيد من المعلومات عن إعداد أداة جلب الرمز المميّز، يُرجى الاطّلاع على دليل الإعداد لنظام التشغيل Android أو iOS أو JavaScript.
طريقة عرض الخريطة وأدوات تتبُّع الرحلات
يتضمّن تتبُّع الرحلة مكوّنات لعرض المركبات ونقاط المرور، بالإضافة إلى خلاصات البيانات الأولية للوقت المقدَّر لوصول السائق أو المسافة المتبقية للقيادة.
يوضّح الجدول التالي هذه المكوّنات:
| المكوّن | الوصف |
|---|---|
| طريقة عرض خريطة المستهلك | تُدير طريقة عرض الخريطة دورة حياة الرحلة، وتعرض نقاط المرور لموقع المركبات أثناء تقدّم الرحلة. إذا كان مسار المركبة معروفًا، تعدِّل طريقة عرض الخريطة الخط المتعدد لمسار المركبة للإشارة إلى تقدّم المركبة على طول مسارها. |
| مقدِّم موقع الرحلة في JavaScript | بالنسبة إلى تطبيقات الويب المستندة إلى JavaScript، يقدّم مقدِّم موقع الرحلة معلومات الموقع الجغرافي للكائنات التي يتم تتبُّعها إلى خريطة الرحلة المشترَكة. لمزيد من
المعلومات، يُرجى الاطّلاع على
مقالة إنشاء مثيل لمقدِّم موقع الرحلة.
يمكنك استخدام مقدِّم موقع الرحلة لتتبُّع التفاصيل التالية لرحلة:
|
كائنات الموقع الجغرافي التي يتم تتبُّعها
يتتبّع مقدِّم الموقع الجغرافي موقع الكائنات، مثل نقاط المرور والمركبات، كما هو موضّح في الجدول التالي.
| الموقع الجغرافي الذي يتم تتبُّعه | الوصف |
|---|---|
| مكان استلام السيارة | مكان استلام السيارة هو المكان الذي تبدأ منه الرحلة. |
| الموقع الجغرافي للوجهة | الموقع الجغرافي للوجهة هو المكان الذي تنتهي فيه الرحلة. ويشير إلى مكان تسليم الطلب. |
| موقع نقطة على المسار | موقع نقطة المرور هو أي موقع جغرافي وسيط على طول مسار رحلة يتم تتبُّعها. على الرغم من أنّ نقاط المرور يمكن أن تشمل من الناحية الفنية مواقع الاستلام والتسليم، فإنّ نقاط المرور تشير عادةً إلى المحطات الوسيطة على طول المسار. على سبيل المثال، المحطات بين مواقع الاستلام والوجهة على مسار التسليم هي مواقع نقاط المرور. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة نقاط مرور الرحلة في مستندات Fleet Engine. |
| موقع المركبة | موقع المركبة هو الموقع الجغرافي الذي تم الإبلاغ عنه لمركبة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة موقع المركبة في مستندات Fleet Engine. |
تصميم خرائطك
تحدّد أنماط العلامات والخطوط المتعددة مظهر كائنات الموقع الجغرافي التي يتم تتبُّعها على الخريطة. يمكنك استخدام خيارات التصميم المخصّصة لتطابق نمط تطبيق الويب.
التحكّم في ظهور المواقع الجغرافية التي يتم تتبُّعها
تتّبع أدوات تقديم الموقع الجغرافي المحدّدة مسبقًا في Fleet Engine قواعد الظهور التالية لكائنات الموقع الجغرافي التي يتم تتبُّعها على الخريطة. إذا أنشأت أداة تقديم موقع جغرافي مخصّصة أو مشتقة، يمكنك تغيير قواعد الظهور.
لا تظهر المركبات إلا عندما تكون الرحلة قيد التقدّم: تظهر مركبة الرحلة من وقت تخصيصها لرحلة إلى وقت التسليم. إذا تم إلغاء الرحلة، لن تظهر المركبة بعد ذلك.
تظهر جميع علامات المواقع الجغرافية الأخرى دائمًا: تظهر دائمًا على الخريطة جميع علامات المواقع الجغرافية الأخرى للمصدر والوجهة ونقاط المرور. على سبيل المثال، يظهر دائمًا على الخريطة موقع تسليم الرحلة أو موقع تسليم الشحنة، بغض النظر عن حالة الرحلة أو عملية التسليم.
الخطوات التالية
يُرجى الاطّلاع على مستندات المنصة التي تريد تتبُّع الرحلات عليها: