Übersicht zum Teilen von On-Demand-Reisen

Wenn Sie die Journey Sharing von Fleet Engine für On-Demand-Fahrten nutzen, den Fortschritt von Bestellungen, Fahrten oder anderen von Ihnen angebotenen Dienstleistungen verfolgen können.

Nutzer-App

Was ist das Teilen der Reise?

„Die Reise teilen“ ist eine Funktion von Fleet Engine für On-Demand-Fahrten, die für Consumer SDK: Sie bietet Schnittstellen, mit denen Fahrtdaten modelliert und Fahrt verfolgt werden. in Fleet Engine und stellt Klassen bereit, mit denen Sie kartenbasierten Anzeige von Fahrten für Privatnutzer. Sie integrieren die SDK in Ihre App ein und legen Sie die entsprechenden Rollenprofile in Fleet Engine auf die Nutzung von Kaufprozessen zu unterstützen.

Das Teilen von Onlinerecherchen bietet plattformspezifische APIs, mit denen Sie eine Reise entwickeln können. nativ in Ihren Anwendungen freigeben zu können. Das Consumer SDK ist für folgenden Plattformen:

Vorteile des Teilens von User Journeys

Durch die Integration von Reiseinformationen in Ihre On-Demand-Reiseanwendungen umfassende Fahrzeugüberwachung nahezu in Echtzeit Standortaktualisierungen und gesperrte Positionen. Ihr die Route des Fahrzeugs als Overlay auf einer Karte angezeigt, Fortschrittsdetails, die ihnen helfen zu verstehen, wo sich ihre Fahrt oder Lieferung befindet.

Was kann ich mit dem Teilen von Reiseplänen tun?

Mit Informationen aus dem Driver SDK und Fleet Engine können Sie Mobile SDK-Ansichten und Webdienstantworten, die die folgenden Funktionen bereitstellen:

  • Passen Sie die Benutzeroberfläche der Karte an Ihre Branding-Anforderungen an.

  • Die aktuelle Position des Fahrzeugs auf seiner Route, einschließlich in regelmäßigen Abständen aktualisiert.

  • Die voraussichtliche Ankunftszeit an den Abhol- und Abgabeorten.

  • Die verbleibende Strecke.

  • Aktuelle Verkehrslage auf der Route

So funktioniert das Teilen der Reise

Grundsätzlich beruht die Vorgehensweise auf den folgenden Mechanismen:

  • Geeignete Fleet Engine-Nutzerrollen, damit authentifizierte Anwendungsnutzer die zu seiner Bestellung gehörende Fahrt abrufen.
  • Eine Verknüpfung zwischen dem Nutzer und der Reise, die von Ihrem Back-End-System.
  • Das Consumer SDK TripModel und JourneySharingSession, SDK-Klassen, die modellieren Sie Fahrtdaten und teilen Sie Fahrten in der Nutzer-App.

Reise teilen

Das Consumer SDK bietet auch andere Schnittstellen und Klassen, damit Sie Folgendes tun können: Erstellen einer Karten-Benutzeroberfläche für Ihre App, damit Ihre Kunden eine umfassende App-Erfahrung mit Details wie Verkehr, Kartenmarkierungen, Routendaten.

Diese Tabelle zeigt den Ablauf einer gemeinsamen Journey.

1 Nutzer-App fordert eine Fahrt an. Ihr Backend-Server erhält eine On-Demand-Fahrtanfrage und führt Folgendes:
  • Erstellt eine Fahrt in Fleet Engine.
  • Weist die Fahrt einem Fahrzeug in Fleet Engine zu.
2 Fahrer akzeptiert die Fahrt Die Fahrer-App ruft die Fahrt-ID und Fahrtinformationen ab. die Fahrt annimmt.
3 Nutzer-App fordert Zugriff zum Kaufprozess an Die Nutzer-App ruft die Fahrt-ID von Ihrem Back-End ab und um mit dem Teilen der Reise zu beginnen.
4 Fahrer startet die Fahrt Wenn der Fahrer die Fahrer-App verwendet, um anzuzeigen, dass die Fahrt gestartet wurde, benachrichtigt die App Ihren Backend-Server über das Driver SDK. Zum Beispiel, wenn der Fahrer das Restaurant verlassen oder zum Abholort fahren.
5 Fleet Engine teilt die Reise Fleet Engine verfolgt den Weg und teilt mit der Nutzer-App überprüfen.
6 Nutzer-App zeigt den Kaufprozess Die Nutzer-App benachrichtigt den Nutzer und zeigt an, und aktualisieren den Prozess im Laufe der Zeit.
7 Fahrt beendet oder storniert Wenn der Fahrer die Fahrt annulliert oder beendet, Die Treiber-App deaktiviert das Standort-Tracking und Ihr Backend-Server weist Fleet Engine an, die Fahrt als gestrichen oder abgeschlossen zu markieren.
8 Nutzer-App beendet Kaufprozess 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 wird wiederholt.

