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