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