Passen Sie die Nutzererfahrung für On-Demand-Fahrten an, indem Sie Nutzern die Möglichkeit geben, die Fahrt für eine Bestellung, Fahrt oder einen anderen von Ihnen angebotenen Dienst zu verfolgen.
Was ist das Consumer SDK?
Das Consumer SDK ist Teil von Fleet Engine für On-Demand-Fahrten. Sie bietet Schnittstellen, die Fahrtdaten modellieren und Fahrten in Fleet Engine verfolgen, sowie Klassen, mit denen Sie eine umfassende, kartenbasierte Darstellung erstellen können, um Fahrten mit Ihren Endnutzern 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, Routen nativ in Ihre Anwendungen einzubinden, entwickeln. 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 On-Demand-Fahrten-Apps einbinden, können Sie Nutzern ein umfassendes Erlebnis mit nahezu in Echtzeit aktualisierten Standorten und auf die Straße ausgerichteten Positionen bieten. Ihre Kunden können die Route des Fahrzeugs auf einer Karte sehen, einschließlich Fortschrittsdetails, die ihnen helfen, den Standort ihrer Fahrt oder Lieferung zu verfolgen.
Was kann ich mit dem Consumer SDK tun?
Mithilfe von Informationen aus dem Driver SDK und Fleet Engine können Sie benutzerdefinierte Nutzererlebnisse mit den folgenden Funktionen erstellen:
Passen Sie die Karten-UI an Ihr Branding an.
Sie können die aktuelle Position des Fahrzeugs verfolgen, während es die Route zurücklegt. Die Position wird regelmäßig aktualisiert.
Die voraussichtliche Ankunftszeit für Abhol- und Abgabeorte anzeigen.
Die verbleibende Distanz anzeigen
Verkehrsinformationen in Echtzeit 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 der Fahrt folgen kann, die mit der Bestellung eines Kunden verknüpft ist.
- Eine Zuordnung zwischen dem Nutzer und der Fahrt, die von Ihrem Backend-System bereitgestellt wird.
- Die SDK-Klassen
TripModelundJourneySharingSession, die Fahrtendaten modellieren und Fahrtensitzungen in der Verbraucher-App teilen.
Das Consumer SDK bietet auch andere Schnittstellen und Klassen, mit denen Sie eine umfassende App mit Details wie Verkehrsdaten, Markierungen, voraussichtlicher Ankunftszeit und Routendaten erstellen können.
In dieser Tabelle wird der Ablauf einer Fahrt in einer Verbraucher-App dargestellt.
| 1 | Fahrtanfrage über eine Verbraucher-App | Ihr Backend-Server erhält eine On-Demand-Fahranfrage und führt die folgenden 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 | Verbraucher-App fordert Zugriff an, um der Fahrt zu folgen | 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. Zum Beispiel, wenn der Fahrer das Restaurant verlässt oder zum Abholort fährt. |
| 5 | Fleet Engine beginnt mit dem Senden von Fahrinformationen | Fleet Engine beginnt mit der Aufzeichnung der Fahrt und gibt den Fortschritt an die Verbraucher-App weiter. |
| 6 | Die Reiseinformationen werden in der Verbraucher-App angezeigt. | Die Verbraucher-App benachrichtigt den Verbraucher und zeigt ihm die Fahrtinformationen an. Die Fahrt wird im weiteren Verlauf aktualisiert. |
| 7 | Fahrt wurde storniert oder abgeschlossen | Wenn der Fahrer die Fahrt abbricht oder abschließt, wird die Standortverfolgung in der Fahrer-App deaktiviert und Ihr Backend-Server weist Fleet Engine an, die Fahrt als abgebrochen oder abgeschlossen zu markieren. |
| 8 | Die Verbraucher-App beendet die Routenverfolgung | 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 sehen, wie Sie in Ihren Verbraucher-Apps mit dem Folgen von Fahrten beginnen können.
Android
| 1 | Consumer SDK in 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 Benutzeroberfläche einrichten | Definieren Sie eine Karte und fügen Sie Unterstützung für Vektorkarten hinzu, um die Nutzererfahrung zu optimieren. Weitere Informationen finden Sie unter Karte einrichten. |
| 3 | Fahrt folgen | Wenn Sie eine Fahrt starten, wird der Standort des entsprechenden Fahrzeugs für den Nutzer freigegeben. Weitere Informationen finden Sie unter Fahrten folgen. |
| 5 | Fahrtfortschritt aktualisieren und Fahrtfehler beheben | 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 | Wenn eine Fahrt abgeschlossen ist, nicht mehr folgen | Wenn Sie einer Fahrt nicht mehr folgen, wird der Standort eines Fahrzeugs nicht mehr für den Nutzer freigegeben. 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, müssen Sie das Consumer SDK einrichten. 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 | Fahrt folgen | Wenn Sie eine Fahrt starten, wird der Standort des entsprechenden Fahrzeugs für den Nutzer freigegeben. Weitere Informationen finden Sie unter Fahrten folgen. |
| 5 | Fahrtfortschritt aktualisieren und Fahrtfehler beheben | 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 | Wenn eine Fahrt abgeschlossen ist, nicht mehr folgen | Wenn Sie einer Fahrt nicht mehr folgen, wird der Standort eines Fahrzeugs nicht mehr für den Nutzer freigegeben. 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 einzurichten. Weitere Informationen finden Sie unter Karte einrichten. |
| 3 | Fahrt folgen | Wenn Sie eine Fahrt starten, wird der Standort des entsprechenden Fahrzeugs für den Nutzer freigegeben. Weitere Informationen finden Sie unter Fahrten folgen. |
| 5 | Fahrtfortschritt aktualisieren und Fahrtfehler beheben | Sie können Details zu Ihren Fahrten wie die zurückgelegte Strecke und die voraussichtliche Ankunftszeit aktualisieren und Fehler bei einer Fahrt beheben. Weitere Informationen finden Sie unter Fahrtfortschritt aktualisieren und verfolgen und Fahrtfehler beheben. |
| 5 | Wenn eine Fahrt abgeschlossen ist, nicht mehr folgen | Wenn Sie einer Fahrt nicht mehr folgen, wird der Standort eines Fahrzeugs nicht mehr für den Nutzer freigegeben. Weitere Informationen finden Sie unter Fahrt nicht mehr folgen. |
Komponenten
In diesem Abschnitt werden zwei notwendige Komponenten für die Routenplanung zusammengefasst:
Optional können Sie die Nutzererfahrung auch mit den folgenden Komponenten anpassen:
Authentifizierungstoken-Fetcher
So steuern Sie den Zugriff auf die in Fleet Engine gespeicherten Standortdaten:
Implementieren Sie auf Ihrem Server einen Dienst zum Erstellen von JSON-Webtokens (JWTs) für Fleet Engine. Weitere Informationen finden Sie unter JWTs ausstellen.
Implementieren Sie einen Abrufer für Authentifizierungstokens in Ihren Web- oder mobilen Apps, um den Zugriff auf die Standortdaten zu authentifizieren. Weitere Informationen zum Einrichten eines Token-Fetchers finden Sie im Einrichtungsleitfaden für Android, iOS oder JavaScript.
Kartenansicht und Routen-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 Fahrstrecke.
In der folgenden Tabelle werden diese Komponenten beschrieben:
| Komponente | Beschreibung |
|---|---|
| Kartenansicht für Nutzer | 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 Reiseorten in JavaScript | Bei JavaScript-Web-Apps stellt der Anbieter von Fahrtstandorten Standortinformationen für verfolgte Objekte auf der geteilten Fahrtkarte bereit. Weitere Informationen finden Sie unter Anbieter für Fahrtstandorte instanziieren.
Mit dem Anbieter für den Standort von Fahrten können Sie die folgenden Details für eine Fahrt erfassen:
|
Verfolgte Standortobjekte
Der Standortanbieter verfolgt den Standort 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 markiert den Abgabeort. |
| Wegpunktposition | Ein Wegpunkt ist ein beliebiger Zwischenort auf der Route einer aufgezeichneten Fahrt. Technisch gesehen können Wegpunkte Abhol- und Abgabeorte umfassen, in der Regel beziehen sie sich jedoch auf Zwischenstopps entlang der Route. Die Haltestellen zwischen dem Abholort und dem Zielort auf einer Lieferroute sind beispielsweise 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 gestalten
Mit Markierungs- und Polylinienstilen wird das Erscheinungsbild der Objekte für aufgezeichnete Standorte 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 sichtbar, wenn die Fahrt läuft: Ein Fahrzeug für eine Fahrt ist ab dem Zeitpunkt der Zuweisung bis zum Absetzen des Fahrgasts sichtbar. Wenn die Fahrt storniert wird, ist das Fahrzeug nicht mehr sichtbar.
Alle anderen Ortsmarkierungen sind immer sichtbar: Alle anderen Ortsmarkierungen für Startort, Zielort und Wegpunkte werden immer auf der Karte angezeigt. So wird beispielsweise der Zielort einer Fahrt oder einer Lieferung 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 folgen möchten: