يمكنك تخصيص تجربة المستهلكين للرحلات عند الطلب من خلال السماح للمستهلكين بمتابعة الرحلة للحصول على طلب أو رحلة أو خدمة أخرى تقدّمها لهم.
ما هو Consumer SDK؟
تشكّل حزمة تطوير البرامج (SDK) للمستهلكين جزءًا من Fleet Engine للرحلات عند الطلب. وتوفّر هذه الواجهات نماذج لبيانات الرحلات وتتبّع الرحلات في Fleet Engine، كما يوفّر فئات تستخدمها لإنشاء عرض غني يستند إلى الخريطة لمشاركة الرحلات مع المستخدمين المستهلكين. يمكنك دمج حزمة Consumer SDK في تطبيقك وضبط الملفات الشخصية للدور المناسبة ضمن Fleet Engine لإنشاء تجربة المستهلك هذه.
تتيح لك واجهات برمجة التطبيقات الخاصة بمنصّة Consumer SDK إمكانية مشاركة التجارب بشكلٍ أصلي في تطبيقاتك. تتوفّر حزمة Consumer SDK للأنظمة الأساسية التالية:
ما هي مزايا استخدام حِزم تطوير البرامج (SDK) المخصّصة للمستهلكين؟
من خلال دمج حزمة Consumer SDK في تطبيقات الرحلات عند الطلب، يمكنك تقديم تجربة شاملة للمستهلكين، مع تعديلات على الموقع الجغرافي في وقت قريب من الوقت الفعلي وعرض مواضع المركبات على الخريطة. يمكن للمستهلكين الاطّلاع على مسار المركبة على الخريطة، بما في ذلك تفاصيل التقدّم التي تساعدهم في معرفة مكان الرحلة أو مكان التسليم.
ما هي الإجراءات التي يمكنك اتّخاذها باستخدام حِزم تطوير البرامج (SDK) المخصّصة للمستهلكين؟
يمكنك استخدام المعلومات الواردة من Driver SDK وFleet Engine لإنشاء تجارب مخصّصة للمستهلكين، بما في ذلك الميزات التالية:
يمكنك تخصيص واجهة مستخدم الخريطة لتلبية احتياجات علامتك التجارية.
يمكنك تتبُّع الموقع الجغرافي الحالي للمركبة أثناء سيرها على طول المسار، مع تعديل موقعها بشكل دوري.
عرض الوقت المقدَّر للوصول (ETA) لمكانَي الاستلام والتسليم
عرض المسافة المتبقية
عرض حركة المرور المباشرة على المسار
آلية عمل حزمة تطوير البرامج (SDK) للمستهلك
بشكل عام، تعتمد حِزم تطوير البرامج (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 | إعداد حزمة تطوير البرامج (SDK) للمستهلك في Android | اتّبِع الخطوات التالية لإعداد حزمة تطوير البرامج (SDK) للمستهلك من أجل تتبُّع الرحلات عند الطلب في تطبيقك: لمزيد من المعلومات، يُرجى الاطّلاع على الحصول على حزمة SDK لتطبيقات المستهلك على Android. |
| 2 | إعداد الواجهة المرئية | حدِّد خريطة وأضِف إمكانية استخدام الخرائط المتجهّة لإعداد تجربة المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد خريطة. |
| 3 | متابعة رحلة | يمكنك تتبُّع رحلة لمشاركة الموقع الجغرافي للمركبة المناسبة مع العميل. لمزيد من المعلومات، يُرجى الاطّلاع على متابعة رحلة. |
| 5 | تعديل مستوى تقدّم الرحلة ومعالجة أخطاء الرحلة | يمكنك تعديل تفاصيل رحلاتك، مثل المسافة التي تقطعها والوقت المقدَّر للوصول، ومعالجة أي أخطاء أثناء الرحلة. لمزيد من المعلومات، يُرجى الاطّلاع على تعديل مستوى تقدّم الرحلة و معالجة أخطاء الرحلة. |
| 5 | عند اكتمال رحلة، يمكنك التوقف عن متابعتها | يمكنك إيقاف متابعة رحلة لإيقاف مشاركة موقع المركبة مع العميل. لمزيد من المعلومات، يُرجى الاطّلاع على التوقف عن متابعة رحلة. |
iOS
| 1 | إعداد حزمة تطوير البرامج (SDK) لنظام التشغيل iOS | اتّبِع الخطوات التالية لإعداد حزمة تطوير البرامج (SDK) للمستهلك من أجل تتبُّع الرحلات عند الطلب في تطبيقك: لمزيد من المعلومات، يُرجى الاطّلاع على الحصول على حزمة تطوير البرامج (SDK) لتطبيقات المستهلك على نظام التشغيل iOS. |
| 2 | إعداد الواجهة المرئية | يمكنك إعداد عرض الخريطة ومعالجة أحداث الخريطة لإعداد تجربة المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد خريطة. |
| 3 | متابعة رحلة | يمكنك تتبُّع رحلة لمشاركة الموقع الجغرافي للمركبة المناسبة مع المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على متابعة رحلة. |
| 5 | تعديل مستوى تقدّم الرحلة ومعالجة أخطاء الرحلة | يمكنك تعديل تفاصيل رحلاتك، مثل المسافة التي تقطعها والوقت المقدَّر للوصول، ومعالجة أي أخطاء أثناء الرحلة. لمزيد من المعلومات، يُرجى الاطّلاع على تعديل مستوى تقدّم الرحلة و معالجة أخطاء الرحلة. |
| 5 | عند اكتمال رحلة، يمكنك التوقف عن متابعتها | يمكنك إيقاف متابعة رحلة لإيقاف مشاركة موقع المركبة مع العميل. لمزيد من المعلومات، يُرجى الاطّلاع على التوقف عن متابعة رحلة. |
JavaScript
| 1 | إعداد حزمة Consumer SDK في JavaScript | اتّبِع الخطوات التالية لإعداد حزمة تطوير البرامج (SDK) للمستهلك من أجل تتبُّع الرحلات عند الطلب في تطبيقك: لمزيد من المعلومات، يُرجى الاطّلاع على إعداد حزمة تطوير البرامج (SDK) لتطبيقات JavaScript. |
| 2 | تحميل خريطة وتخصيصها | فعِّل واجهة برمجة التطبيقات JavaScript API في "خرائط Google" وإعداد التفويض لإعداد تجربة المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد خريطة. |
| 3 | متابعة رحلة | يمكنك تتبُّع رحلة لمشاركة الموقع الجغرافي للمركبة المناسبة مع المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على متابعة رحلة. |
| 5 | تعديل مستوى تقدّم الرحلة ومعالجة أخطاء الرحلة | يمكنك تعديل تفاصيل رحلاتك، مثل المسافة التي تقطعها والوقت المقدَّر للوصول، ومعالجة أي أخطاء في رحلة. لمزيد من المعلومات، يُرجى الاطّلاع على تعديل مستوى تقدّم الرحلة وتتبُّعه و معالجة أخطاء الرحلة. |
| 5 | عند اكتمال رحلة، يمكنك التوقف عن متابعتها | يمكنك إيقاف متابعة رحلة لإيقاف مشاركة موقع المركبة مع العميل. لمزيد من المعلومات، يُرجى الاطّلاع على التوقف عن متابعة رحلة. |
المكونات
يلخّص هذا القسم مكونَين ضروريَين لمتابعة رحلة:
يمكنك أيضًا اختياريًا تخصيص تجربة المستهلك باستخدام المكونات التالية:
أداة جلب الرمز المميّز للمصادقة
للتحكّم في الوصول إلى بيانات الموقع الجغرافي المخزّنة في Fleet Engine، عليك تنفيذ ما يلي:
نفِّذ خدمة إنشاء رمز JSON المميّز للويب (JWT) في Fleet Engine على الخادم. لمزيد من المعلومات، يُرجى الاطّلاع على إصدار ملفات JWT.
نفِّذ أداة جلب رمز مصادقة في تطبيقات الويب أو التطبيقات المتوافقة مع الأجهزة الجوّالة لتأكيد هوية الوصول إلى بيانات الموقع الجغرافي. لمزيد من المعلومات عن إعداد أداة جلب الرموز المميّزة، اطّلِع على دليل الإعداد لنظام التشغيل Android أو iOS أو JavaScript.
"عرض الخريطة" وأدوات تتبُّع الرحلات
تتضمّن ميزة "متابعة رحلة" مكونات لعرض المركبات ونقاط الالتفاف، بالإضافة إلى خلاصات البيانات الأولية لوقت الوصول المقدَّر للسائق أو المسافة المتبقية التي يجب قطعها.
يوضّح الجدول التالي هذه المكوّنات:
| المكوّن | الوصف |
|---|---|
| عرض الخريطة للمستهلك | تدير طريقة عرض الخريطة رحلة كاملة، وتُظهر نقاط الطريق للموقع الجغرافي للمركبات أثناء تقدّم الرحلة. إذا كان مسار المركبة معروفًا، تعدّل طريقة عرض الخريطة مسار المركبة الخط المتعدد للإشارة إلى مدى تقدّم المركبة على طول مسارها. |
| موفِّر موقع الرحلة في JavaScript | بالنسبة إلى تطبيقات الويب المستندة إلى JavaScript، يُغذّي مقدّم الموقع الجغرافي للرحلة معلومات الموقع
للعناصر التي يتم تتبُّعها في خريطة الرحلة المشترَكة. لمزيد من
المعلومات، يُرجى الاطّلاع على
إنشاء مثيل لمقدّم معلومات الموقع الجغرافي للرحلة.
يمكنك استخدام مقدّم موقع الرحلة لتتبُّع التفاصيل التالية لرحلة:
|
عناصر المواقع الجغرافية التي يتم تتبُّعها
يتتبّع مقدّم الموقع الجغرافي مواقع الأجسام، مثل نقاط المرور والمركبات، الموضّحة في الجدول التالي.
| الموقع الجغرافي الذي يتم تتبُّعه | الوصف |
|---|---|
| مكان استلام السيارة | مكان الاستلام هو الموقع الجغرافي الذي تبدأ منه الرحلة. |
| الموقع الجغرافي للوجهة | الموقع الجغرافي للوجهة هو الموقع الجغرافي الذي تنتهي فيه الرحلة. يُستخدَم هذا الرمز لتحديد مكان الاستلام. |
| الموقع الجغرافي لنقطة على المسار | موقع نقطة الطريق هو أي موقع جغرافي وسيط على طول مسار رحلة تتم متابعتها. من الناحية الفنية، يمكن أن تتضمّن نقاط التوقف مواقع الالتقاط والتسليم، ولكن تشير نقاط التوقف عادةً إلى محطات توقف متوسطة على طول المسار. على سبيل المثال، تكون محطات التوقف بين مواقع نقطة الاستلام والوجهة على مسار التسليم هي مواقع نقاط الطريق. لمزيد من المعلومات، يُرجى الاطّلاع على نقاط الطريق في الرحلة في مستندات Fleet Engine. |
| الموقع الجغرافي للمركبة | الموقع الجغرافي للمركبة هو الموقع الجغرافي الذي تم الإبلاغ عنه لمركبة معيّنة. لمزيد من المعلومات، يُرجى الاطّلاع على الموقع الجغرافي للمركبة في مستندات Fleet Engine. |
تصميم أنماط للخرائط
تحدّد أنماط العلامات والخطوط المتعددة مظهر وأسلوب المواقع الجغرافية التي يتم تتبُّعها على الخريطة. يمكنك استخدام خيارات التصميم المخصّصة لمطابقة أسلوب تطبيق الويب.
التحكّم في مستوى ظهور المواقع الجغرافية التي يتم تتبُّعها
يتبع مزوّدو المواقع الجغرافية المحدّدون مسبقًا في Fleet Engine قواعد مستوى الرؤية التالية لعناصر المواقع الجغرافية التي يتم تتبُّعها على الخريطة. إذا أنشأت مقدّم خدمات موقع جغرافي مخصّصًا أو مشتقًا، يمكنك تغيير قواعد مستوى العرض.
لا تظهر المركبات إلا عندما تكون الرحلة جارية: تظهر المركبة المخصّصة للرحلة من وقت إسنادها إلى الرحلة إلى وقت إنزال الركّاب. إذا تم إلغاء الرحلة، لن تظهر المركبة بعد ذلك.
ظهور جميع علامات المواقع الجغرافية الأخرى دائمًا: تظهر دائمًا على الخريطة جميع علامات المواقع الجغرافية للنقطة الأولى والوجهة ونقاط الطريق. على سبيل المثال، يتم دائمًا عرض الموقع الجغرافي لمكان تسليم الرحلة أو الشحنة على الخريطة، بغض النظر عن حالة الرحلة أو عملية التسليم.
الخطوات التالية
اطّلِع على مستندات المنصة التي تريد متابعة الرحلات عليها: