Consumer SDK – On-Demand-Fahrten – Übersicht

Passen Sie die Nutzererfahrung für On-Demand-Fahrten an, indem Sie Nutzern die Möglichkeit geben, den Verlauf einer Bestellung, Fahrt oder eines anderen von Ihnen angebotenen Dienstes zu verfolgen.

Nutzer-App nach einer Fahrt

Was ist das Consumer SDK?

Das Consumer SDK ist Teil der Fleet Engine für Fahrten auf Abruf. Es bietet Schnittstellen, mit denen Fahrtdaten modelliert und Fahrten in der Fleet Engine verfolgt werden können. Außerdem bietet es Klassen, mit denen Sie eine umfangreiche, kartografische Anzeige erstellen können, um Fahrten mit Ihren privaten Nutzern zu teilen. Sie binden das Consumer SDK in Ihre App ein und legen die entsprechenden Rollenprofile in Fleet Engine fest, um diese Funktion zu ermöglichen.

Mit den plattformspezifischen APIs des Consumer SDK können Sie die Möglichkeit zum Teilen von Kaufprozessen nativ in Ihre Anwendungen einbinden. Das Consumer SDK ist für die folgenden Plattformen verfügbar:

Vorteile des Consumer SDK

Wenn Sie das Consumer SDK in Ihre On-Demand-Fahrdienste einbinden, können Sie Nutzern eine umfassende Funktion bieten, mit Standortaktualisierungen in Echtzeit und an Straßen ausgerichteten Positionen. Ihre Nutzer sehen die Route des Fahrzeugs als Overlay auf einer Karte, einschließlich der Fortschrittsdetails, anhand derer sie nachvollziehen können, wo sich ihre Fahrt oder ihre Lieferung befindet.

Was kann ich mit dem Consumer SDK tun?

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

  • Passen Sie die Karten-UI an Ihre Brandinganforderungen an.

  • Sie können den aktuellen Standort des Fahrzeugs verfolgen, während es sich auf der Route bewegt. Die Position wird regelmäßig aktualisiert.

  • Die voraussichtliche Ankunftszeit für Abhol- und Abgabeorte anzeigen.

  • Die verbleibende Strecke anzeigen.

  • Live-Verkehrsinformationen auf der Route anzeigen

Funktionsweise des Consumer SDK

Grundsätzlich basiert das Consumer SDK auf folgenden Mechanismen:

  • Sie haben die entsprechenden Fleet Engine-Rollen, damit eine authentifizierte App den mit der Bestellung eines Kunden verknüpften Fahrtenverlauf verfolgen kann.
  • Eine Verknüpfung zwischen dem Nutzer und der Fahrt, die von Ihrem Backend-System bereitgestellt wird.
  • Die SDK-Klassen TripModel und JourneySharingSession, die Fahrtdaten modellieren und Fahrtsitzungen in der Verbraucher-App teilen.

Das Consumer SDK bietet auch andere Schnittstellen und Klassen, mit denen Sie eine umfassende App mit Details wie Verkehrsinformationen, Kartenmarkierungen, geschätzter Ankunftszeit und Routendaten erstellen können.

wie das Consumer SDK funktioniert,

Diese Tabelle zeigt den Ablauf einer Fahrt, gefolgt von einer Nutzer-App.

1 Die Verbraucher-App fordert eine Fahrt an. Ihr Backend-Server erhält eine On-Demand-Fahranfrage und führt folgende Schritte aus:
  • Erstellt eine Fahrt in Fleet Engine.
  • Weist die Fahrt einem Fahrzeug zu.
2 Der Fahrer nimmt den Auftrag an Die Fahrer App erhält die Fahrt-ID und die Fahrtinformationen und der Fahrer nimmt die Fahrt an.
3 Nutzer-App fordert Zugriff an, um der Fahrt zu folgen Die App des Nutzers ruft die Fahrt-ID von Ihrem Backend ab und fordert an, die Fahrt zu verfolgen.
4 Fahrer startet die Fahrt Wenn der Fahrer über die Fahrer-App angibt, dass die Fahrt begonnen hat, benachrichtigt die App Ihren Backend-Server über das Driver SDK. Beispielsweise, wenn der Fahrer das Restaurant verlassen oder zum Abholort fahren wird.
5 Fleet Engine beginnt mit dem Senden von Fahrtinformationen Fleet Engine beginnt, die Fahrt zu erfassen und den Fortschritt mit der Kunden-App zu teilen.
6 Nutzer-App zeigt Informationen zur Fahrt an Die App benachrichtigt den Nutzer und zeigt ihm die Fahrtinformationen an. Die Fahrt wird während des Vorgangs aktualisiert.
7 Die Fahrt wurde abgebrochen oder beendet. Wenn der Fahrer die Fahrt abbricht oder abschließt, deaktiviert die Fahrer-App die Standortermittlung und Ihr Backend-Server weist Fleet Engine an, die Fahrt als abgebrochen oder abgeschlossen zu markieren.
8 Die Fahrt wird in der Kunden-App nicht mehr verfolgt Die Fahrt wird als abgebrochen 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 sehen, wie Sie Reisen in Ihren Nutzer-Apps verfolgen können.

