Passen Sie das Nutzererlebnis 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:
Vorteile des Consumer SDK
Wenn Sie das Consumer SDK in Ihre On-Demand-Fahrten-Apps einbinden, können Sie Nutzern eine umfassende Erfahrung mit nahezu in Echtzeit aktualisierten Standorten und auf 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?
Mithilfe von Informationen aus dem Driver SDK und Fleet Engine können Sie benutzerdefinierte Funktionen für Nutzer erstellen, darunter:
Passen Sie die Karten-Benutzeroberfläche an Ihre Markenanforderungen an.
Verfolgen Sie den aktuellen Standort des Fahrzeugs auf seiner Fahrt entlang der Route; seine 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
Im Allgemeinen basiert das Consumer SDK auf den folgenden Mechanismen:
- Die entsprechenden Fleet Engine-Rollen müssen vorhanden sein, damit eine authentifizierte App die mit der Bestellung eines Kunden verbundene Reise verfolgen kann.
- Eine Verbindung zwischen dem Kunden und der Reise, die von Ihrem Backend-System hergestellt wird.
- Die SDK-Klassen
TripModelundJourneySharingSession, die Fahrtendaten modellieren und Fahrtensitzungen in der Verbraucher-App freigeben.
Das Consumer SDK bietet außerdem weitere Schnittstellen und Klassen, mit denen Sie ein umfassendes App-Erlebnis mit Details wie Verkehrsinformationen, Kartenmarkierungen, voraussichtlicher Ankunftszeit und Routendaten erstellen können.
Diese Tabelle zeigt den Ablauf einer Reise, der von einer Verbraucher-App nachverfolgt wird.
| 1 | Eine Consumer-App fordert eine Fahrt an | Ihr Backend-Server erhält eine On-Demand-Fahrtanfrage und führt die folgenden Schritte aus:
|
| 2 | Der Fahrer nimmt die Fahrt an | Die Fahrer-App erhält die Fahrt-ID und die Fahrtinformationen, und der Fahrer nimmt die Fahrt an. |
| 3 | Die Verbraucher-App beantragt Zugriff, um die Reise zu verfolgen | Die App für private Nutzer ruft die Fahrt-ID von Ihrem Backend ab und fordert an, die Fahrt zu verfolgen. |
| 4 | Der 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 im Begriff ist, das Restaurant zu verlassen oder zum Abholort zu fahren. |
| 5 | Flotten-Engine beginnt mit dem Senden von Reiseinformationen | Fleet Engine beginnt mit der Verfolgung der Fahrt und teilt deren Fortschritt mit der Kunden-App. |
| 6 | Die Verbraucher-App zeigt die Reiseinformationen an | Die Verbraucher-App benachrichtigt den Verbraucher und zeigt ihm die Fahrtinformationen an. Die Fahrt wird im weiteren Verlauf aktualisiert. |
| 7 | Die 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 „Abgebrochen“ 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 Nutzerfreundlichkeit zu verbessern. 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 Reisen wie die zurückgelegte Strecke und die voraussichtliche Ankunftszeit aktualisieren und Fehler während einer Reise beheben. Weitere Informationen finden Sie unter Fahrtfortschritt aktualisieren und Fahrtfehler beheben. |
| 5 | Nach Abschluss einer Fahrt nicht mehr folgen | Wenn Sie einer Fahrt nicht mehr folgen, wird der Standort eines Fahrzeugs nicht mehr mit dem Nutzer geteilt. 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 Reisen wie die zurückgelegte Strecke und die voraussichtliche Ankunftszeit aktualisieren und Fehler während einer Reise beheben. Weitere Informationen finden Sie unter Fahrtfortschritt aktualisieren und Fahrtfehler beheben. |
| 5 | Nach Abschluss einer Fahrt nicht mehr folgen | Wenn Sie einer Fahrt nicht mehr folgen, wird der Standort eines Fahrzeugs nicht mehr mit dem Nutzer geteilt. 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 Entfernung und die geschätzte Ankunftszeit aktualisieren 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 | Wenn Sie einer Fahrt nicht mehr folgen, wird der Standort eines Fahrzeugs nicht mehr mit dem Nutzer geteilt. Weitere Informationen finden Sie unter Fahrt nicht mehr folgen. |
Komponenten
In diesem Abschnitt werden zwei notwendige Komponenten für die Routenplanung zusammengefasst:
- Authentication token fetcher (Abrufer für Authentifizierungstoken).
- Kartenansicht und Routen-Tracker:
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 Authentifizierungstoken-Fetcher 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 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 Fahrstrecke.
In der folgenden Tabelle werden diese Komponenten beschrieben:
| Komponente | Description |
|---|---|
| Kartenansicht für Nutzer | In der Kartenansicht wird der Lebenszyklus einer Fahrt verwaltet. Dabei werden Wegpunkte für den Standort von Fahrzeugen angezeigt, während die Fahrt fortschreitet. 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 Routenstandorten 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.
| Verfolgter Standort | Description |
|---|---|
| Abholort | Der Abholort ist der Ort, von dem aus eine Reise beginnt. |
| Zielort | Der Zielort ist der Ort, an dem eine Reise endet. Es markiert den Abladeort. |
| 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 Abhol- und dem Zielort auf einer Lieferroute sind beispielsweise Wegpunkte. Weitere Informationen finden Sie unter Reisewegpunkte in der Fleet Engine-Dokumentation. |
| Fahrzeugstandort | Der Fahrzeugstandort ist der gemeldete Standort eines Fahrzeugs. Weitere Informationen finden Sie unter Fahrzeugstandort in der Fleet Engine-Dokumentation. |
Karten gestalten
Mit Markierungs- und Polylinienstilen wird das Erscheinungsbild der Objekte mit verfolgten Standorten 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 von dem Zeitpunkt seiner Zuweisung zu einer Fahrt bis zum Zeitpunkt der Zielankunft sichtbar. Wird die Fahrt abgebrochen, 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: