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