Consumer SDK – On-Demand-Fahrten – Übersicht

Sie können die Nutzererfahrung für On-Demand-Fahrten anpassen, indem Sie Nutzern die Möglichkeit geben, die Fahrt für eine Bestellung, eine Fahrt oder einen anderen Dienst zu verfolgen, den Sie ihnen anbieten.

Benutzeroberfläche, die einer Fahrt folgt

Was ist das Consumer SDK?

Das Consumer SDK ist Teil der Fleet Engine für On-Demand-Fahrten. Es bietet Schnittstellen, die Fahrtdaten modellieren und Fahrten in der Fleet Engine verfolgen, sowie Klassen, mit denen Sie eine umfassende, kartenbasierte Anzeige 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 schaffen.

Mit den plattformspezifischen APIs des Consumer SDK können Sie die Möglichkeit zur nativen Freigabe von Fahrten 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-Fahrten-Apps einbinden, können Sie Nutzern eine umfassende Nutzererfahrung mit Standortaktualisierungen nahezu in Echtzeit und an Straßen ausgerichteten Positionen bieten. Ihre Kunden können die Route des Fahrzeugs auf einer Karte sehen, einschließlich Fortschrittsdetails, 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 der Fleet Engine verwenden, um personalisierte Nutzererlebnisse zu schaffen, einschließlich der folgenden Funktionen:

  • Passen Sie die Karten-UI an Ihre Branding-Anforderungen an.

  • Sie können den aktuellen Standort des Fahrzeugs auf der Route verfolgen. Die Position wird regelmäßig aktualisiert.

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

  • Zeigt die verbleibende Entfernung an.

  • Aktuelle Verkehrslage auf der Route anzeigen

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 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 App mit vielen Details wie Verkehr, Kartenmarkierungen, voraussichtlicher Ankunftszeit und Routendaten erstellen können.

Funktionsweise des Consumer SDK

In dieser Tabelle wird der Ablauf einer Fahrt in einer Verbraucher-App dargestellt.

1 Fahrt über die Nutzer-App anfordern Ihr Backend-Server erhält eine On-Demand-Fahrtanfrage und führt die folgenden Schritte aus:
  • Erstellt eine Fahrt in Fleet Engine.
  • Weist die Fahrt einem Fahrzeug zu.
2 Fahrer nimmt die Fahrt an Die Fahrer-App erhält die Fahrt-ID und die Fahrtinformationen und der Fahrer akzeptiert die Fahrt.
3 Die Nutzer-App fordert Zugriff an, um die Fahrt zu verfolgen Die Verbraucher-App ruft die Fahrt-ID von Ihrem Backend ab und fordert an, die Fahrt zu verfolgen.
4 Fahrer startet 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. Beispielsweise, wenn der Fahrer das Restaurant verlässt oder zum Abholort fährt.
5 Fleet Engine beginnt mit dem Senden von Fahrtinformationen Die Fleet Engine beginnt mit dem Tracking der Fahrt und teilt den Fortschritt mit der Verbraucher-App.
6 In der Verbraucher-App werden die Fahrtinformationen angezeigt Die Nutzer-App benachrichtigt den Nutzer und zeigt ihm die Fahrtinformationen an. Die Fahrt wird im Verlauf aktualisiert.
7 Fahrt wurde storniert oder abgeschlossen Wenn der Fahrer die Fahrt storniert oder abschließt, wird die Standortverfolgung in der Fahrer-App deaktiviert und Ihr Backend-Server weist die Fleet Engine an, die Fahrt als storniert oder abgeschlossen zu markieren.
8 Die Fahrt wird in der Verbraucher-App nicht mehr verfolgt 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 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 für Android einrichten Wenn Sie On-Demand-Fahrten in Ihrer App verfolgen möchten, müssen Sie das Consumer SDK einrichten. Weitere Informationen finden Sie unter Android Consumer SDK herunterladen.
2 Visuelle Oberfläche einrichten Definieren Sie eine Karte und fügen Sie Unterstützung für Vektorkarten hinzu, um die Nutzerumgebung einzurichten. Weitere Informationen finden Sie unter Karte einrichten.
3 Fahrt verfolgen Sie können eine Fahrt verfolgen, um den Standort des entsprechenden Fahrzeugs mit dem Nutzer zu teilen. Weitere Informationen finden Sie unter Fahrt verfolgen.
5 Fahrtfortschritt aktualisieren und Fehler bei Fahrten beheben Details zu Ihren Fahrten aktualisieren, z. B. die Entfernung und die voraussichtliche Ankunftszeit, und Fehler während einer Fahrt beheben. Weitere Informationen finden Sie unter Fortschritt der Fahrt aktualisieren und Fehler bei Fahrten beheben.
5 Nach Abschluss einer Fahrt nicht mehr folgen Beenden Sie das Verfolgen einer Fahrt, um die Freigabe des Fahrzeugstandorts für Ihren Nutzer zu beenden. Weitere Informationen finden Sie unter Fahrt nicht mehr folgen.

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 Consumer SDK für iOS herunterladen.
2 Visuelle Oberfläche einrichten Initialisieren Sie die Kartenansicht und verarbeiten Sie Kartenereignisse, um die Nutzerumgebung einzurichten. Weitere Informationen finden Sie unter Karte einrichten.
3 Fahrt verfolgen Sie können eine Fahrt verfolgen, um den Standort des entsprechenden Fahrzeugs mit dem Nutzer zu teilen. Weitere Informationen finden Sie unter Fahrt verfolgen.
5 Fahrtfortschritt aktualisieren und Fehler bei Fahrten beheben Details zu Ihren Fahrten aktualisieren, z. B. die Entfernung und die voraussichtliche Ankunftszeit, und Fehler während einer Fahrt beheben. Weitere Informationen finden Sie unter Fortschritt der Fahrt aktualisieren und Fehler bei Fahrten beheben.
5 Nach Abschluss einer Fahrt nicht mehr folgen Beenden Sie das Verfolgen einer Fahrt, um die Freigabe des Fahrzeugstandorts für Ihren Nutzer zu beenden. Weitere Informationen finden Sie unter Fahrt nicht mehr folgen.

