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