In diesem Dokument wird der Dienst für geplante Aufgaben in Fleet Engine beschrieben. Es wird davon ausgegangen, Sie haben den Artikel Was ist Fleet Engine? gelesen und kennen die spezifische Flotte Erforderliche Engine-Servicefähigkeit
Beachten Sie beim Lesen dieser Dokumentation Folgendes:
- Sie erstellen Aufgaben und verknüpfen sie mit einem Fahrzeugstopp, um die reale Verbindung zwischen der Aufgabe und dem Ort, an dem die Es wird erwartet, dass das Fahrzeug anhält, damit der Fahrer die Aufgabe ausführen kann. Weitere Informationen finden Sie im Artikel Einführung in Fahrzeuge wie Fahrzeuge in Fleet Engine funktionieren.
- Fleet Engine für geplante Aufgaben verwendet die folgenden Ressourcen: ein
TaskundDeliveryVehicle. Fleet Engine bietet sowohl einen gRPC-Dienst als auch REST. Schnittstellen:
Was ist eine geplante Aufgabe?
Eine geplante Aufgabe in Fleet Engine stellt eine einzelne Aktion dar, die ausgeführt werden soll. ein Fahrzeug, das von einem Fahrer im umfassenderen Kontext für den öffentlichen Nahverkehr. Damit wird das spezifische Ziel des Treibers definiert. Beispiel:
- eine Ware an einen Wohnsitz zu liefern
- ein Paket für die Rücksendung zum Versanddepot abzuholen
- an einem Ort anhalten, um einen Dienst vor Ort bereitzustellen
- einen geplanten Stopp zum Tanken des Fahrzeugs zu machen
Aufgabenelemente
In der folgenden Abbildung sind diese Aufgabenelemente für ein Fahrzeug.
Grundlegende Aufgabenfelder
| Feld | Beschreibung |
|---|---|
| Typ | Definiert den Typ der mit der Aufgabe verknüpften Aktion. |
| Aufgaben-ID | Ein String, der die Aufgabe im System eindeutig identifiziert. |
| Geplanter Ort | Gibt den vorgesehenen Ort an, an dem die Aufgabe ausgeführt werden soll. Dieser Standort entspricht nicht immer dem geplanten Standort für das halten. |
| Status | Gibt an, ob die Aufgabe geöffnet oder geschlossen ist. |
| Ergebnis der Aufgabe | Gibt an, ob die Aufgabe erfolgreich war oder fehlgeschlagen ist. |
Datenmodell für Aufgaben
Die folgenden Diagramme veranschaulichen das Datenmodell der Ressource Task.
neben dem Diagramm für die zugehörige DeliveryVehicle-Ressource. Sie können
sehen Sie sich beide Diagramme an,
um die Beziehungen zwischen den beiden Ressourcen
beachten Sie dabei Folgendes:
- Geplanter Standort: Sowohl Haltestellen als auch Aufgaben haben geplante Orte.
voneinander zu unterscheiden.
- Bei Aufgaben gibt ein geplanter Standort an, wo die Fahreraktion auftreten sollte. Beispiel: 15 Paketlieferungen in ein großes Wohngebäude. erfordern die Lieferung an verschiedene Postlagerstandorte innerhalb denselben Komplex.
- Bei Haltestellen wird durch den geplanten Ort die Haltestelle für die Haltestellen während der Fahrer die Aufgaben erledigt. Beispiel: an der Einfahrt zu einem Wohnkomplex hält und der Fahrer die Pakete von Hand an separate Poststellen innerhalb des Komplexes liefert.
- Status: Sowohl für Aufgaben als auch für Haltestellen gibt es ein Feld state, das sich von
sich gegenseitig helfen.
- Der Status der Haltestelle spiegelt den Fortschritt des Fahrzeugs in zur Haltestelle und wird zur Verfolgung der Flotte verwendet.
- Der Status der Aufgabe gibt an, ob die Aufgabe aktiv ist oder nicht. Dieses sich auf andere Abläufe bei Aufgaben auswirkt, wie z. B. das Festlegen der oder es einem Fahrzeug zuweisen.
Aufgabenergebnis: Das Aufgabenergebnis ist ein wichtiges Feld im Datenmodell. da er genutzt wird, um den Erfolg oder Misserfolg einer Aufgabe anzuzeigen, unabhängig des Aufgabenstatus.
IDs:
- Wenn Sie einem Fahrzeug eine Aufgabe zuweisen, füllt die Fleet Engine
deliveryVehicleId. Dieses schreibgeschützte Feld gibt an, dem die Aufgabe zugewiesen wird. - Aufgaben-IDs sind eindeutige Kennungen für alle Aufgaben in Ihrem System.
- Mit Tracking-IDs wird eine Aufgabe zur Sendungsverfolgung identifiziert.
- Wenn Sie einem Fahrzeug eine Aufgabe zuweisen, füllt die Fleet Engine
Tasks-Datenmodell
Fahrzeugdatenmodell
Aufgaben-IDs
Ähnlich wie bei Fahrzeug-IDs in Fleet Engine müssen Aufgaben jeweils eine ID enthalten, um
sie von anderen Aufgaben im System zu unterscheiden. Sie referenzieren und verwalten
Aufgaben in Ihrem Workflow nach ihrer ID sortiert. Sie erstellen diese IDs mithilfe des
CreateTaskRequest und durch Angabe eines ID-Strings, der den
die in diesem Abschnitt beschriebenen Anforderungen erfüllt werden.
Dieser String enthält dann einen Teil des Namens der Aufgabenressource selbst,
reines Ausgabefeld für das Task-Objekt. Das funktioniert ähnlich wie bei Fleet Engine
Ressourcen für Fahrzeugnamen erstellt. Weitere Informationen finden Sie im Abschnitt Ressourcenbenennung in
Einführung in Fleet Engine.
| Attribut | Beschreibung |
|---|---|
| Eindeutigkeit | Jede Aufgaben-ID muss innerhalb Ihrer Fleet Engine-Implementierung eindeutig sein, um Verwechslungen zu vermeiden und eine ordnungsgemäße Identifizierung sicherzustellen. |
| Format |
|
| Beispiele für gute Aufgaben-IDs |
|
|---|---|
| Unzulässige Aufgaben-IDs |
|
Aufgabentypen
Fleet Engine unterstützt verschiedene Aufgabentypen, um verschiedene Aktionen innerhalb eines für den öffentlichen Nahverkehr. Sie werden hier und ihre Sichtbarkeit beschrieben. und Zahlungsinformationen.
| Aufgabentyp | Beschreibung | Sichtbarkeit der Sendungsverfolgung | In Rechnung gestellt |
|---|---|---|---|
| Lieferaufgabe | Für die Abgabe von Artikeln oder die Erledigung einer Aufgabe für einen Kunden. | Nutzer können dies sehen und verfolgen. | Ja |
| Abholaufgabe | Verwenden Sie diese Option, um die Abholung von Waren von einem Kunden anzugeben. Du musst entsprechende Lieferaufgaben für jede Abholaufgabe haben. | Nutzer können dies sehen und verfolgen. | Nein |
| Nichtverfügbarkeitsaufgabe | Das Fahrzeug wird als nicht verfügbar gekennzeichnet, z. B. wenn der Fahrer eine Pause macht oder das Fahrzeug auftankt. | Für Nutzer nicht sichtbar. | Nein |
| Geplante Stoppaufgabe | Eine Nichtlieferungsaufgabe, die einen Stopp an einem bestimmten Ort erfordert. Verwenden Sie geplante Haltestellenaufgaben für täglich geplante Abholstellen an einem bestimmten Ort, unabhängig von anderen Lieferungen oder Abholungen am selben Ort. Sie können auch geplante Haltestellenaufgaben für Sammlungen von Briefkästen erstellen oder Umsteigestationen für Zubringerfahrzeuge oder Haltestellen in Servicezentren und Servicepunkten zu modellieren. | Nutzer können diese spezielle Aufgabe nicht verfolgen, können sie jedoch als Teil der Verfolgung anderer Aufgaben sehen. | Nein |
Aufgaben- und Prozesslebenszyklus
Dieser Abschnitt enthält Details zum Lebenszyklus der Bereitstellungsaufgabe in Flotte Suchmaschine. Der Aufgabenlebenszyklus ist mit der Fahrt des Fahrzeugs verbunden, das Fahrzeug bis zur Haltestelle fahren muss, damit der Fahrer eine Aufgabe an seinem geplanter Ort.
1. Aufgabenerstellung
Wenn Sie zum ersten Mal eine Aufgabe in Fleet Engine erstellen, legen Sie eine Vielzahl von Feldern fest unabhängig von der Verknüpfung mit einer Haltestelle bereit.
| Attribut | Beschreibung |
|---|---|
| Status | Auf OFFEN festlegen |
| IDs | Legen Sie die Aufgabe und die Tracking-ID fest, wenn Sie die Sendungsverfolgung verwenden für Ihre Kunden. |
| Timing | Die geplante Dauer für die Aufgabe und das Zielzeitfenster. Weitere Informationen finden Sie unter Weitere Informationen finden Sie unter Aufgabentiming. |
| Geplanter Ort | Die genaue geografische Koordinate festlegen, in der die Aufgabe stattfinden soll abgeschlossen. |
2. Aufgabenzuweisung
Wenn Sie einem Fahrzeug eine Aufgabe zuweisen, geschieht dies in Verbindung mit einem Fahrzeug anhalten. Haltestellen sind Breiten- und Längengrade, die den Ort angeben, an dem während der Fahrer die mit der Haltestelle verbundenen Aufgaben erledigt. Haltestellen sind in der Regel Zugangspunkte wie Ladestationen oder Haltestellen Standort.
3. In Bearbeitung
Der Status einer Aufgabe ist entweder OFFEN oder GESCHLOSSEN. Sobald jedoch eine Aufgabe können Sie den Fortschritt verfolgen, indem Sie und wo sich das Fahrzeug im Verhältnis zur Haltestelle befindet, an der die Aufgabe ausgeführt werden soll. abgeschlossen.
Sobald das Fahrzeug an einer Haltestelle abfährt oder mit der Navigation beginnt, wird der Status der
stop sollte sich in ENROUTE ändern. Auf diese Weise kann die
Versandverfolgung
den Empfänger einer Aufgabe mit der Anzahl der verbleibenden und geschätzten Stopps aktualisieren
Ankunftszeit angezeigt werden. Dies unterstützt auch jede Echtzeit-Visualisierung für Verbraucher
der Sendungsverfolgung
oder der Flottenverfolgung.
4. Ankunft und Aufgabenergebnis
Wenn das Fahrzeug an einer Haltestelle ankommt, sollte der Status der Haltestelle auf
ARRIVED Wie bei der ENROUTE-Haltestelle wirkt sich dies nicht auf den Status der
die Aufgabe selbst, unterstützt jedoch sowohl Kundenbenachrichtigungen als auch
Berichte zur Flottenverfolgung, die Ihre Flottenbetreiber verwenden. Es ermöglicht auch spätere
Analyse und Berichterstellung zur Betriebsabwicklung, die Sie für die
Optimierungen vor.
Sobald das Fahrzeug an einer Haltestelle ankommt, erledigt das System den Rest mit einem der folgenden Ansätze an:
Schließen Sie Aufgaben ab, sobald sie abgeschlossen sind.
Wenn der Fahrer die Aufgabe als erledigt markiert, kann Ihr System sie aus dem beenden, aber die Haltestelle mit anderen zugewiesenen Aufgaben verlassen.
Entfernen Sie den gesamten Zwischenstopp.
Sobald der Fahrer alle Aufgaben als erledigt markiert hat und das Fahrzeug auf dem Weg zum können Sie die gesamte Haltestelle aus dem Fahrzeug entfernen. Fleet Engine schließt automatisch alle Aufgaben, die mit einem entfernten Zwischenstopp verknüpft sind.
Das Schließen einer Aufgabe ist kein Hinweis auf Erfolg oder Misserfolg
Das Schließen einer Aufgabe weist nur darauf hin, dass die Aufgabe nicht mehr als in Bearbeitung angesehen wird.
Bei Aufgaben mit dem Status CLOSED legen Sie das Ergebnis entweder auf SUCCEEDED oder
FAILED Dies ist erforderlich, um das tatsächliche Ergebnis für den Versand anzugeben.
und eine ordnungsgemäße Abrechnung. Fleet Engine berechnet nur Lieferaufgaben mit einem
ERFOLGREICH.
Sobald Sie ein Aufgabenergebnis festgelegt haben, können Sie es nicht mehr ändern.
Beim Markieren des Ergebnisses einer Aufgabe füllt Fleet Engine die Aufgabe automatisch aus. Ergebnisort mit dem letzten bekannten Fahrzeugstandort. Sie können jedoch die Zeit und den Ort des Aufgabenergebnisses, nachdem sie festgelegt wurden, Fleet Engine überschreibt diese Felder nicht.
5. Andere Aufgabenszenarien
Nicht alle Aufgaben, die Sie in Fleet Engine modellieren, lassen sich in einen typischen Ablauf einfügen. Beispiel:
- Abholungsaufgaben. Wenn Sie eine Abholung-Aufgabe haben, damit ein Paket zurückgesendet wird zur späteren Verarbeitung an das Depot gesendet werden, sollten Sie eine entsprechende delivery für das Paket zu, wobei der geplante Standort auf das Lager festgelegt ist. Andernfalls folgen Abholaufgaben im Allgemeinen dem gleichen Ablauf wie Lieferaufgaben.
- Neuzuweisung von Aufgaben. Sie können eine Aufgabe nicht direkt einer anderen Person Fahrzeug. Wenn Sie eine Aufgabe von einem Fahrzeug in ein anderes verschieben möchten, schließen Sie stattdessen das ursprüngliche Aufgabe und erstellen Sie sie neu, bevor Sie sie dem neuen Fahrzeug zuweisen. Wenn aktualisieren Sie die Aufgabenreihenfolge für eine Aufgabe, die bereits einer gibt Fleet Engine einen Fehler aus.
- Aufgaben löschen Wie bei Fahrzeugen löscht Fleet Engine Aufgaben, die nach sieben Tagen aktualisiert. Wenn Sie versuchen, eine Aufgaben-ID für eine mit zuvor geschlossen wurde, gibt Fleet Engine einen Fehler zurück, wenn diese ID verwendet wurde. innerhalb der letzten sieben Tage. Wenn Sie jedoch Aufgabendaten länger aufbewahren möchten, mehr als sieben Tage benötigen, müssen Sie diese Fähigkeit selbst implementieren, z. B. durch einen geplanten Auftrag zum Zurücksetzen der 7-Tage-Uhr.
Teilen der Aufgabenpfade
Mit der Freigabe von Aufgabenpfaden in Fleet Engine können Sie den Aufgabenfortschritt in Echtzeitinformationen zu erhalten und die Fahrt auf zwei Arten mit anderen zu teilen:
- Informationen zum Kaufprozess, damit Kunden den Status ihres oder angeforderte Serviceaufträge.
- Flottenverfolgung, damit Ihre Flottenbetreiber ihren Status verfolgen und analysieren können der Fahrzeuge im Fuhrpark.
Teilen des Kaufprozesses
Kaufprozess einrichten, um die Freigabe des Kaufprozesses in Ihren Betrieb einzubinden mit dem JavaScript Consumer SDK teilen. Mit dem SDK können Sie ein visuelle Darstellung im Web oder in mobilen Apps, sodass Nutzer den Status ihrer Website im Blick behalten können. Lieferung zusammen mit der voraussichtlichen Ankunftszeit und Standortupdates in Echtzeit für das Lieferfahrzeug. Siehe Übersicht über das Teilen des Kaufprozesses für geplante Aufgaben.
Das SDK für die Freigabe des Kaufprozesses enthält eine JavaScript-Zuordnung und Datenkomponenten.
zur Verbindung mit Fleet Engine. Die Karte ist ein Drop-in-Ersatz
Standard-google.maps.Map-Objekt. Ihr Client sollte sich bei Ihnen authentifizieren.
und verwenden Sie die Nutzerrolle Delivery (Zustellung) aus Ihrem Google Cloud-Projekt, um
nur kundenspezifische Informationen zurückgeben. Fleet Engine filtert und entfernt alle
in den Antworten
weitere Informationen geben. Bei einer Nichtverfügbarkeitsaufgabe
werden keine Standortinformationen an Endnutzer weitergegeben.
In Fleet Engine aktivieren Sie die folgenden Einstellungen für den Kaufprozess Teilen:
- Für Aufgaben wird das Attribut
TaskTrackingViewConfigverwendet. Optional. - Für Aufgaben wird eine Tracking-ID verwendet, die von der Bibliothek benötigt wird, um relevante für Nutzende zu erledigen.
Flottenverfolgung
Mit der JavaScript Fleet Tracking Library können Sie die Positionen
Fahrzeuge in ihren Flotten nahezu in Echtzeit nutzen. Die Bibliothek verwendet die
Fleet Engine API zur Visualisierung von Lieferfahrzeugen sowie
die ihnen zugewiesenen Aufgaben
zu erledigen. Wie das JavaScript-Consumer-SDK enthält auch dieses
Kartenkomponente, die ein Drop-in-Ersatz für ein Standard-google.maps.Map ist
Entität mit Datenkomponenten, mit denen Sie eine Verbindung zu Fleet Engine herstellen.
In dieser Bibliothek sehen Sie die Sichtbarkeit der Lieferfahrzeuge, sobald diese Fleet Engine erstellt haben. Für diese Implementierung verwenden Sie die Fleet Engine Dienst Super User und Sie stellen die Java Web Token-Anforderung für Zugang zu den Lieferfahrzeugen und die damit verbundenen Aufgaben.
Szenarien für geplante Aufgaben
In diesem Abschnitt werden verschiedene Aufgabenszenarien gezeigt, in denen die Informationen die an dieser Stelle des Leitfadens bereitgestellt werden. Sie soll Ihnen dabei helfen, verschiedene Möglichkeiten haben, Ihre Transportvorgänge in Fleet Engine zu modellieren, je nach Unternehmen.
Lieferung mit Sendungsverfolgung
Dieses Zustellungsszenario zeigt eine Aufgabe mit einem geplanten Stopp.
die dem Depot bei der Abfahrt vom Depot zu Beginn
und landen am Ende der Reise im Depot. Außerdem
zeigt zwei Lieferaufgaben für eine Haltestelle, von denen eine fehlgeschlagen ist. Verwenden
die Verfolgung vom und zum Depot sowie als Möglichkeit zur Modellierung
Start- und Endzeiten für den Tag auswählen. Keine Abrechnung
bei geplanten Stoppaufgaben.
Abholung mit Depotlieferung
Dieses Szenario zeigt, wie ein pickup mit seinen erforderliche Lieferaufgabe. Sie legen die Rückgabe an das Depot als Zustellung zu Abrechnungszwecken.
Zubringerfahrzeug
Dieses Szenario zeigt zwei Lieferungen mit einem geplanten Stopp in der Mitte Feeder Vehicle, mit dem das Lieferfahrzeug mit einer Reihe von Paketen zurück ins Depot. Ich das Feeder mit einer planmäßigen Haltestelle modellieren.
Aufgabentiming
Die Modellierung der Aufgabenzeiten hilft bei der effektiven Routenplanung, voraussichtliche Ankunftszeit und dem Management die Auslieferungserwartungen. Fleet Engine bietet zwei wichtige Funktionen zur Modellierung und den Zeitplan der Aufgaben vorherzusehen, wie in diesem Abschnitt beschrieben.
Aufgabendauer
Die Aufgabendauer wird mit dem Feld task_duration festgelegt. Dies ist ein Pflichtfeld, das
modelliert die erwartete Zeit, die der Fahrer an einer Haltestelle mit der Erledigung von Aufgaben verbringt.
oder dafür, eine Pause zu machen. Bei Haltestellen umfasst dies alle erforderlichen Aktivitäten.
nach der Ankunft an einer Haltestelle wie zum Beispiel Pakete entladen und mit der
Empfänger. Je spezifischer diese Informationen sind, desto besser kann Fleet Engine
realistische Ankunftszeiten und voraussichtliche Ankunftszeiten für nachfolgende Haltestellen auf der Fahrt angeben.
Details zu den Feldern finden Sie in der Dokumentation zu Protokollzwischenspeichern unter Dauer.
Zielzeitfenster
Die Zielzeit definiert einen vorgeschlagenen Zeitraum für eine Aufgabe. Sie wird normalerweise für
für die Kommunikation mit der Kundschaft
oder für interne Planungszwecke. Sie legen dies mit
Im Feld target_time_window, das aus einer Start- und einer Endzeit besteht
Diese Einstellung hat keinen direkten Einfluss auf die Routenberechnungen, könnte aber für
z. B. um einen Kunden über ein Zeitfenster für ein Paket zu informieren
oder den Zeitpunkt der Ankunft eines planmäßigen Service Workers.
Aufgabenattribute
Aufgabenattribute in Fleet Engine bieten eine bequeme Möglichkeit, Aufgaben nach
wenn Sie die ListTasks-Anfrage verwenden. Sie können auch
Benutzerdefinierte Aufgabenattribute für Analysen mit Cloud Logging sowie
bei der Weitergabe von Informationen zum Kaufprozess oder bei der Flottenverfolgung. Die
Der Zweck ist ähnlich wie bei Fahrzeugattributen: Verwenden Sie dieses Attribut, um eine bessere
Liefervorgänge fokussieren.
Einschränkungen
- Erstellen benutzerdefinierter Attribute: Fleet Engine begrenzt die Anzahl der benutzerdefinierten Attribute, die Sie pro Aufgabe definieren können. Wenden Sie sich an Ihren Vertriebsmitarbeiter, um Beantragen Sie eine Erhöhung dieser Limits.
- Filterfunktionen: Diese Filterfunktion bietet Flexibilität, Attribute ersetzen wichtige Aufgabendatenfelder nicht. Verwendungszweck zusätzliche Filteroptionen je nach Ihren Anforderungen.
- Jedes Attribut muss einen eindeutigen Schlüssel haben.
- Geben Sie keine personenidentifizierbaren Informationen oder andere vertrauliche Informationen an. im Attributwert enthalten, da diese für den Nutzer sichtbar sein können.
- Datenvalidierung: Stellen Sie sicher, dass die Datentypen und -formate Ihrer benutzerdefinierten -Attribute mit den Anforderungen von Fleet Engine kompatibel sind.