ما هي الرحلة عند الطلب؟
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضّح المستندات في هذا القسم كيفية إنشاء الرحلات والتعامل معها باستخدام خدمة "رحلات التنقّل عند الطلب" من "خرائط Google". ويفترض هذا المستند معرفتك بما يلي:
إنّ 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 ولديك مركبة لتحديدها للرحلة، مع تفعيل ميزة تعديل الموقع الجغرافي في تطبيق السائق. راجِع Driver SDK: الرحلات عند الطلب.
| 1 |
تلقّي طلب حجز |
قبل بدء رحلة Fleet Engine، يتلقّى نظام الحجز أولاً طلبًا من المستهلك للحصول على رحلة أو خدمة توصيل من خلال تطبيقك أو نظام حجز آخر. ينشئ نظامك بعد ذلك كيان الرحلة باستخدام
CreateTrip مع الحقول المطلوبة، مثل موقع الاستلام.
يمكنه أيضًا ضبط حقول أخرى في هذه المرحلة، مثل الركاب وموقع التوصيل، أو الانتظار إلى أن يتم تخصيص مركبة. يُرجى الاطّلاع على إنشاء رحلة إلى وجهة واحدة. |
| 2 |
إسناد مركبة |
يمكنك إما تعيين المركبات للرحلات مباشرةً ضمن نظامك والإبلاغ عن عملية التعيين إلى Fleet Engine، أو يمكنك استخدام خدمة البحث عن مركبة للبحث عن المركبات، مع الفلترة حسب سمات الرحلة والمركبة للعثور على أفضل مركبة لإكمال الرحلة. تُعلم أي مركبة متاحة على الإنترنت ضمن نطاق البحث بموقعها الجغرافي من خلال إشعارات التحديث بشأن الموقع الجغرافي التي توفّرها حزمة Driver SDK.
بعد أن تعرض الدالة SearchVehicle مركبة تطابق رحلة، يستدعي نظامك نقطة النهاية UpdateTrip لإرسال معرّف المركبة الذي حدّدته للرحلة NEW.
|
| 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 أيام بغض النظر عن الحالة، وبعد ذلك تتم إزالتها. |
مسار تسلسل الرحلات
يوضّح الرسم البياني التالي عرضًا أكثر تفصيلاً لهذا المسار.
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis documentation provides a comprehensive guide on utilizing the Google Maps Mobility on-demand trips service for managing and tracking trips.\u003c/p\u003e\n"],["\u003cp\u003eYou should have a foundational understanding of Fleet Engine, Vehicle Basics, and Trip Basics for on-demand services.\u003c/p\u003e\n"],["\u003cp\u003eFleet Engine's \u003ccode\u003eTripService\u003c/code\u003e enables the creation, assignment, updating, and completion of trips through gRPC or REST.\u003c/p\u003e\n"],["\u003cp\u003eTrips represent journeys fulfilling consumer requests, evolving through various statuses like \u003ccode\u003eNEW\u003c/code\u003e, \u003ccode\u003eENROUTE_TO_PICKUP\u003c/code\u003e, and \u003ccode\u003eCOMPLETE\u003c/code\u003e, influencing vehicle waypoints.\u003c/p\u003e\n"],["\u003cp\u003eThe trip lifecycle includes booking, vehicle assignment, status updates, consumer journey sharing, and completion, all managed through Fleet Engine interactions.\u003c/p\u003e\n"]]],[],null,["The documentation in this section shows how to create and work with trips using\nthe Google Maps Mobility on-demand trips service. It assumes familiarity with\nthe following:\n\n- **Fleet Engine** : You should be familiar with Fleet Engine implementation details, request mechanisms, and security. For that, see [What is the Fleet\n Engine service?](/maps/documentation/mobility/fleet-engine/essentials) and the security topics in [Set up Fleet Engine](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet).\n- **Vehicles basics** for on-demand services. See [Introduction to vehicles](/maps/documentation/mobility/fleet-engine/essentials/vehicles-intro).\n- **Trip basics** for on-demand services. See [On-demand trips](/maps/documentation/mobility/fleet-engine/essentials/trip-intro).\n\nThe `TripService` that you'll use is available for [gRPC](/maps/documentation/mobility/fleet-engine/reference/trips/rpc/maps.fleetengine.v1#tripservice) and [REST](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips).\nFor simplicity sake, field references follow the gRPC convention.\n\nIn Fleet Engine for on-demand services, a trip is a type of journey that models\nthe fulfillment of a food delivery or ride request from your consumers. A trip\nhas a status that you report to Fleet Engine as the journey evolves, such as\n`NEW`, `ENROUTE_TO_PICKUP`, and more. The trip status corresponds to geo-located\nwaypoints assigned to the vehicle, and Fleet Engine modifies these vehicle\nwaypoints with each trip update you make. See [On demand trips](/maps/documentation/mobility/fleet-engine/essentials/trip-intro) in **Fleet\nEngine essentials** for more about trips and their relationship to vehicles.\n\nLife of a trip\n\nIn order to track each trip in Fleet Engine, you must first create a `Trip`\nentity. See either [gRPC](/maps/documentation/mobility/fleet-engine/reference/trips/rpc/maps.fleetengine.v1#maps.fleetengine.v1.Trip) or [REST](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips) for reference.\n\nThe following table describes an example end-to-end flow of a trip created in\nyour system and its lifecycle stages in Fleet Engine. It assumes you have set up\nFleet Engine and have a vehicle to assign to the trip, with location updates\nenabled in the driver app. See [Driver SDK: On-demand trips](/maps/documentation/mobility/driver-sdk/on-demand).\n\n|---|----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Receive booking request.** | Before a Fleet Engine trip begins, your booking system first receives a request for a ride or delivery from a consumer through your app or other booking system. Your system then creates the trip entity using `CreateTrip` with required fields, such as the pickup location. It can also set other fields at this point, such passengers and dropoff location, or wait until it assigns a vehicle. See [Create a single-destination trip](/maps/documentation/mobility/fleet-engine/journeys/trips/create-trip). |\n| 2 | **Assign vehicle.** | You can either assign vehicles to trips directly within your system and report the assignment to Fleet Engine, or you can use the [Search Vehicle](/maps/documentation/mobility/fleet-engine/essentials/vehicles/on-demand-search-vehicle) service to search for vehicles, filtering by both trip and vehicle attributes to find the best vehicle to complete the journey. Any online vehicle within your search radius makes their proximity known through location updates provided by the Driver SDK. Once `SearchVehicle` returns a vehicle that you match to a trip, your system calls the `UpdateTrip` endpoint to report the vehicle ID you assigned to the `NEW` trip. |\n| 3 | **Update trip.** | Once the driver accepts the trip and begins navigating to the pickup location, your system updates the trip status from `NEW` to `ENROUTE_TO_PICKUP`. You continue to poll the vehicle location throughout the journey, either through a direct connection from the app to your backend, or by polling Fleet Engine, which receives an ongoing stream of vehicle location updates from the Driver SDK. Your system then reports each journey milestone to Fleet Engine, which updates the vehicle's waypoint list accordingly. |\n| 4 | **Share journey with consumer.** | Fleet Engine makes trip details and vehicle location available to the Consumer SDK, which uses a listener to receive trip updates and display them in the consumer app. Fleet Engine automatically updates ETA, remaining distance, routes, and remaining vehicle waypoints. See [Share journeys for on-demand trips](/maps/documentation/mobility/journey-sharing/on-demand) for more information. |\n| 5 | **Complete trip.** | Once the vehicle reaches the destination waypoint of the trip and your driver indicates a successful trip, your system sets the `TripStatus` to `COMPLETE` in Fleet Engine. Keep in mind that, like vehicles, trip entities remain active within Fleet Engine for 7 days regardless of status, at which point they are removed. |\n\nTrip sequence flow\n\nThe following diagram shows a more detailed view of this flow.\n\nWhat's next\n\n- [Create a single-destination trip](/maps/documentation/mobility/fleet-engine/journeys/trips/create-trip)"]]
