Was ist eine On-Demand-Fahrt?

Die Dokumentation in diesem Abschnitt zeigt, wie Sie mithilfe von On-Demand-Fahrtendienst von Google Maps Mobility. Dabei wird vorausgesetzt, dass Sie Folgendes:

Die von Ihnen verwendete TripService ist für gRPC und REST verfügbar. Der Einfachheit halber folgen Feldverweise der gRPC-Konvention.

In Fleet Engine für On-Demand-Dienste ist eine Fahrt eine Art von Journey, bei dem die Ausführung von Essens- oder Fahrtanfragen von Kunden zu liefern. Eine Reise einen Status haben, den Sie im Verlauf des Prozesses an Fleet Engine melden, z. B. NEW, ENROUTE_TO_PICKUP und mehr. Der Fahrtstatus entspricht die dem Fahrzeug zugewiesen sind, und Fleet Engine ändert diese bei jeder Aktualisierung Ihrer Fahrt. Siehe Reisen auf Abruf in Flotte Grundlegendes zu Motoren mit weiteren Informationen zu Fahrten und deren Beziehung zu Fahrzeugen.

Reiseverlauf

Um jede Fahrt in Fleet Engine zu verfolgen, müssen Sie zuerst eine Trip erstellen Entität. Siehe entweder gRPC oder REST als Referenz.

Die folgende Tabelle beschreibt einen Beispiel-End-to-End-Ablauf einer Fahrt, die in und seine Lebenszyklusphasen in Fleet Engine. Es wird vorausgesetzt, dass Sie Fleet Engine und ein Fahrzeug, das der Fahrt zugewiesen werden soll, mit Standortaktualisierungen in der Treiber-App aktiviert ist. Siehe Driver SDK: On-Demand-Fahrten.

1 Buchungsanfrage erhalten Bevor eine Fleet Engine-Fahrt beginnt, erhält Ihr Buchungssystem zuerst eine eine Fahrt oder Lieferung eines Kunden über Ihre App oder eine andere Buchungssystem. Ihr System erstellt dann die Fahrtentität mit CreateTrip durch Pflichtfelder wie den Abholort. An dieser Stelle können auch andere Felder festgelegt werden, z. B. Passagiere und oder warten Sie, bis ein Fahrzeug zugewiesen wird. Weitere Informationen finden Sie unter Erstellen Sie eine Reise mit einem einzelnen Ziel.
2 Fahrzeug zuweisen.

Sie können Fahrzeuge den Fahrten direkt in Ihrem System zuweisen und die Zuweisung an Fleet Engine melden. Alternativ können Sie Fahrzeug suchen Dienst zur Suche nach Fahrzeugen, wobei sowohl nach Fahrt als auch nach Fahrzeug gefiltert wird Attribute, um das beste Fahrzeug für die Fahrt zu finden. Alle online in Ihrem Suchradius zu sehen ist, Standortaktualisierungen, die vom Driver SDK bereitgestellt werden.

Sobald SearchVehicle ein Fahrzeug zurückgibt, das Sie einer Fahrt zuordnen können, ruft das System den Endpunkt UpdateTrip auf, um die Fahrzeug-ID zu melden. Sie der Reise „NEW“ zugewiesen.
3 Fahrt aktualisieren. Sobald der Fahrer die Fahrt akzeptiert und die Route Abholort aktualisiert, aktualisiert dein System den Reisestatus von NEW an ENROUTE_TO_PICKUP. Du fragst das Fahrzeug weiter während des gesamten Kaufprozesses zu erreichen, entweder über eine direkte Verbindung von an Ihr Back-End senden oder Fleet Engine abfragen, das eine laufender Stream von Aktualisierungen des Fahrzeugstandorts aus dem Driver SDK. Ihr alle Meilenstein-Releases an Fleet Engine, die Wegpunktliste des Fahrzeugs entsprechend.
4 Erläutern Sie den Kaufprozess. Mit Fleet Engine können die Consumer SDK, das einen Listener verwendet, um Updates zu Fahrten zu empfangen und anzuzeigen in der Nutzer-App. Fleet Engine aktualisiert die ETA automatisch, verbleibend Entfernung, Routen und verbleibende Fahrzeug-Wegpunkte. Weitere Informationen finden Sie unter Wenn Sie On-Demand-Fahrten teilen, erhalten Sie weitere Informationen.
5 Fahrt abschließen. Sobald das Fahrzeug den Ziel-Wegpunkt erreicht hat und eine erfolgreiche Fahrt anzeigt, legt Ihr System TripStatus bis COMPLETE in Fleet Engine. Behalten wie Fahrzeuge und Fahrtentitäten in Fleet Engine aktiv bleiben. für 7 Tage unabhängig vom Status. Danach werden sie entfernt.

Ablauf der Fahrtsequenz

Das folgende Diagramm zeigt eine detailliertere Ansicht dieses Ablaufs.

TripSequenceDiagram

Nächste Schritte