Sie können die Nutzererfahrung für On-Demand-Fahrten anpassen, indem Sie Nutzern die Möglichkeit geben, den Verlauf einer Bestellung, Fahrt oder eines anderen von Ihnen angebotenen Dienstes zu verfolgen.
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 können das Consumer SDK in Ihre App einbinden und die entsprechenden Rollenprofile in Fleet Engine festlegen, 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:
Warum sollte ich das Consumer SDK verwenden?
Wenn Sie das Consumer SDK in Ihre Anwendungen für On-Demand-Fahrten einbinden, können Sie eine umfassende Nutzererfahrung mit Standortaktualisierungen in nahezu Echtzeit und an Straßen angepassten Positionen bieten. Ihre Nutzer können die Route des Fahrzeugs auf einer Karte sehen, einschließlich Details zum Fortschritt, die ihnen helfen, zu verstehen, wo sich ihre Fahrt oder Lieferung befindet.
Was kann ich mit dem Consumer SDK tun?
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, 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
TripModelundJourneySharingSession, die Fahrtdaten modellieren und Fahrtsitzungen in der Consumer-App teilen.
Das Consumer SDK bietet auch andere Schnittstellen und Klassen, mit denen Sie eine ansprechende App-Erfahrung mit Details wie Verkehrslage, 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 Back-End-Server erhält eine Anfrage für eine On-Demand-Fahrt und führt folgende Schritte aus:
|
| 2 | Fahrer nimmt die Fahrt an | Die Fahrer-App erhält die Fahrt-ID und die Fahrtinformationen und der Fahrer nimmt die Fahrt an. |
| 3 | Consumer-App fordert Zugriff an, um die Fahrt zu verfolgen | Die Consumer-App erhält die Fahrt-ID von Ihrem Back-End 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 Back-End-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, die Fahrer-App deaktiviert das Standorttracking und Ihr Back-End-Server weist Fleet Engine an, die Fahrt als storniert oder abgeschlossen zu markieren. |
| 8 | Consumer-App beendet das Verfolgen der Fahrt | 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.
Android
| 1 | Consumer SDK in Android einrichten | Wenn Sie On-Demand-Fahrten in Ihrer App verfolgen möchten, richten Sie das Consumer SDK ein. Weitere Informationen finden Sie unter Android Consumer SDK abrufen. |
| 2 | Visuelle Oberfläche einrichten | Definieren Sie eine Karte und fügen Sie Unterstützung für Vektorkarten hinzu, um die Nutzererfahrung einzurichten. Weitere Informationen finden Sie unter Karte einrichten. |
| 3 | Fahrt verfolgen | Verfolgen Sie eine Fahrt, um den Standort des entsprechenden Fahrzeugs für Ihren Nutzer freizugeben. Weitere Informationen finden Sie unter Fahrt verfolgen. |
| 5 | Fahrtfortschritt aktualisieren und Fehler bei Fahrten beheben | Aktualisieren Sie Details zu Ihren Fahrten, z. B. die Entfernung und die voraussichtliche Ankunftszeit, und beheben Sie Fehler während einer Fahrt. Weitere Informationen finden Sie unter Fahrtfortschritt aktualisieren und Fehler bei Fahrten beheben. |
| 5 | Nach Abschluss einer Fahrt das Verfolgen beenden | Beenden Sie das Verfolgen einer Fahrt, um den Standort eines Fahrzeugs nicht mehr für Ihren Nutzer freizugeben. Weitere Informationen finden Sie unter Verfolgen einer Fahrt beenden. |
iOS
| 1 | Consumer SDK in iOS einrichten | Wenn Sie On-Demand-Fahrten in Ihrer App verfolgen möchten, richten Sie das Consumer SDK ein. Weitere Informationen finden Sie unter iOS Consumer SDK abrufen. |
| 2 | Visuelle Oberfläche einrichten | Initialisieren Sie die Kartenansicht und verarbeiten Sie Kartenereignisse, um die Nutzererfahrung einzurichten. Weitere Informationen finden Sie unter Karte einrichten. |
| 3 | Fahrt verfolgen | Verfolgen Sie eine Fahrt, um den Standort des entsprechenden Fahrzeugs für Ihren Nutzer freizugeben. Weitere Informationen finden Sie unter Fahrt verfolgen. |
| 5 | Fahrtfortschritt aktualisieren und Fehler bei Fahrten beheben | Aktualisieren Sie Details zu Ihren Fahrten, z. B. die Entfernung und die voraussichtliche Ankunftszeit, und beheben Sie Fehler während einer Fahrt. Weitere Informationen finden Sie unter Fahrtfortschritt aktualisieren und Fehler bei Fahrten beheben. |
| 5 | Nach Abschluss einer Fahrt das Verfolgen beenden | Beenden Sie das Verfolgen einer Fahrt, um den Standort eines Fahrzeugs nicht mehr für Ihren Nutzer freizugeben. Weitere Informationen finden Sie unter Verfolgen einer Fahrt beenden. |
JavaScript
| 1 | Consumer SDK in JavaScript einrichten | Wenn Sie On-Demand-Fahrten in Ihrer App verfolgen möchten, richten Sie das Consumer SDK ein. Weitere Informationen finden Sie unter JavaScript Consumer SDK einrichten. |
| 2 | Karte laden und anpassen | Aktivieren Sie die Maps JavaScript API und richten Sie die Autorisierung ein, um die Nutzererfahrung einzurichten. Weitere Informationen finden Sie unter Karte einrichten. |
| 3 | Fahrt verfolgen | Verfolgen Sie eine Fahrt, um den Standort des entsprechenden Fahrzeugs für Ihren Nutzer freizugeben. Weitere Informationen finden Sie unter Fahrt verfolgen. |
| 5 | Fahrtfortschritt aktualisieren und Fehler bei Fahrten beheben | Aktualisieren Sie Details zu Ihren Fahrten, z. B. die Entfernung und die voraussichtliche Ankunftszeit, und beheben Sie Fehler bei einer Fahrt. Weitere Informationen finden Sie unter Fahrtfortschritt aktualisieren und verfolgen und Fehler bei Fahrten beheben. |
| 5 | Nach Abschluss einer Fahrt das Verfolgen beenden | Beenden Sie das Verfolgen einer Fahrt, um den Standort eines Fahrzeugs nicht mehr für Ihren Nutzer freizugeben. Weitere Informationen finden Sie unter Verfolgen einer Fahrt beenden. |
Komponenten
In diesem Abschnitt werden zwei erforderliche Komponenten zum Verfolgen einer Fahrt zusammengefasst:
Optional können Sie die Nutzererfahrung auch mit diesen Komponenten anpassen:
Abrufer von Authentifizierungstokens
Um den Zugriff auf die in Fleet Engine gespeicherten Standortdaten zu steuern, müssen Sie Folgendes tun:
Implementieren Sie auf Ihrem Server einen Dienst zur Erstellung von JSON-Webtokens (JWTs) für Fleet Engine. Weitere Informationen finden Sie unter JWTs ausstellen.
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 im Laufe der Fahrt angezeigt. 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 liefert der Anbieter von Fahrtstandorten Standortinformationen für verfolgte Objekte in die Karte der geteilten Fahrt. 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:
|
Objekte mit verfolgten Standorten
Der Standortanbieter verfolgt den Standort von Objekten wie Wegpunkten und Fahrzeugen, die in der folgenden Tabelle beschrieben werden.
| Verfolgter Standort | 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 Zielort. |
| Wegpunkt | Ein Wegpunkt ist ein beliebiger Zwischenort auf der Route einer verfolgten Fahrt. Technisch gesehen können Wegpunkte Abhol- und Zielorte 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
Mit Markierungs- und Polylinienstilen wird das Erscheinungsbild der Objekte mit verfolgten Standorten auf der Karte festgelegt. Sie können benutzerdefinierte Stile verwenden, die zum Stil Ihrer Webanwendung passen.
Sichtbarkeit von verfolgten Orten steuern
Die vordefinierten Standortanbieter in Fleet Engine folgen diesen Sichtbarkeitsregeln für Objekte mit verfolgten Standorten 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 bis zum Zielort sichtbar. Wenn die Fahrt storniert wird, ist das Fahrzeug nicht mehr sichtbar.
Alle anderen Standortmarkierungen sind immer sichtbar: Alle anderen Standort markierungen für Ausgangspunkt, Zielort und Wegpunkte werden immer auf der Karte angezeigt. Beispielsweise wird ein Zielort 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: