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:
- Fleet Engine: Sie sollten mit den Implementierungsdetails, den Anfragemechanismen 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 zu Fahrten auf Abruf
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 Prozess, bei dem die Ausführung einer Essens- oder Fahrtanfrage von Ihren Kunden modelliert wird. Ein Fahrtenauftrag hat einen Status, den Sie während der Fahrt an Fleet Engine senden, 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 im Hilfeartikel Fleet Engine-Grundlagen.
Reise
Damit Sie jede Fahrt in Fleet Engine verfolgen können, müssen Sie zuerst eine Trip-Entität erstellen. Siehe entweder gRPC oder REST als Referenz.
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 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. Das System erstellt dann die Fahrtentität mithilfe von CreateTrip mit Pflichtfeldern, z. B. 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 Reisen mit einem einzelnen Ziel erstellen. |
| 2 | Fahrzeug zuweisen | Sie können Fahrten entweder direkt in Ihrem System zuweisen und die Zuweisung an Fleet Engine melden. Alternativ haben Sie die Möglichkeit, mit dem Dienst Fahrzeugsuche nach Fahrzeugen zu suchen und sowohl nach Fahrt- als auch nach Fahrzeugattributen zu 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 |
| 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 Wegmeilenstein an Fleet Engine, das 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 On-Demand-Fahrten teilen. |
| 5 | Vollständige Fahrt | Sobald das Fahrzeug den Wegpunkt der Fahrt erreicht hat und Ihr Fahrer eine erfolgreiche Fahrt anzeigt, wird TripStatus in Fleet Engine auf COMPLETE gesetzt. Beachten Sie, dass Fahrtentitäten wie Fahrzeuge unabhängig vom Status sieben Tage lang in Fleet Engine aktiv bleiben. Danach werden sie entfernt. |
Ablauf der Fahrtsequenz
Das folgende Diagramm zeigt eine detailliertere Ansicht dieses Ablaufs.
