Consumer SDK – On-Demand-Fahrten – Übersicht

Passen Sie die Nutzererfahrung für On-Demand-Fahrten an, indem Sie Nutzern die Möglichkeit geben, den Fortschritt einer Bestellung, Fahrt oder anderen Dienstleistung zu verfolgen, die Sie ihnen anbieten.

Was ist das Consumer SDK?

Das Consumer SDK ist Teil von Fleet Engine für On-Demand-Fahrten. Es bietet Schnittstellen, mit denen Sie Fahrtdaten modellieren und Fahrten in Fleet Engine verfolgen können. Außerdem enthält es Klassen, mit denen Sie eine ansprechende, kartenbasierte Darstellung erstellen können, um Fahrten mit Ihren Nutzern zu teilen. Sie binden das Consumer SDK in Ihre App ein und legen die entsprechenden Rollenprofile in Fleet Engine fest, um diese Nutzererfahrung zu ermöglichen.

Mit den plattformspezifischen APIs des Consumer SDK können Sie die Möglichkeit, Fahrten zu teilen, nativ in Ihre Anwendungen einbauen. Das Consumer SDK ist für die folgenden Plattformen verfügbar:

• Android
• iOS
• JavaScript

Warum das Consumer SDK verwenden?

Wenn Sie das Consumer SDK in Ihre Anwendungen für On-Demand-Fahrten einbinden, können Sie Nutzern eine umfassende Erfahrung bieten, mit Standortaktualisierungen in nahezu Echtzeit und an Straßen ausgerichteten Positionen. Ihre Nutzer können die Route des Fahrzeugs auf einer Karte sehen, einschließlich Details zum Fortschritt, damit sie wissen, wo sich ihre Fahrt oder Lieferung befindet.

Wofür kann das Consumer SDK verwendet werden?

Sie können Informationen aus dem Driver SDK und Fleet Engine verwenden, um benutzerdefinierte Nutzererlebnisse zu erstellen, einschließlich der folgenden Funktionen:

• Passen Sie die UI der Karte an Ihre Branding-Anforderungen an.

• Verfolgen Sie den aktuellen Standort des Fahrzeugs auf der Route. Die Position wird regelmäßig aktualisiert.

• Zeigen Sie die voraussichtliche Ankunftszeit für Abhol- und Zielorte an.

• Zeigen Sie die verbleibende Entfernung an.

• Zeigen Sie die aktuelle Verkehrslage auf der Route an.

Funktionsweise des Consumer SDK

Auf übergeordneter Ebene basiert das Consumer SDK auf den folgenden Mechanismen:

• Die entsprechenden Fleet Engine-Rollen sind erforderlich, damit eine authentifizierte App die Fahrt verfolgen kann, die mit der Bestellung eines Nutzers verknüpft ist.
• Eine Verknüpfung zwischen dem Nutzer und der Fahrt, die von Ihrem Back-End-System bereitgestellt wird.
• Die SDK-Klassen TripModel und JourneySharingSession, die Fahrtdaten modellieren und Fahrtsitzungen in der Consumer-App teilen.

Das Consumer SDK bietet auch andere Schnittstellen und Klassen, mit denen Sie eine ansprechende Nutzerfreundlichkeit der App mit Details wie Verkehrsinformationen, Kartenmarkierungen, voraussichtlicher Ankunftszeit und Routendaten erstellen können.

In dieser Tabelle ist der Ablauf einer Fahrt dargestellt, die von einer Consumer-App verfolgt wird.

1	Consumer-App fordert eine Fahrt an	Ihr Backend-Server erhält eine On-Demand-Fahrtanfrage und führt folgende Schritte aus: Erstellt eine Fahrt in Fleet Engine. Weist die Fahrt einem Fahrzeug zu.
2	Fahrer akzeptiert die Fahrt	Die Fahrer-App erhält die Fahrt-ID und die Fahrtinformationen und der Fahrer akzeptiert die Fahrt.
3	Consumer-App fordert Zugriff an, um die Fahrt zu verfolgen	Die Consumer-App ruft die Fahrt-ID von Ihrem Back-End ab und fordert an, die Fahrt zu verfolgen.
4	Fahrer beginnt die Fahrt	Wenn der Fahrer in der Fahrer-App angibt, dass die Fahrt begonnen hat, benachrichtigt die App Ihren Backend-Server über das Driver SDK. Zum Beispiel, wenn der Fahrer im Begriff ist, das Restaurant zu verlassen oder zum Abholort zu fahren.
5	Fleet Engine beginnt mit dem Senden von Fahrtinformationen	Fleet Engine beginnt mit dem Tracking der Fahrt und teilt den Fortschritt mit der Consumer-App.
6	Consumer-App zeigt die Fahrtinformationen an	Die Consumer-App benachrichtigt den Nutzer und zeigt ihm die Fahrtinformationen an. Die Fahrt wird im Laufe der Fahrt aktualisiert.
7	Fahrt wird storniert oder abgeschlossen	Wenn der Fahrer die Fahrt storniert oder abschließt, deaktiviert die Fahrer-App das Standort-Tracking und Ihr Backend-Server weist Fleet Engine an, die Fahrt als storniert oder abgeschlossen zu markieren.
8	Consumer-App verfolgt die Fahrt nicht mehr	Die Fahrt wird als storniert oder abgeschlossen angezeigt.
9	Der Vorgang wird für die nächste Fahrt wiederholt	Eine neue Fahrt wird erstellt und der Vorgang wird wiederholt.