Android

1 Consumer SDK in Android einrichten Wenn Sie Fahrten auf Abruf in Ihrer App verfolgen möchten, richten Sie das Consumer SDK ein. Weitere Informationen finden Sie unter Android Consumer SDK herunterladen.
2 Visuelle Benutzeroberfläche einrichten Definieren Sie eine Karte und fügen Sie die Unterstützung für Vektorkarten hinzu, um die Nutzererfahrung einzurichten. Weitere Informationen finden Sie unter Karte einrichten.
3 Reise folgen Folgen Sie einer Fahrt, um dem Kunden den Standort des entsprechenden Fahrzeugs mitzuteilen. Weitere Informationen finden Sie unter Reisen folgen.
5 Fortschritt der Fahrt aktualisieren und Fahrtfehler behandeln Sie können Details zu Ihren Fahrten wie die zurückgelegte Strecke und die geschätzte Ankunftszeit aktualisieren und Fehler während einer Fahrt beheben. Weitere Informationen finden Sie unter Fortschritt der Fahrt aktualisieren und Fehler bei Fahrten beheben.
5 Nach Ende einer Fahrt die Fahrt nicht mehr verfolgen Wenn Sie einer Fahrt nicht mehr folgen möchten, wird der Standort des Fahrzeugs nicht mehr mit Ihrem Kunden geteilt. Weitere Informationen finden Sie unter Die Fahrten-Funktion deaktivieren.

iOS

1 Consumer SDK in iOS einrichten Wenn Sie Fahrten auf Abruf in Ihrer App verfolgen möchten, richten Sie das Consumer SDK ein. Weitere Informationen finden Sie unter iOS-Consumer SDK herunterladen.
2 Visuelle Benutzeroberfläche einrichten Initialisieren Sie die Kartenansicht und verarbeiten Sie Kartenereignisse, um die Nutzerfreundlichkeit zu optimieren. Weitere Informationen finden Sie unter Karte einrichten.
3 Reise folgen Folgen Sie einer Fahrt, um dem Kunden den Standort des entsprechenden Fahrzeugs mitzuteilen. Weitere Informationen finden Sie unter Eine Fahrt verfolgen.
5 Fortschritt der Fahrt aktualisieren und Fahrtfehler behandeln Sie können Details zu Ihren Fahrten wie die zurückgelegte Strecke und die geschätzte Ankunftszeit aktualisieren und Fehler während einer Fahrt beheben. Weitere Informationen finden Sie unter Fahrtfortschritt aktualisieren und Fahrtfehler beheben.
5 Nach Ende einer Fahrt die Fahrt nicht mehr verfolgen Wenn Sie einer Fahrt nicht mehr folgen möchten, wird der Standort des Fahrzeugs nicht mehr mit Ihrem Kunden geteilt. Weitere Informationen finden Sie unter Fahrt nicht mehr folgen.

JavaScript

1 Consumer SDK in JavaScript einrichten Wenn Sie Fahrten auf Abruf 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 Nutzeroberfläche einzurichten. Weitere Informationen finden Sie unter Karte einrichten.
3 Reise folgen Folgen Sie einer Fahrt, um dem Kunden den Standort des entsprechenden Fahrzeugs mitzuteilen. Weitere Informationen finden Sie unter Reisen folgen.
5 Fahrfortschritt aktualisieren und Fahrtfehler beheben Aktualisieren Sie die Details Ihrer Fahrten, z. B. die Fahrstrecke und die voraussichtliche Ankunftszeit, und beheben Sie Fehler bei einer Fahrt. Weitere Informationen finden Sie unter Fahrtfortschritt aktualisieren und verfolgen und Fahrtfehler behandeln.
5 Nach Ende einer Fahrt die Fahrt nicht mehr verfolgen Wenn Sie die Fahrt nicht mehr verfolgen, wird der Standort des Fahrzeugs nicht mehr mit dem Kunden geteilt. Weitere Informationen finden Sie unter Die Fahrten-Funktion deaktivieren.

