Was ist eine On-Demand-Fahrt?

In der Dokumentation in diesem Abschnitt erfahren Sie, wie Sie Fahrten mit dem On-Demand-Fahrdienst von Google Maps Mobility erstellen und verwenden. Es wird davon ausgegangen, dass Sie mit Folgendem vertraut sind:

Die von Ihnen verwendete TripService 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 Vorgang, der die Ausführung einer Essenslieferung oder Fahrtanfrage von Ihren Kunden simuliert. Ein Fahrtenauftrag hat einen Status, den Sie Fleet Engine im Laufe der Fahrt mitteilen, z. B. NEW oder ENROUTE_TO_PICKUP. Der Fahrtstatus entspricht den geolokalisierten Wegpunkten, die dem Fahrzeug zugewiesen sind. Die Fleet Engine ändert diese Fahrzeugwegpunkte bei jeder Fahrtaktualisierung. Weitere Informationen zu Fahrten und ihrer Beziehung zu Fahrzeugen finden Sie unter On-Demand-Fahrten in den Grundlagen von Fleet Engine.

Lebensdauer einer Fahrt

Damit jede Fahrt in der 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 Fahrt beschrieben, die in Ihrem System erstellt wurde, und die Lebenszyklusphasen in der Fleet Engine. Es wird davon ausgegangen, dass Sie Fleet Engine eingerichtet haben und ein Fahrzeug für die Fahrt zuweisen können, wobei Standortaktualisierungen in der Fahrer App aktiviert sind. Weitere Informationen finden Sie unter Driver SDK: Fahrten auf Abruf.

1 Sie erhalten eine Buchungsanfrage. Bevor ein Fleet Engine-Fahrtauftrag beginnt, erhält Ihr Buchungssystem zuerst eine Fahrt- oder Lieferanfrage von einem Nutzer über Ihre App oder ein anderes Buchungssystem. Ihr System erstellt dann die Fahrtenentität mit CreateTrip und erforderlichen Feldern wie dem Abholort. An dieser Stelle können auch andere Felder wie „Passagiere“ und „Abholort“ festgelegt werden. Es kann auch warten, bis ein Fahrzeug zugewiesen wurde. Weitere Informationen finden Sie unter Fahrt mit nur einem Ziel erstellen.
2 Fahrzeug zuweisen

Sie können Fahrzeuge entweder direkt in Ihrem System Fahrten zuweisen und die Zuweisung an Fleet Engine melden oder mit dem Dienst Fahrzeug suchen nach Fahrzeugen suchen. Dabei können Sie sowohl nach Fahrt- als auch nach Fahrzeugattributen filtern, um das beste Fahrzeug für die Fahrt zu finden. Alle online verfügbaren Fahrzeuge in Ihrem Suchradius geben ihre Nähe über Standortupdates bekannt, die vom Driver SDK bereitgestellt werden.

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 den Auftrag annimmt und zum Abholort fährt, aktualisiert Ihr System den Fahrtstatus von NEW auf ENROUTE_TO_PICKUP. Sie rufen den Fahrzeugstandort während der Fahrt weiter ab, entweder über eine direkte Verbindung von der App zu Ihrem Backend oder durch Abfragen der Fleet Engine, die einen kontinuierlichen Stream von Fahrzeugstandortaktualisierungen vom Driver SDK empfängt. Ihr System meldet dann jeden Meilenstein der Fahrt an die Fleet Engine, die die Wegpunktliste des Fahrzeugs entsprechend aktualisiert.
4 Den Kaufprozess mit den Nutzern teilen Fleet Engine stellt dem Consumer SDK Fahrtdetails und den Fahrzeugstandort zur Verfügung. Über einen Listener werden Fahrtupdates empfangen und in der Verbraucher-App angezeigt. Fleet Engine aktualisiert automatisch den geschätzten Zeitaufwand, die verbleibende Strecke, die Routen und die verbleibenden Wegpunkte des Fahrzeugs. Weitere Informationen finden Sie unter Fahrten für Fahrten auf Abruf teilen.
5 Vollständige Fahrt Sobald das Fahrzeug den Zielpunkt der Fahrt erreicht hat und der Fahrer die Fahrt als erfolgreich markiert hat, setzt das System in der Fleet Engine den Wert TripStatus auf COMPLETE. Fahrten bleiben wie Fahrzeuge unabhängig vom Status 7 Tage lang in der Fleet Engine aktiv. Danach werden sie entfernt.

Ablauf der Fahrtsequenz

Das folgende Diagramm zeigt eine detailliertere Ansicht dieses Ablaufs.

TripSequenceDiagram

Nächste Schritte