In der Dokumentation in diesem Abschnitt wird beschrieben, wie Sie mit dem Google Maps Mobility On-Demand-Fahrtdienst Fahrten 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 Fahrtanfrage von Ihren Nutzern modelliert. Eine Fahrt hat einen Status, den Sie im Verlauf der Fahrt an Fleet Engine melden, z. B. NEW oder ENROUTE_TO_PICKUP. Der Fahrtstatus entspricht den dem Fahrzeug zugewiesenen Wegpunkten mit Standortbestimmung. Die Fleet Engine ändert diese Wegpunkte bei jeder Aktualisierung der Fahrt. Weitere Informationen zu Fahrten und ihrer Beziehung zu Fahrzeugen finden Sie unter On-Demand-Fahrten in Grundlagen der Fleet Engine.
Ablauf einer Fahrt
Damit Sie jede Fahrt in Fleet Engine verfolgen können, 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 die Lebenszyklusphasen in Fleet Engine beschrieben. Es wird davon ausgegangen, dass Sie die 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: 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.
An dieser Stelle können auch andere Felder festgelegt werden, z. B. Fahrgäste und Zielort, oder es kann gewartet werden, bis ein Fahrzeug zugewiesen wird. Weitere Informationen finden Sie unter Fahrt mit 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 den Dienst Fahrzeug suchen verwenden, um nach Fahrzeugen zu suchen. Dabei können Sie sowohl nach Fahrten- als auch nach Fahrzeugattributen filtern, um das beste Fahrzeug für die Fahrt zu finden. Alle Online-Fahrzeuge in Ihrem Suchradius geben ihre Nähe über Standortaktualisierungen bekannt, die vom Driver SDK bereitgestellt werden. Sobald |
| 3 | Fahrt aktualisieren | Sobald der Fahrer die Fahrt akzeptiert und mit der Navigation zum Abholort beginnt, aktualisiert Ihr System den Fahrtstatus von NEW auf 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 Fahrzeugstandort-Updates vom Driver SDK erhält. Ihr System meldet dann jeden Meilenstein der Fahrt an die Fleet Engine, die die Wegpunktliste des Fahrzeugs entsprechend aktualisiert.
|
| 4 | Teilen Sie die Reise mit dem Verbraucher. | Die Fleet Engine stellt dem Consumer SDK Fahrtdetails und den Fahrzeugstandort zur Verfügung. Das Consumer 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 Zielwegpunkt der Fahrt erreicht hat und der Fahrer die Fahrt als erfolgreich abgeschlossen meldet, setzt Ihr System den TripStatus in der Fleet Engine auf COMPLETE. Beachten Sie, dass Fahrtenentitäten wie Fahrzeuge unabhängig vom Status sieben Tage lang in Fleet Engine aktiv bleiben und dann entfernt werden. |
Ablauf der Fahrtsequenz
Das folgende Diagramm zeigt eine detailliertere Ansicht dieses Ablaufs.