Komponenten

In diesem Abschnitt werden zwei erforderliche Komponenten für die Verfolgung einer Fahrt zusammengefasst:

Optional kannst du das Kundenerlebnis auch mit diesen Komponenten anpassen:

Abruf von Authentifizierungstokens

So steuern Sie den Zugriff auf die in Fleet Engine gespeicherten Standortdaten:

  1. Implementieren Sie einen JWT-Erstellungsdienst (JSON Web Token) für Fleet Engine auf Ihrem Server. Weitere Informationen finden Sie unter JWTs ausstellen.

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

Kartenansicht und Fahrten-Tracker

Die Verfolgung einer Fahrt umfasst Komponenten zur Visualisierung von Fahrzeugen und Wegpunkten sowie Rohdatenfeeds für die geschätzte Ankunftszeit eines Fahrers oder die verbleibende Strecke.

In der folgenden Tabelle werden diese Komponenten beschrieben:

Komponente Beschreibung
Kartenansicht für Verbraucher In der Kartenansicht wird der Lebenszyklus einer Fahrt verwaltet. Dabei werden Wegpunkte für den Standort der Fahrzeuge im Verlauf der Fahrt angezeigt. Wenn die Route für ein Fahrzeug bekannt ist, wird in der Kartenansicht der Polylinie der Fahrzeugroute aktualisiert, um den Fortschritt des Fahrzeugs auf der Route anzuzeigen.
Anbieter von Reisezielen in JavaScript Bei JavaScript-Webanwendungen sendet der Anbieter von Fahrtinformationen Standortinformationen für getrackte Objekte an die freigegebene Fahrtenkarte. Weitere Informationen finden Sie unter Anbieter für Standorte von Fahrten erstellen. Mit dem Standortanbieter können Sie die folgenden Details zu einer Fahrt verfolgen:
  • Der Start- oder Zielort einer Fahrt.
  • Der Standort und die Route des dem Fahrtauftrag zugewiesenen Fahrzeugs.

Beobachtete Standortobjekte

Der Standortanbieter erfasst die Position von Objekten wie Wegpunkten und Fahrzeugen, die in der folgenden Tabelle beschrieben werden.

Erfasster Standort Beschreibung
Abholort Der Abholort ist der Ort, an dem eine Fahrt beginnt.
Zielspeicherort Der Zielort ist der Ort, an dem eine Fahrt endet. Er kennzeichnet den Abholort.
Wegpunktstandort Ein Wegpunkt ist ein beliebiger Zwischenstopp auf der Route einer verfolgten Fahrt. Technisch gesprochen können Wegpunkte Start- und Zielhaltestellen umfassen. Wegpunkte beziehen sich in der Regel jedoch auf Zwischenstopps auf der Route. Beispielsweise sind die Haltestellen zwischen dem Abhol- und dem Zielort auf einer Lieferroute Wegpunktorte. 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 mit einem Stil versehen

Mit Markierungs- und Polylinienstilen wird festgelegt, wie die aufgezeichneten Standortobjekte auf der Karte dargestellt werden. Mit benutzerdefinierten Stiloptionen können Sie den Stil Ihrer Webanwendung anpassen.

Sichtbarkeit beobachteter Standorte festlegen

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

  • Fahrzeuge sind nur sichtbar, wenn die Fahrt in der Schwebe ist: Ein Fahrtfahrzeug ist von der Zeit der Zuweisung zu einer Fahrt bis zur Zeit der Abfahrt sichtbar. Wenn die Fahrt storniert wird, ist das Fahrzeug nicht mehr sichtbar.

  • Alle anderen Standortmarkierungen sind immer sichtbar: Alle anderen Standortmarkierungen für Start- und Zielort sowie Wegpunkte werden immer auf der Karte angezeigt. So wird beispielsweise der Abhol- oder Lieferort einer Fahrt immer auf der Karte angezeigt, unabhängig vom Status der Fahrt oder Lieferung.

Nächste Schritte

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