Teilen der Reise verwenden

Wähle deine Plattform aus, um zu erfahren, wie du deine Reise teilen kannst.

Android

1 Consumer SDK in Android einrichten Wenn Sie Kaufprozesse für On-Demand-Fahrten in Ihrer App teilen möchten, müssen Sie das Consumer SDK einrichten. Weitere Informationen finden Sie unter Android Consumer SDK herunterladen.
2 Visuelle Benutzeroberfläche zum Teilen der Reise einrichten Definieren Sie eine Karte und fügen Sie Unterstützung für Vektorkarten hinzu, um die Benutzeroberfläche für Ihre Reise einzurichten. Weitere Informationen finden Sie unter Karte einrichten.
3 Reise teilen Folgen Sie einer Fahrt, um den Standort des entsprechenden Fahrzeugs mit Ihren Kunden zu teilen. Weitere Informationen finden Sie unter Reisen folgen.
5 Reisefortschritt aktualisieren und Fahrtfehler beheben Aktualisieren Sie die Details Ihrer Fahrt, z. B. die Fahrzeit und die voraussichtliche Ankunftszeit, und beheben Sie Fehler während dieser Fahrt. Weitere Informationen finden Sie unter Fahrtfortschritt aktualisieren und Fahrtfehler verarbeiten.
5 Teilen beenden, wenn eine Reise abgeschlossen ist Wenn Sie einer Fahrt nicht mehr folgen möchten, wird der Standort des Fahrzeugs nicht mehr für Nutzer freigegeben. Weitere Informationen finden Sie unter Fahrt nicht mehr folgen.

iOS

1 Consumer SDK in iOS einrichten Wenn Sie Kaufprozesse für On-Demand-Fahrten in Ihrer App teilen möchten, müssen Sie das Consumer SDK einrichten. Weitere Informationen finden Sie unter iOS Consumer SDK abrufen.
2 Visuelle Benutzeroberfläche zum Teilen der Reise einrichten Initialisieren Sie die Kartenansicht und verarbeiten Sie Kartenereignisse, um die Oberfläche für Ihre Fahrt einzurichten. Weitere Informationen finden Sie unter Karte einrichten.
3 Reise teilen Folgen Sie einer Fahrt, um den Standort des entsprechenden Fahrzeugs mit Ihren Kunden zu teilen. Weitere Informationen finden Sie unter Reisen folgen.
5 Reisefortschritt aktualisieren und Fahrtfehler beheben Aktualisieren Sie die Details Ihrer Fahrt, z. B. die Fahrzeit und die voraussichtliche Ankunftszeit, und beheben Sie Fehler während dieser Fahrt. Weitere Informationen finden Sie unter Fahrtfortschritt aktualisieren und Fahrtfehler verarbeiten.
5 Teilen beenden, wenn eine Reise abgeschlossen ist Wenn Sie einer Fahrt nicht mehr folgen möchten, wird der Standort eines Fahrzeugs nicht mehr für Nutzer freigegeben.Weitere Informationen finden Sie unter Fahrt nicht mehr folgen.

JavaScript

1 Teilen von Onlinerecherchen in JavaScript einrichten Wenn Sie Kaufprozesse für On-Demand-Fahrten in Ihrer App teilen möchten, müssen Sie das Consumer SDK einrichten. Weitere Informationen findest du unter JavaScript Consumer SDK einrichten.
2 Karte zum Teilen der Reise laden und anpassen Aktivieren Sie die Maps JavaScript API und richten Sie die Autorisierung ein, um die Benutzeroberfläche für Ihre Fahrt einzurichten. Weitere Informationen finden Sie unter Karte einrichten.
3 Reise teilen Folgen Sie einer Fahrt, um den Standort des entsprechenden Fahrzeugs mit Ihren Kunden zu teilen. Weitere Informationen finden Sie unter Reisen folgen.
5 Reisefortschritt aktualisieren und Fahrtfehler beheben Aktualisieren Sie die Details Ihrer Fahrt, z. B. die Fahrzeit und die voraussichtliche Ankunftszeit, und beheben Sie Fehler während dieser Fahrt. Weitere Informationen finden Sie unter Fahrtfortschritt verfolgen und Fahrtfehler verarbeiten.
5 Teilen beenden, wenn eine Reise abgeschlossen ist Wenn Sie einer Fahrt nicht mehr folgen möchten, wird der Standort des Fahrzeugs nicht mehr für Nutzer freigegeben. Weitere Informationen finden Sie unter Teilen von Fahrten beenden.

