מהי נסיעה על פי דרישה?
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במסמכי התיעוד שבקטע הזה מוסבר איך ליצור נסיעות ולעבוד איתן באמצעות שירות הנסיעות לפי דרישה של מפות 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: On-demand trips.
| 1 |
מקבלים בקשה להזמנה. |
לפני שנסיעה ב-Fleet Engine מתחילה, מערכת ההזמנות שלכם מקבלת קודם בקשה לנסיעה או למשלוח מלקוח דרך האפליקציה או מערכת הזמנות אחרת. המערכת יוצרת את ישות הנסיעה באמצעות
CreateTrip עם שדות החובה, כמו מיקום האיסוף.
בשלב הזה אפשר גם להגדיר שדות אחרים, כמו נוסעים ומיקום הורדה, או להמתין עד להקצאת רכב. אפשר לעיין במאמר בנושא יצירת נסיעה ליעד אחד. |
| 2 |
הקצאת רכב. |
אתם יכולים להקצות כלי רכב לנסיעות ישירות במערכת שלכם ולדווח על ההקצאה ל-Fleet Engine, או להשתמש בשירות Search Vehicle כדי לחפש כלי רכב ולסנן לפי מאפייני נסיעה וכלי רכב כדי למצוא את כלי הרכב המתאים ביותר להשלמת הנסיעה. כל רכב אונליין שנמצא ברדיוס החיפוש שלכם משתף את המיקום שלו באמצעות עדכוני מיקום שמסופקים על ידי Driver SDK.
אחרי ש-SearchVehicle מחזיר רכב שמתאים לנסיעה, המערכת שלכם קוראת לנקודת הקצה UpdateTrip כדי לדווח על מזהה הרכב שהקציתם לנסיעה NEW.
|
| 3 |
עדכון הנסיעה. |
אחרי שהנהג יאשר את הנסיעה ויתחיל לנווט לנקודת האיסוף, המערכת תעדכן את סטטוס הנסיעה מNEW לENROUTE_TO_PICKUP. אתם ממשיכים לבצע בדיקות חוזרות של מיקום הרכב במהלך הנסיעה, או באמצעות חיבור ישיר מהאפליקציה אל ה-Backend שלכם, או באמצעות בדיקות חוזרות של Fleet Engine, שמקבל זרם מתמשך של עדכונים לגבי מיקום הרכב מ-Driver SDK. לאחר מכן, המערכת שלכם מדווחת על כל אבן דרך במסלול ל-Fleet Engine, והוא מעדכן את רשימת נקודות הציון של הרכב בהתאם.
|
| 4 |
שיתוף המסלול עם הלקוח |
Fleet Engine מעביר את פרטי הנסיעה ואת מיקום הרכב אל Consumer 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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\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)"]]
