نظرة عامة على الرحلات عند الطلب باستخدام حزمة تطوير البرامج (SDK) الخاصة بالمستهلكين

يمكنك تخصيص تجربة المستهلكين للرحلات عند الطلب من خلال السماح لهم بتتبُّع رحلة طلب أو رحلة أو خدمة أخرى تقدّمها لهم.

تطبيق المستهلك بعد رحلة

ما هي حزمة تطوير البرامج (SDK) الخاصة بالمستهلكين؟

إنّ حزمة تطوير البرامج (SDK) الخاصة بالمستهلكين هي جزء من Fleet Engine للرحلات عند الطلب. توفّر هذه المكتبة واجهات تعرض بيانات الرحلات وتتتبّع الرحلات في Fleet Engine، كما توفّر فئات يمكنك استخدامها لإنشاء عرض غني يستند إلى الخريطة لمشاركة الرحلات مع المستخدمين النهائيين. يمكنك دمج حزمة Consumer SDK في تطبيقك وضبط ملفات الأدوار المناسبة في Fleet Engine لإنشاء تجربة المستهلك هذه.

تتيح لك واجهات برمجة التطبيقات الخاصة بمنصة Consumer SDK إنشاء إمكانية مشاركة الرحلات مباشرةً في تطبيقاتك. تتوفّر حزمة Consumer SDK للمنصات التالية:

لماذا يجب استخدام حزمة تطوير البرامج (SDK) المخصّصة للمستهلكين؟

يتيح لك دمج حزمة تطوير البرامج (SDK) الخاصة بالمستهلكين في تطبيقات الرحلات عند الطلب تقديم تجربة شاملة للمستهلكين، مع إمكانية تعديل المواقع الجغرافية في الوقت الفعلي تقريبًا وتحديد المواقع الجغرافية على الطرق. يمكن للمستهلكين الاطّلاع على مسار المركبة معروضًا على الخريطة، بما في ذلك تفاصيل التقدم التي تساعدهم في معرفة مكان رحلتهم أو عملية التسليم.

الإجراءات التي يمكن تنفيذها باستخدام Consumer SDK

يمكنك استخدام المعلومات الواردة من Driver SDK وFleet Engine لإنشاء تجارب مخصّصة للمستهلكين تتضمّن الميزات التالية:

  • تخصيص واجهة مستخدم الخريطة لتناسب احتياجات علامتك التجارية

  • تتبُّع الموقع الجغرافي الحالي للمركبة أثناء تحرّكها على طول المسار، مع تعديل موضعها بشكل دوري

  • عرض الوقت المقدَّر للوصول إلى مواقع الاستلام والتسليم

  • عرض المسافة المتبقية

  • عرض حركة المرور في الوقت الفعلي على المسار

طريقة عمل حزمة تطوير البرامج (SDK) الخاصة بالمستهلك

بشكل عام، تعتمد حزمة تطوير البرامج (SDK) المخصّصة للمستهلكين على الآليات التالية:

  • يجب أن يكون لديك أدوار Fleet Engine المناسبة حتى يتمكّن تطبيق مصادَق عليه من تتبُّع الرحلة المرتبطة بطلب أحد المستهلكين.
  • تمثّل هذه السمة رابطًا بين المستهلك والرحلة، ويوفّرها نظام الخلفية.
  • فئتَا حزمة تطوير البرامج (SDK) TripModel وJourneySharingSession اللتان تصمّمان بيانات الرحلات وتشاركان جلسات الرحلات في تطبيق المستهلك.

توفّر حزمة تطوير البرامج (SDK) الخاصة بالمستهلك أيضًا واجهات وفئات أخرى تتيح لك إنشاء تجربة تطبيق غنية تتضمّن تفاصيل مثل حركة المرور ومحدّدات الخريطة والوقت المقدر للوصول وبيانات المسار.

طريقة عمل حزمة تطوير البرامج (SDK) الخاصة بالمستهلكين

يعرض هذا الجدول مسار رحلة يتبعه تطبيق المستهلك.

1 تطبيق المستهلك يطلب رحلة يتلقّى خادم الخلفية طلب رحلة عند الطلب وينفّذ ما يلي:
  • تنشئ هذه الطريقة رحلة في Fleet Engine.
  • تخصّص الرحلة لمركبة.
2 قبول السائق للرحلة يتلقّى تطبيق السائق معرّف الرحلة ومعلومات الرحلة، ويقبل السائق الرحلة.
3 تطبيق المستهلك يطلب الإذن بالوصول إلى بيانات الرحلة يحصل تطبيق المستهلك على معرّف الرحلة من الخلفية ويرسل طلبًا لبدء تتبُّع الرحلة.
4 بدء الرحلة من قِبل السائق عندما يستخدم السائق تطبيق السائق للإشارة إلى أنّ الرحلة قد بدأت، يرسل التطبيق إشعارًا إلى خادم الخلفية من خلال حزمة Driver 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، عليك اتّخاذ الإجراءات التالية:

  1. نفِّذ خدمة إنشاء رمز JSON المميّز للويب (JWT) في Fleet Engine على خادمك. لمزيد من المعلومات، اطّلِع على إصدار رموز JWT.

  2. نفِّذ أداة جلب لرموز المصادقة في تطبيقات الويب أو الأجهزة الجوّالة للمصادقة على إذن الوصول إلى بيانات الموقع الجغرافي. لمزيد من المعلومات حول إعداد أداة جلب الرموز المميّزة، راجِع دليل الإعداد لنظام التشغيل Android أو iOS أو JavaScript.