Komponenten

In diesem Abschnitt werden zwei erforderliche Komponenten für die gemeinsame Nutzung einer User Journey zusammengefasst:

Optional können Sie mit diesen Komponenten:

Abruf von Authentifizierungstokens

Um den Zugriff auf die in Fleet Engine gespeicherten Standortdaten zu steuern, müssen Sie die folgenden Schritte ausführen: Folgendes:

  1. JWT-Erstellungsdienst (JSON Web Token) für Fleet Engine implementieren auf Ihrem Server.

  2. Abruf von Authentifizierungstokens in Ihren Web- oder mobilen Apps implementieren um den Zugriff auf die Standortdaten zu authentifizieren.

Für Weitere Informationen finden Sie im Android. iOS oder JavaScript.

Kartenansicht und Fahrt-Tracker

Das Teilen von Reiseplänen enthält Komponenten zur Visualisierung von Fahrzeugen und Wegpunkten sowie Rohdaten-Feeds für die voraussichtliche Ankunftszeit eines Fahrers. oder die verbleibende Strecke.

In der folgenden Tabelle werden diese Komponenten beschrieben:

Komponente Beschreibung
Kartenansicht für das Teilen einer Reise In der Kartenansicht wird der Lebenszyklus einer Reise verwaltet und Wegpunkte angezeigt. für den Standort der Fahrzeuge im Verlauf der Fahrt ermitteln. Wenn die Route eines Fahrzeugs bekannt ist, wird sie in der Kartenansicht aktualisiert. Polylinie, um den Fortschritt des Fahrzeugs auf seiner Route anzuzeigen.
Anbieter von Reisezielen in JavaScript Bei JavaScript-Webanwendungen wird der Feedstandort des Reiseanbieterfeeds verwendet Informationen zu erfassten Objekten in der gemeinsamen Journey Map hinzufügen. Weitere Informationen finden Sie unter Ortsanbieter instanziieren Mit dem Anbieter können Sie folgende Details für eine Fahrt:
  • Der Start- oder Zielort einer Fahrt.
  • Der Standort und die Route des Fahrzeugs, das der Fahrt zugewiesen ist.

Erfasste Standortobjekte

Der Standortanbieter erfasst 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. Sie markiert Abholort.
Zielspeicherort Der Zielort ist der Ort, an dem eine Fahrt endet. Sie kennzeichnet den Abgabeort.
Standort des Wegpunkts Ein Wegpunkt ist ein beliebiger Zwischenpunkt entlang der Route eines verfolgte Reise. Technisch gesehen können Wegpunkte zwar Abhol- und Abgabeorte, Wegpunkte beziehen sich in der Regel auf Zwischenziele der einzelnen Haltestellen entlang der Route. Zum Beispiel die Haltestellen zwischen Abhol- und Zielort. Orte auf einer Lieferroute sind Wegpunktpositionen. Weitere Informationen finden Sie unter Wegpunkte finden Sie in der Fleet Engine-Dokumentation.
Fahrzeugstandort Der Fahrzeugstandort ist der gemeldete Standort eines Fahrzeugs. Weitere Informationen findest du unter Fahrzeugstandort finden Sie in der Fleet Engine-Dokumentation.

Karten gestalten

Durch Markierungs- und Polylinienstile wird das Erscheinungsbild der verfolgte Standortobjekte auf der Karte. Sie können Benutzerdefinierte Stiloptionen, um den Standardstil entsprechend zu ändern Ihrer Webanwendung.

Sichtbarkeit beobachteter Standorte festlegen

Die vordefinierten Standortanbieter in Fleet Engine befolgen diese Sichtbarkeitsregeln für beobachtete Standortobjekte auf der Karte. Wenn Sie eine benutzerdefinierte oder abgeleitete des Standortanbieters können Sie die Sichtbarkeitsregeln ändern.

  • Fahrzeuge sind nur während der Fahrt sichtbar: eine Fahrt des freigegebenen Fahrzeugs ist ab dem Zeitpunkt der Zuweisung Zeitpunkt des Ausstiegs. Wenn die Fahrt gestrichen wird, ist das Fahrzeug länger sichtbar.

  • Alle anderen Standortmarkierungen sind immer sichtbar: alle anderen Standortmarkierungen. für Abflugort, Zielort und Wegpunkte werden immer auf der Karte angezeigt. Für z. B. einen Rückgabeort oder eine Sendungszustellung Standort wird immer auf der Karte angezeigt, unabhängig vom Status der Reise oder Lieferung.

Nächste Schritte

Weitere Informationen finden Sie in der Dokumentation der Plattform, auf der Sie Journeys teilen möchten: