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