توضّح المستندات الواردة في هذا القسم كيفية إنشاء الرحلات واستخدامها باستخدام خدمة الرحلات عند الطلب من خرائط Google. يفترض الإلمام بالمعرفة ما يلي:
- Fleet Engine: يجب أن تكون على دراية بتطبيق Fleet Engine. والتفاصيل وآليات الطلب والأمان. لإجراء ذلك، يُرجى الاطّلاع على مقالة ما هو Fleet؟ أو خدمة المحرّك؟ ومواضيع الأمان في مقالة إعداد Fleet Engine.
- أساسيات المركبات لتقديم خدمات عند الطلب: عرض مقدّمة عن المركبات:
- أساسيات الرحلات للخدمات عند الطلب: راجع الرحلات عند الطلب.
تجدر الإشارة إلى أنّ TripService الذي ستستخدمه متوفر لكل من gRPC وREST.
ولتبسيط الأمر، تتّبع مراجع الحقول اصطلاح gRPC.
في Fleet Engine للخدمات عند الطلب، تعد الرحلة نوعًا من الرحلة التي
توصيل الطعام أو طلب التوصيل من المستهلكين. رحلة
له حالة يتم إبلاغ Fleet Engine بها مع تطور الرحلة، مثل
NEW وENROUTE_TO_PICKUP والمزيد تتوافق حالة الرحلة مع الموقع الجغرافي
نقاط الطرق المخصصة للمركبة، وتُعدِّل Fleet Engine هذه
نقاط الطريق مع كل تحديث تقوم به للرحلة. الاطّلاع على مقالة الرحلات عند الطلب في قسم Fleet
أساسيات المحرّك لمعرفة المزيد عن الرحلات وعلاقتها بالمركبات
مدة الرحلة
لتتبّع كل رحلة في Fleet Engine، عليك أولاً إنشاء Trip.
. راجِع gRPC أو REST كمرجع.
يصف الجدول التالي مثالاً للتدفق الشامل لرحلة تم إنشاؤها في نظامك ومراحل دورة حياته في Fleet Engine. يفترض أنك أعددت Fleet Engine وقيادة مركبة مخصّصة للرحلة، مع تعديلات الموقع الجغرافي تم تفعيلها في تطبيق السائق. يُرجى الاطّلاع على حزمة تطوير البرامج (SDK) للسائق: الرحلات عند الطلب.
| 1 | تلقّي طلب الحجز: | قبل بدء رحلة Fleet Engine، يتلقى نظام الحجز أولاً
طلب رحلة أو توصيل من المستهلك من خلال تطبيقك أو
نظام الحجز لدينا. ينشئ النظام بعد ذلك كيان الرحلة باستخدام
CreateTrip وفيها الحقول المطلوبة، مثل الموقع الجغرافي للاستلام
ويمكنها أيضًا ضبط حقول أخرى في هذه المرحلة، مثل الركاب
أو موقع التسليم أو الانتظار حتى يعيّن مركبة. عرض
إنشاء رحلة وجهة واحدة |
| 2 | تخصيص المركبة: | يمكنك تخصيص مركبات للرحلات مباشرةً من داخل نظامك. والإبلاغ عن المهمة إلى Fleet Engine، أو يمكنك استخدام البحث عن مركبة خدمة البحث عن المركبات، والتصفية حسب الرحلة والمركبة للعثور على أفضل مركبة لإكمال الرحلة. أي موقع على الإنترنت مركبة داخل نصف قطر البحث تجعل التقارب معروفًا من خلال تحديثات الموقع الجغرافي التي توفِّرها حزمة تطوير البرامج (SDK) لبرنامج التشغيل. بعد أن تُرجع " |
| 3 | تعديل معلومات الرحلة | بعد أن يقبل السائق الرحلة ويبدأ في الانتقال إلى
الموقع الجغرافي لاستلام الطلب، سيعدّل النظام حالة الرحلة من NEW
إلى ENROUTE_TO_PICKUP. ستستمر في استطلاع المركبة.
طوال الرحلة، إما من خلال اتصال مباشر من
التطبيق إلى الخلفية، أو من خلال استطلاع رأي Fleet Engine، الذي يتلقى
البث المستمر لتحديثات الموقع الجغرافي للمركبة من "حزمة تطوير البرامج (SDK) للسائق"
ثم تقارير كل معلم رئيسي في الرحلة إلى Fleet Engine، والتي تقوم بتحديث
وقائمة النقاط الوسيطة للمركبة وفقًا لذلك.
|
| 4 | مشاركة معلومات الرحلة مع المستهلك | يوفّر Fleet Engine تفاصيل الرحلة والموقع الجغرافي للمركبة إلى حزمة تطوير البرامج (SDK) الخاصة بالمستهلك، التي تستخدم أداة استماع لتلقّي آخر المعلومات حول الرحلات وعرضها في تطبيق المستهلك. يعدّل Fleet Engine تلقائيًا الوقت المقدّر للوصول (المتبقي). والمسافة والمسارات ونقاط الطريق المتبقية للمركبة. عرض يمكنك مشاركة رحلات برحلات عند الطلب للحصول على مزيد من المعلومات. |
| 5 | إكمال الرحلة: | وبمجرد أن تصل المركبة إلى نقطة الطريق الوجهة للرحلة
يشير برنامج التشغيل إلى رحلة ناجحة، فإن النظام يضبط
من TripStatus إلى COMPLETE في Fleet Engine عدم الحذف
ضع في اعتبارك أنه، مثل المركبات، تظل كيانات الرحلات نشطة في Fleet Engine
لمدة 7 أيام بغض النظر عن حالتها، وعندها تتم إزالتها. |
مسار تسلسل الرحلة
يوضح الرسم التخطيطي التالي عرضًا أكثر تفصيلاً لهذا التدفق.
