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.

Verbraucher-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 für Ihre Nutzer zu teilen. Sie binden das Consumer SDK in Ihre App ein und legen die entsprechenden Rollenprofile in Fleet Engine fest, um diese Funktion für Nutzer zu erstellen.

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 Kunden können die Route des Fahrzeugs auf einer Karte sehen, einschließlich Fortschrittsdetails, anhand derer sie nachvollziehen können, wo sich ihr Fahrtenservice 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

Das Consumer SDK basiert auf den 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.

Funktionsweise des Consumer SDK

Diese Tabelle zeigt den Ablauf einer Fahrt, gefolgt von einer Verbraucher-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.
  • Die Fahrt wird einem Fahrzeug zugewiesen.
2 Der Fahrer nimmt den Fahrtauftrag an Die Fahrer App erhält die Fahrt-ID und die Fahrtinformationen und der Fahrer nimmt die Fahrt an.
3 Verbraucher-App fordert Zugriff an, um den Weg zu verfolgen Die App des Nutzers ruft die Fahrt-ID von Ihrem Backend ab und fordert an, die Fahrt zu verfolgen.
4 Der 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 Die Informationen zur Fahrt werden in der Kunden-App angezeigt. Die App benachrichtigt den Nutzer und zeigt ihm die Fahrtinformationen an, die im Laufe der Fahrt aktualisiert werden.
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 Es wird eine neue Fahrt erstellt und der Vorgang wiederholt sich.

Consumer SDK verwenden

Wählen Sie Ihre Plattform aus, um zu erfahren, wie Sie Fahrten in Ihren Verbraucher-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 Fahrt verfolgen 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 Fortschritt der Fahrt aktualisieren und Fehler bei Fahrten beheben.
5 Nach Ende einer Fahrt die Fahrt nicht mehr verfolgen Wenn Sie einem Fahrt nicht mehr folgen, wird der Standort des Fahrzeugs nicht mehr mit dem Kunden geteilt. Weitere Informationen finden Sie unter Die Verfolgung einer Fahrt beenden.

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 Nutzeroberfläche einzurichten. Weitere Informationen finden Sie unter Karte einrichten.
3 Fahrt verfolgen 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 Fortschritt der Fahrt aktualisieren und Fehler bei Fahrten beheben.
5 Nach Ende einer Fahrt die Fahrt nicht mehr verfolgen Wenn Sie einem Fahrt nicht mehr folgen, wird der Standort des Fahrzeugs nicht mehr mit dem Kunden geteilt. Weitere Informationen finden Sie unter Die Verfolgung einer Fahrt beenden.

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 Fahrt verfolgen 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 aktualisieren, z. B. die zurückgelegte Strecke und die geschätzte Ankunftszeit, und Fehler bei einer Fahrt beheben. Weitere Informationen finden Sie unter Fortschritt der Fahrt aktualisieren und verfolgen und Fehler bei Fahrten beheben.
5 Nach Ende einer Fahrt die Fahrt nicht mehr verfolgen Wenn Sie einem Fahrt nicht mehr folgen, wird der Standort des Fahrzeugs nicht mehr mit dem Kunden geteilt. Weitere Informationen finden Sie unter Die Verfolgung einer Fahrt beenden.

Komponenten

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

Optional können Sie die Nutzung auch mit den folgenden Komponenten anpassen:

Authentifizierungstoken-Abruf

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

  1. Implementieren Sie einen Dienst zum Erstellen von JSON Web Tokens (JWT) für die Fleet Engine auf Ihrem Server. Weitere Informationen finden Sie unter JWTs ausstellen.

  2. Implementieren Sie in Ihren Web- oder mobilen Apps einen Abrufmechanismus für Authentifizierungstokens, 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 während der Fahrt angezeigt. Wenn die Route für ein Fahrzeug bekannt ist, wird in der Kartenansicht der Polyline der Fahrzeugroute aktualisiert, um den Fortschritt des Fahrzeugs auf der Route anzuzeigen.
Anbieter von Fahrtorten 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 Anbieter für den Standort der Fahrt können Sie die folgenden Details für eine Fahrt erfassen:
  • Der Abhol- oder Abgabeort 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.

Gespeicherter 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 aufgezeichneten Fahrt. Technisch gesehen können Wegpunkte auch Abhol- und Abgabeorte umfassen, beziehen sich aber in der Regel auf Zwischenstopps entlang 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 der besuchten Orte steuern

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 dem Moment an sichtbar, in dem es einer Fahrt zugewiesen wird, bis zur Abfahrt. 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: