In der Dokumentation in diesem Abschnitt wird beschrieben, wie Sie mit dem Google Maps Mobility-Dienst für On-Demand-Fahrten Fahrten erstellen und verwenden. Dabei wird vorausgesetzt, dass Sie mit Folgendem vertraut sind:
- Fleet Engine: Sie sollten mit den Implementierungs details, den Anfragemethoden und der Sicherheit 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.
Der TripService den Sie verwenden, ist für gRPC und REST verfügbar.
Der Einfachheit halber folgen die Feldverweise der gRPC-Konvention.
In Fleet Engine für On-Demand-Dienste ist eine Fahrt eine Art Reise, die die Ausführung einer Essenslieferung oder einer Fahrtanfrage von Ihren Kunden modelliert. Eine Fahrt hat einen Status, den Sie Fleet Engine im Laufe der Reise mitteilen, 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 zu Fleet
Engine.
Lebenszyklus einer Fahrt
Um jede Fahrt in Fleet Engine zu verfolgen, müssen Sie zuerst eine Trip-Entität erstellen. Eine Referenz 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 die Lebenszyklusphasen in Fleet Engine beschrieben. Dabei wird davon ausgegangen, dass Sie Fleet Engine eingerichtet haben und ein Fahrzeug für die Fahrt zuweisen können und dass 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 den erforderlichen Feldern, z. B. dem Abholort.
An dieser Stelle können auch andere Felder festgelegt werden, z. B. Fahrgäste und
Zielort, oder Sie können 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 „Fahrzeug suchen“ verwenden, um nach Fahrzeugen zu suchen und sowohl nach Fahrt- als auch nach Fahrzeugattributen zu filtern, um das beste Fahrzeug für die Fahrt zu finden. Jedes Onlinefahrzeug innerhalb Ihres Suchradius gibt seine Nähe über Standortaktualisierungen bekannt, die vom Driver SDK bereitgestellt werden. Sobald |
| 3 | Fahrt aktualisieren | Sobald der Fahrer die Fahrt annimmt und zum
Abholort navigiert, aktualisiert Ihr System den Fahrtstatus von NEW
zu ENROUTE_TO_PICKUP. Sie fragen den Fahrzeug
standort während der gesamten Fahrt ab, entweder über eine direkte Verbindung von
der App zu Ihrem Back-End oder durch Abfragen von Fleet Engine, das einen
kontinuierlichen Stream von Fahrzeugstandortaktualisierungen vom Driver SDK erhält. Ihr
System meldet dann jeden Meilenstein der Fahrt an Fleet Engine, das die Wegpunktliste des Fahrzeugs entsprechend aktualisiert.
|
| 4 | Fahrt für Kunden freigeben | 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 Kunden-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 Zielwegpunkt der Fahrt erreicht und Ihr
Fahrer eine erfolgreiche Fahrt meldet, legt Ihr System die
TripStatus auf COMPLETE in Fleet Engine fest. Wie bei Fahrzeugen bleiben auch Fahrtentitäten unabhängig vom Status 7 Tage lang in Fleet Engine aktiv. Danach werden sie entfernt. |
Ablauf der Fahrtsequenz
Das folgende Diagramm zeigt eine detailliertere Ansicht dieses Ablaufs.
