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

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

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

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

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

تتيح لك واجهات برمجة التطبيقات الخاصة بالنظام الأساسي في حزمة تطوير البرامج (SDK) للمستهلك إنشاء إمكانية مشاركة الرحلات بشكلٍ أصلي في تطبيقاتك. تتوفّر حزمة تطوير البرامج (SDK) للمستهلكين للمنصات التالية:

لماذا يجب استخدام Consumer SDK؟

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

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

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

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

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

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

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

  • عرض حركة المرور المباشرة على المسار

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

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

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

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

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

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

1 يطلب تطبيق المستهلك رحلة يتلقّى خادم الخلفية طلب رحلة عند الطلب وينفّذ ما يلي:
  • تنشئ رحلة في Fleet Engine.
  • يتم تعيين الرحلة لمركبة.
2 قبول السائق للرحلة يتلقّى تطبيق السائق معرّف الرحلة ومعلومات الرحلة، ويقبل السائق الرحلة.
3 يطلب تطبيق المستهلك إذن الوصول لمتابعة الرحلة يحصل تطبيق المستهلك على معرّف الرحلة من الخلفية ويطلب بدء متابعة الرحلة.
4 بدء السائق الرحلة عندما يستخدم السائق تطبيق السائق للإشارة إلى أنّ الرحلة قد بدأت، يُرسِل التطبيق إشعارًا إلى خادم الخلفية من خلال حزمة تطوير البرامج (SDK) للسائق. على سبيل المثال، عندما يكون السائق على وشك مغادرة المطعم أو القيادة إلى موقع الاستلام.
5 يبدأ Fleet Engine في إرسال معلومات الرحلة يبدأ Fleet Engine في تتبُّع الرحلة ومشاركة مستوى تقدّمها مع تطبيق المستهلك.
6 يعرض تطبيق المستهلك معلومات الرحلة يرسل تطبيق المستهلك إشعارًا إلى المستهلك ويبدأ بعرض معلومات الرحلة له، مع تعديل الرحلة أثناء تقدّمها.
7 تم إلغاء الرحلة أو اكتمالها عندما يلغي السائق الرحلة أو يكملها، يوقف تطبيق السائق ميزة تتبُّع الموقع الجغرافي، ويطلب خادم الخلفية من Fleet Engine وضع علامة على الرحلة على أنّها ملغاة أو مكتملة.
8 يتوقف تطبيق المستهلك عن تتبُّع الرحلة تظهر الرحلة على أنّها ملغاة أو مكتملة.
9 تتكرر العملية في الرحلة التالية يتم إنشاء رحلة جديدة وتتكرر العملية.

كيفية استخدام Consumer SDK

اختَر نظامك الأساسي لمعرفة كيفية بدء تتبُّع الرحلات في تطبيقات المستهلكين.

Android

1 إعداد حزمة تطوير البرامج (SDK) للمستهلك في Android لمتابعة الرحلات عند الطلب في تطبيقك، عليك إعداد حزمة تطوير البرامج (SDK) للمستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الحصول على حزمة SDK للمستهلك على Android.
2 إعداد الواجهة المرئية حدِّد خريطة وأضِف إمكانية استخدام الخرائط الاتجاهية لإعداد تجربة المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد خريطة.
3 متابعة رحلة تتبَّع رحلة لمشاركة الموقع الجغرافي للمركبة المناسبة مع المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة متابعة رحلة.
5 تعديل مستوى تقدّم الرحلة ومعالجة أخطاء الرحلة يمكنك تعديل تفاصيل رحلاتك، مثل مسافة السفر والوقت المقدَّر للوصول، ومعالجة أي أخطاء أثناء الرحلة. لمزيد من المعلومات، يُرجى الاطّلاع على تعديل مستوى تقدّم الرحلة و معالجة أخطاء الرحلات.
5 عند اكتمال الرحلة، توقَّف عن المتابعة يمكنك إيقاف تتبُّع رحلة لإيقاف مشاركة الموقع الجغرافي للمركبة مع المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على إيقاف متابعة رحلة.

iOS

1 إعداد حزمة تطوير البرامج (SDK) للمستهلك في نظام التشغيل iOS لمتابعة الرحلات عند الطلب في تطبيقك، عليك إعداد حزمة تطوير البرامج (SDK) للمستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الحصول على حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS.
2 إعداد الواجهة المرئية ابدأ عرض الخريطة وتعامل مع أحداث الخريطة لإعداد تجربة المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد خريطة.
3 متابعة رحلة تتبَّع رحلة لمشاركة الموقع الجغرافي للمركبة المناسبة مع المستهلك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة متابعة رحلة.
5 تعديل مستوى تقدّم الرحلة ومعالجة أخطاء الرحلة تعديل التفاصيل في رحلاتك، مثل مسافة السفر والوقت المقدَّر للوصول، ومعالجة أي أخطاء أثناء الرحلة لمزيد من المعلومات، يُرجى الاطّلاع على تعديل مستوى تقدّم الرحلة و معالجة أخطاء الرحلات.
5 عند اكتمال الرحلة، توقَّف عن المتابعة أوقِف تتبُّع رحلة لإيقاف مشاركة الموقع الجغرافي للمركبة مع العميل. لمزيد من المعلومات، يُرجى الاطّلاع على إيقاف متابعة رحلة.

JavaScript

1 إعداد حزمة تطوير البرامج (SDK) للمستهلك في JavaScript لمتابعة الرحلات عند الطلب في تطبيقك، عليك إعداد حزمة تطوير البرامج (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 قواعد الظهور هذه لكائنات المواقع الجغرافية التي يتم تتبُّعها على الخريطة. إذا أنشأت موفّر موقع جغرافي مخصّص أو مشتق، يمكنك تغيير قواعد مستوى العرض.

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

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

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

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