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