Consumer SDK verwenden

Wählen Sie Ihre Plattform aus, um zu erfahren, wie Sie Fahrten in Ihren Consumer-Apps verfolgen können.

Komponenten

In diesem Abschnitt werden zwei erforderliche Komponenten zum Verfolgen einer Fahrt zusammengefasst:

• Abrufer von Authentifizierungstokens.
• Kartenansicht und Fahrt-Tracker.

Optional können Sie die Nutzererfahrung auch mit diesen Komponenten anpassen:

• Karten gestalten.
• Sichtbarkeit von verfolgten Orten steuern.

Abrufer von Authentifizierungstokens

Um den Zugriff auf die in Fleet Engine gespeicherten Standortdaten zu steuern, müssen Sie Folgendes tun:

1. Implementieren Sie auf Ihrem Server einen Dienst zur Erstellung von JSON-Webtokens (JWTs) für Fleet Engine. Weitere Informationen finden Sie unter JWTs ausstellen.

2. Implementieren Sie in Ihren Web- oder mobilen Apps einen Abrufer von Authentifizierungstokens, um den Zugriff auf die Standortdaten zu authentifizieren. Weitere Informationen zum Einrichten eines Token-Abrufers finden Sie in der Einrichtungsanleitung für Android, iOS oder JavaScript.

Kartenansicht und Fahrt-Tracker

Das Verfolgen einer Fahrt umfasst Komponenten zur Visualisierung von Fahrzeugen und Wegpunkten sowie Rohdatenfeeds für die voraussichtliche Ankunftszeit eines Fahrers oder die verbleibende Entfernung.

In der folgenden Tabelle werden diese Komponenten beschrieben:

Komponente	Beschreibung
Kartenansicht für Nutzer	In der Kartenansicht wird der Lebenszyklus einer Fahrt verwaltet. Dabei werden Wegpunkte für den Standort von Fahrzeugen angezeigt, während die Fahrt fortschreitet. Wenn die Route für ein Fahrzeug bekannt ist, wird in der Kartenansicht die Polylinie der Fahrzeugroute aktualisiert, um den Fortschritt des Fahrzeugs auf der Route anzugeben.
Anbieter von Fahrtstandorten in JavaScript	Für JavaScript-Web-Apps werden Standortinformationen für verfolgte Objekte vom Anbieter von Fahrtstandorten in die gemeinsame Fahrtkarte eingespeist. Weitere Informationen finden Sie unter Anbieter von Fahrtstandorten instanziieren. Mit dem Anbieter von Fahrtstandorten können Sie die folgenden Details für eine Fahrt verfolgen: Der Abhol- oder Zielort einer Fahrt. Der Standort und die Route des Fahrzeugs, das der Fahrt zugewiesen ist.

Objekte für verfolgte Orte

Der Standortanbieter verfolgt den Standort von Objekten wie Wegpunkten und Fahrzeugen, die in der folgenden Tabelle beschrieben werden.

Verfolgter Ort	Beschreibung
Abholort	Der Abholort ist der Ort, an dem eine Fahrt beginnt.
Zielort	Der Zielort ist der Ort, an dem eine Fahrt endet. Er markiert den Absetzort.
Wegpunkt	Ein Wegpunkt ist ein beliebiger Zwischenort auf der Route einer verfolgten Fahrt. Technisch gesehen können Wegpunkte zwar Abhol- und Absetzorte umfassen, aber in der Regel beziehen sie sich auf Zwischenstopps auf der Route. Die Stopps zwischen dem Abholort und dem Zielort auf einer Lieferroute sind beispielsweise Wegpunkte. Weitere Informationen finden Sie in der Fleet Engine-Dokumentation unter Wegpunkte für Fahrten.
Fahrzeugstandort	Der Fahrzeugstandort ist der gemeldete Standort eines Fahrzeugs. Weitere Informationen finden Sie in der Fleet Engine-Dokumentation unter Fahrzeugstandort.

Karten gestalten

Die Stile für Markierungen und Polylinien bestimmen das Aussehen der Objekte für verfolgte Orte auf der Karte. Sie können benutzerdefinierte Gestaltungsoptionen verwenden, um den Stil Ihrer Webanwendung anzupassen.

Sichtbarkeit von verfolgten Orten steuern

Die vordefinierten Standortanbieter in Fleet Engine folgen diesen Sichtbarkeitsregeln für Objekte für verfolgte Orte auf der Karte. Wenn Sie einen benutzerdefinierten oder abgeleiteten Standortanbieter erstellen, können Sie die Sichtbarkeitsregeln ändern.

• Fahrzeuge sind nur sichtbar, wenn die Fahrt läuft: Ein Fahrzeug für eine Fahrt ist ab dem Zeitpunkt der Zuweisung zu einer Fahrt bis zum Absetzen sichtbar. Wenn die Fahrt storniert wird, ist das Fahrzeug nicht mehr sichtbar.

• Alle anderen Ortsmarkierungen sind immer sichtbar: Alle anderen Ortsmarkierungen für Ausgangsort, Zielort und Wegpunkte werden immer auf der Karte angezeigt. Beispielsweise wird ein Absetzort für eine Fahrt oder ein Lieferort für eine Sendung immer auf der Karte angezeigt, unabhängig vom Status der Fahrt oder Lieferung.

Nächste Schritte

Weitere Informationen finden Sie in der Dokumentation für die Plattform, auf der Sie Fahrten verfolgen möchten:

• Android
• iOS
• JavaScript