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