JavaScript

1 Consumer SDK in JavaScript einrichten Wenn Sie On-Demand-Fahrten in Ihrer App verfolgen möchten, müssen Sie das Consumer SDK einrichten. 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 Nutzerumgebung zu konfigurieren. Weitere Informationen finden Sie unter Karte einrichten.
3 Fahrt verfolgen Folgen Sie einer Fahrt, um den Standort des entsprechenden Fahrzeugs mit Ihrem Kunden zu teilen. Weitere Informationen finden Sie unter Fahrt verfolgen.
5 Fahrtfortschritt aktualisieren und Fehler bei Fahrten beheben Sie können Details zu Ihren Fahrten aktualisieren, z. B. die Entfernung und die voraussichtliche Ankunftszeit, und Fehler bei einer Fahrt beheben. Weitere Informationen finden Sie unter Fahrtfortschritt aktualisieren und verfolgen und Fahrtfehler beheben.
5 Nach Abschluss einer Fahrt nicht mehr folgen Beenden Sie das Verfolgen einer Fahrt, um die Freigabe des Fahrzeugstandorts für Ihren Nutzer zu beenden. Weitere Informationen finden Sie unter Fahrt nicht mehr folgen.

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 Fleet Engine gespeicherten Standortdaten:

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

  2. Implementieren Sie einen Authentifizierungstoken-Fetcher in Ihren Web- oder mobilen Apps, um den Zugriff auf die Standortdaten zu authentifizieren. Weitere Informationen zum Einrichten eines Token-Abrufs finden Sie im Einrichtungsleitfaden für Android, iOS oder JavaScript.

Kartenansicht und Fahrt-Tracker

Die Funktion „Fahrt verfolgen“ umfasst Komponenten zur Visualisierung von Fahrzeugen und Wegpunkten sowie Rohdatenfeeds für die voraussichtliche Ankunftszeit eines Fahrers oder die verbleibende Fahrstrecke.

In der folgenden Tabelle werden diese Komponenten beschrieben:

Komponente Beschreibung
Kartenansicht für Verbraucher In der Kartenansicht wird der Lebenszyklus einer Fahrt verwaltet. Während der Fahrt werden Wegpunkte für den Standort von Fahrzeugen angezeigt. Wenn die Route für ein Fahrzeug bekannt ist, wird die Polylinie der Fahrzeugroute in der Kartenansicht aktualisiert, um den Fortschritt des Fahrzeugs auf seiner Route anzuzeigen.
Anbieter von Fahrtstandorten in JavaScript Bei JavaScript-Webanwendungen werden die Standortinformationen für die verfolgten Objekte vom Standortanbieter für die Fahrt in die Karte für die geteilte Fahrt eingespeist. Weitere Informationen finden Sie unter Anbieter für Fahrtstandorte instanziieren. Mit dem Anbieter für den Fahrtstandort können Sie die folgenden Details für eine Fahrt erfassen:
  • Der Abhol- oder Absetzort einer Fahrt.
  • Der Standort und die Route des Fahrzeugs, das der Fahrt zugewiesen ist.

Standortobjekte, die verfolgt werden

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

Getrackter Standort Beschreibung
Abholort Der Abholort ist der Ort, an dem eine Fahrt beginnt.
Zielort Der Zielort ist der Ort, an dem eine Fahrt endet. Sie markiert den Abgabeort.
Wegpunktstandort Ein Wegpunkt ist ein beliebiger Zwischenort auf der Route einer getrackten Fahrt. Technisch gesehen können Wegpunkte zwar auch Abhol- und Absetzorte umfassen, in der Regel beziehen sie sich jedoch auf Zwischenstopps entlang der Route. Die Haltestellen zwischen dem Abhol- 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 verfolgten Standortobjekte auf der Karte festgelegt. Sie können benutzerdefinierte Stiloptionen verwenden, um den Stil Ihrer Webanwendung anzupassen.

Sichtbarkeit von beobachteten Orten steuern

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

  • Fahrzeuge sind nur während der Fahrt sichtbar: Ein Fahrzeug ist ab dem Zeitpunkt, an dem es einer Fahrt zugewiesen wird, bis zum Zeitpunkt des Ausstiegs sichtbar. Wenn die Fahrt storniert wird, ist das Fahrzeug nicht mehr sichtbar.

  • Alle anderen Standortmarkierungen sind immer sichtbar: Alle anderen Standortmarkierungen für Start, Ziel und Wegpunkte werden immer auf der Karte angezeigt. Beispielsweise wird der Zielort einer Fahrt oder der Lieferort einer 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: