In der Dokumentation in diesem Abschnitt wird beschrieben, wie Sie Fahrten mit dem Google Maps Mobility on-demand trips-Dienst erstellen und damit arbeiten. Es wird davon ausgegangen, dass Sie mit Folgendem vertraut sind:
- Fleet Engine: Sie sollten mit den Implementierungsdetails, Anfragemechanismen und Sicherheitsaspekten von Fleet Engine vertraut sein. Weitere Informationen finden Sie unter Was ist der Fleet Engine-Dienst? und in den Sicherheitsthemen unter Fleet Engine einrichten.
- Grundlagen zu Fahrzeugen für On-Demand-Dienste Weitere Informationen finden Sie unter Einführung in Fahrzeuge.
- Grundlagen zu Fahrten für On-Demand-Dienste. Weitere Informationen finden Sie unter On-Demand-Fahrten.
Die TripService, die Sie verwenden, 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 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 ihrer Beziehung zu Fahrzeugen finden Sie unter On-Demand-Fahrten in Grundlagen der Fleet Engine.
Ablauf einer Fahrt
Wenn Sie eine Fahrt in Fleet Engine verfolgen möchten, 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 einen End-to-End-Ablauf einer in Ihrem System erstellten Fahrt und deren Lebenszyklusphasen in Fleet Engine beschrieben. Es wird davon ausgegangen, dass Sie Fleet Engine eingerichtet haben und ein Fahrzeug für die Fahrt zuweisen können, wobei Standort-Updates 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 Nutzer über Ihre App oder ein anderes Buchungssystem. Ihr System erstellt dann die Fahrteinheit mit CreateTrip und den erforderlichen Feldern, z. B. 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 Fahrzeuge entweder 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. Jedes Onlinefahrzeug innerhalb Ihres Suchradius gibt seine Nähe durch Standortaktualisierungen des Driver SDK bekannt. Sobald |
| 3 | Fahrt aktualisieren | Sobald der Fahrer die Fahrt annimmt und sich auf den Weg zum Abholort macht, ändert Ihr System den Fahrtstatus von NEW in ENROUTE_TO_PICKUP. Sie rufen den Fahrzeugstandort während der gesamten Fahrt ab, entweder über eine direkte Verbindung von der App zu Ihrem Backend oder durch Abfragen der Fleet Engine, die einen fortlaufenden Stream von Fahrzeug-Standort-Updates vom Driver SDK erhält. Ihr System meldet dann jeden Meilenstein der Fahrt an Fleet Engine, die die Wegpunktliste des Fahrzeugs entsprechend aktualisiert.
|
| 4 | Kaufprozess mit dem Kunden teilen: | Die 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. Die Fleet Engine aktualisiert automatisch die voraussichtliche Ankunftszeit, die verbleibende Entfernung, die Routen und die verbleibenden Wegpunkte des Fahrzeugs. Weitere Informationen finden Sie unter Fahrten für On-Demand-Fahrten freigeben. |
| 5 | Fahrt abschließen: | Sobald das Fahrzeug den Ziel-Wegpunkt der Fahrt erreicht hat und der Fahrer angibt, dass die Fahrt erfolgreich war, wird TripStatus in Fleet Engine auf COMPLETE gesetzt. Wie bei Fahrzeugen bleiben auch Reiseobjekte unabhängig vom Status 7 Tage lang in Fleet Engine aktiv. Danach werden sie entfernt. |
Ablauf der Fahrt
Das folgende Diagramm zeigt eine detailliertere Ansicht dieses Ablaufs.
