توضّح المستندات الواردة في هذا القسم كيفية إنشاء الرحلات واستخدامها باستخدام خدمة الرحلات عند الطلب في "التنقّل في خرائط 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 أيام بغض النظر عن حالتها، وبعد ذلك تتم إزالتها. |
مسار تسلسل الرحلة
يعرض الرسم البياني التالي عرضًا أكثر تفصيلاً لهذا المسار.
