Was ist eine On-Demand-Fahrt?
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In der Dokumentation in diesem Abschnitt wird beschrieben, wie Sie mit dem Google Maps Mobility on-demand trips-Dienst Fahrten erstellen und damit arbeiten. Dabei wird davon ausgegangen, dass Sie mit Folgendem vertraut sind:
Die TripService, die Sie verwenden, ist für gRPC und REST verfügbar.
Der Einfachheit halber folgen Feldreferenzen der gRPC-Konvention.
In Fleet Engine für On-Demand-Dienste ist eine Fahrt eine Art von Reise, die die Erfüllung einer Essenslieferung oder einer Fahranfrage Ihrer Kunden modelliert. Eine Fahrt hat einen Status, den Sie im Laufe der Fahrt an Fleet Engine melden, z. B. NEW oder ENROUTE_TO_PICKUP. Der Fahrtstatus entspricht den geografisch verorteten Wegpunkten, die dem Fahrzeug zugewiesen sind. Fleet Engine ändert diese Fahrzeugwegpunkte mit jeder Fahrtaktualisierung, die Sie vornehmen. Weitere Informationen zu Fahrten und ihrem Bezug zu Fahrzeugen finden Sie unter Fahrten auf Abruf in Fleet Engine – Grundlagen.
Lebenszyklus einer Reise
Damit jede Fahrt in Fleet Engine erfasst werden kann, müssen Sie zuerst eine Trip-Entität erstellen. Weitere Informationen finden Sie unter gRPC oder REST.
In der folgenden Tabelle wird ein Beispiel für den End-to-End-Ablauf einer in Ihrem System erstellten Fahrt und deren Lebenszyklusphasen in Fleet Engine beschrieben. Dabei wird davon ausgegangen, dass Sie Fleet Engine eingerichtet haben und ein Fahrzeug für die Zuweisung zur Fahrt zur Verfügung steht, für das Standortaktualisierungen in der Fahrer-App aktiviert sind. Weitere Informationen finden Sie unter Driver SDK: On-Demand-Fahrten.
| 1 |
Buchungsanfrage erhalten |
Bevor eine Fleet Engine-Fahrt beginnt, erhält Ihr Buchungssystem zuerst eine Anfrage für eine Fahrt oder Lieferung von einem Kunden über Ihre App oder ein anderes Buchungssystem. Ihr System erstellt dann die Fahrtentität mit CreateTrip und erforderlichen Feldern wie dem Abholort.
Es kann an dieser Stelle auch andere Felder festlegen, z. B. Fahrgäste und Abgabeort, oder warten, bis ein Fahrzeug zugewiesen wird. Weitere Informationen finden Sie unter Fahrt mit einem Zielort erstellen. |
| 2 |
Fahrzeug zuweisen: |
Sie können entweder Fahrzeuge direkt in Ihrem System Fahrten zuweisen und die Zuweisung an Fleet Engine melden oder den Dienst Search Vehicle verwenden, um nach Fahrzeugen zu suchen. Dabei können Sie sowohl nach Fahrt- als auch nach Fahrzeugattributen filtern, um das beste Fahrzeug für die Fahrt zu finden. Alle Onlinefahrzeuge innerhalb Ihres Suchradius geben ihre Nähe durch Standortaktualisierungen über das Driver SDK bekannt.
Sobald SearchVehicle ein Fahrzeug zurückgibt, das Sie einer Fahrt zuordnen, ruft Ihr System den UpdateTrip-Endpunkt auf, um die Fahrzeug-ID zu melden, die Sie der NEW-Fahrt zugewiesen haben.
|
| 3 |
Fahrt aktualisieren |
Sobald der Fahrer die Fahrt annimmt und zum Abholort navigiert, aktualisiert Ihr System den Fahrtstatus von NEW auf ENROUTE_TO_PICKUP. Sie rufen den Fahrzeugstandort während der gesamten Fahrt ab. Das kann entweder über eine direkte Verbindung von der App zu Ihrem Backend oder durch Abrufen von Fleet Engine erfolgen. Fleet Engine erhält einen fortlaufenden Stream von Fahrzeugstandortaktualisierungen vom Driver SDK. Ihr System meldet dann jeden Meilenstein der Fahrt an Fleet Engine, wodurch die Wegpunktliste des Fahrzeugs entsprechend aktualisiert wird.
|
| 4 |
Kaufprozess mit dem Kunden teilen: |
Fleet Engine stellt dem Consumer SDK Fahrtdetails und den Fahrzeugstandort zur Verfügung. Das SDK verwendet einen Listener, um Fahrtaktualisierungen zu empfangen und in der Verbraucher-App anzuzeigen. Fleet Engine aktualisiert automatisch die voraussichtliche Ankunftszeit, die verbleibende Entfernung, die Routen und die verbleibenden Fahrzeugwegpunkte. Weitere Informationen finden Sie unter Fahrten für On-Demand-Fahrten freigeben. |
| 5 |
Fahrt abschließen |
Sobald das Fahrzeug den Ziel-Waypoint der Fahrt erreicht und der Fahrer angibt, dass die Fahrt erfolgreich war, wird in Fleet Engine der TripStatus auf COMPLETE gesetzt. Beachten Sie, dass Reiseobjekte wie Fahrzeuge unabhängig vom Status 7 Tage lang in Fleet Engine aktiv bleiben und dann entfernt werden. |
Ablauf der Reise
Das folgende Diagramm zeigt eine detailliertere Ansicht dieses Ablaufs.
Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 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)"]]
