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