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