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