عرض الخريطة وأدوات تتبُّع الرحلات

تتضمّن ميزة "تتبُّع رحلة" مكوّنات لتصوّر المركبات ونقاط الطريق، بالإضافة إلى خلاصات البيانات الأولية الخاصة بالوقت المقدّر للوصول أو المسافة المتبقية للقيادة.

يوضّح الجدول التالي هذه المكوّنات:

المكوّن الوصف
طريقة عرض الخريطة الخاصة بالمستهلكين تتولّى طريقة عرض الخريطة إدارة دورة حياة الرحلة، حيث تعرض نقاطًا وسيطة لموقع المركبات أثناء تقدّم الرحلة. إذا كان مسار المركبة معروفًا، تعدّل طريقة عرض الخريطة خطوطًا متعددة الأضلاع لمسار المركبة للإشارة إلى مدى تقدّم المركبة على طول مسارها.
مقدّم بيانات الموقع الجغرافي للرحلة في JavaScript بالنسبة إلى تطبيقات الويب المستندة إلى JavaScript، يقدّم موفّر بيانات الموقع الجغرافي للرحلة معلومات الموقع الجغرافي للعناصر التي يتم تتبُّعها في خريطة الرحلة المشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء مثيل لموفّر الموقع الجغرافي للرحلة. يمكنك استخدام مقدّم خدمة الموقع الجغرافي للرحلة لتتبُّع التفاصيل التالية الخاصة برحلة:
  • يشير إلى موقع الركوب أو النزول في رحلة.
  • الموقع الجغرافي للمركبة المخصّصة للرحلة ومسارها

عناصر المواقع الجغرافية التي يتم تتبُّعها

يتتبّع موفّر بيانات الموقع الجغرافي الموقع الجغرافي للعناصر، مثل نقاط الطريق والمركبات، كما هو موضّح في الجدول التالي.

الموقع الجغرافي الذي يتم تتبُّعه الوصف
مكان استلام السيارة موقع الاستلام هو الموقع الجغرافي الذي تبدأ منه الرحلة.
الموقع الجغرافي للوجهة الموقع الجغرافي للوجهة هو الموقع الجغرافي الذي تنتهي فيه الرحلة. تحدّد هذه السمة الموقع الجغرافي لتسليم الطلب.
موقع نقطة على المسار موقع نقطة المرور هو أي موقع جغرافي وسيط على طول مسار رحلة يتم تتبُّعها. من الناحية الفنية، يمكن أن تتضمّن نقاط المرور مواقع الاستلام والتسليم، ولكنّها تشير عادةً إلى المحطات الوسيطة على طول المسار. على سبيل المثال، المحطات بين موقعَي الاستلام والتسليم على مسار التسليم هي مواقع نقاط الطريق. لمزيد من المعلومات، راجِع مقالة نقاط توقّف الرحلة في مستندات Fleet Engine.
الموقع الجغرافي للمركبة موقع المركبة هو الموقع الجغرافي الذي تم الإبلاغ عنه للمركبة. لمزيد من المعلومات، يُرجى الاطّلاع على الموقع الجغرافي للمركبة في مستندات Fleet Engine.

تخصيص مظهر خرائطك

تحدّد أنماط العلامات والخطوط المتعددة شكل ومظهر عناصر المواقع الجغرافية التي يتم تتبّعها على الخريطة. يمكنك استخدام خيارات التنسيق المخصّصة لتتطابق مع نمط تطبيق الويب.

التحكّم في إمكانية رؤية المواقع الجغرافية التي تم تتبُّعها

تتّبع الجهات المزوّدة بخدمة الموقع الجغرافي المحدّدة مسبقًا في Fleet Engine قواعد الظهور التالية لكائنات الموقع الجغرافي التي يتم تتبّعها على الخريطة. في حال إنشاء خدمة مخصّصة أو مشتقة لتحديد الموقع الجغرافي، يمكنك تغيير قواعد الظهور.

  • لا تظهر المركبات إلا عندما تكون الرحلة قيد التقدّم: تظهر مركبة الرحلة منذ وقت تخصيصها لرحلة إلى وقت التسليم. وإذا تم إلغاء الرحلة، لن تظهر المركبة.

  • تظهر دائمًا جميع علامات المواقع الجغرافية الأخرى: تظهر دائمًا على الخريطة جميع علامات المواقع الجغرافية الأخرى الخاصة بالموقع الجغرافي للمصدر والوجهة ونقاط المرور. على سبيل المثال، يظهر دائمًا على الخريطة الموقع الجغرافي الذي تم فيه تسليم شحنة أو إنهاء رحلة، بغض النظر عن حالة الرحلة أو التسليم.

الخطوات التالية

اطّلِع على المستندات الخاصة بالمنصة التي تريد تتبُّع الرحلات عليها: