Verwenden von Track-Funktionen

Mithilfe von Track-Funktionen können Sie Arcade-Ausdrücke mit Track-Eingaben in bestimmten ArcGIS Velocity-Werkzeugen erstellen und auswerten. Tracks sind sequenziell angeordnete Features mit einem als Track-ID angegebenen Feld (Track ID) und einem Start Time-Feld. Arcade-Track-Funktionen sind nur verfügbar, wenn Velocity innerhalb bestimmter Ausdrücke trackingfähiger Werkzeuge (Feld berechnen und Felder zuordnen) verwendet wird.

Weitere Informationen zu den einzelnen Track-Funktionen finden Sie unter Track-Funktionen in der ArcGIS Arcade-Dokumentation.

Die folgenden Track-Funktionen sind in ArcGIS Velocity verfügbar:

Beispiele

  • Zugriff auf die Entfernung, die vom Track-Ursprung bis zur aktuellen Beobachtung zurückgelegt wurde.
    • Dies geschieht unter Verwendung der Track-Funktion TrackCurrentDistance, die die Summe der zwischen den Beobachtungen zurückgelegten Entfernungen, von der ersten bis zur aktuellen Beobachtung, zurückgibt.
    • Diese Funktion wird wie z. B. TrackCurrentDistance(x) verwendet, wobei x das Feature der Untersuchung angibt.
    • Beispielszenario:
      • Ein Track hat sechs Features. Der Ausdruck gibt einen Wert für das aktuelle Feature im Track zurück.
        • Die Entfernung zwischen Feature 1 und Feature 2 beträgt 60 Meter.
        • Die Entfernung zwischen Feature 2 und Feature 3 beträgt 80 Meter.
        • Die Entfernung zwischen Feature 3 und Feature 4 beträgt 30 Meter.
        • Die Entfernung zwischen Feature 4 und Feature 5 beträgt 35 Meter
        • Die Entfernung zwischen Feature 5 und Feature 6 beträgt 25 Meter.
      • Das Ergebnis bei der Verarbeitung von Feature 3 wäre 140 (80 + 60).
  • Zugriff auf einen bestimmten Feldwert aus zwei Beobachtungen vor der aktuellen.
    • Dies geschieht unter Verwendung der Track-Funktion TrackFieldWindow, die ein Array mit Attributwerten aus dem angegebenen Feld für die angegebene Zeitspanne zurückgibt.
    • Diese Funktion wird wie z. B. TrackFieldWindow('fieldName', startIndex, endIndex)[x] verwendet
      • fieldName: Text: Der Name des Feldes, aus dem Werte zurückgegeben werden.
      • startIndex: Zahl: Der Index des Anfangs-Features. Das aktuelle Feature ist Index 0. Positive Werte repräsentieren Features, die in der Zukunft nach dem aktuellen Wert auftreten. Zum Beispiel ist Position 1 der nächste Wert im Array. Negative Zahlen repräsentieren Features, die in der Vergangenheit, also vor dem aktuellen Feature, liegen. Zum Beispiel ist -1 der vorherige Wert im Array.
      • endIndex: Zahl: Der Index des Features am Ende des Fensters. Das aktuelle Feature ist Index 0. Positive Werte repräsentieren Features, die in der Zukunft nach dem aktuellen Wert auftreten. Zum Beispiel ist Position 1 der nächste Wert im Array. Negative Zahlen repräsentieren Features, die in der Vergangenheit, also vor dem aktuellen Feature, liegen. Zum Beispiel ist -1 der vorherige Wert im Array.
    • Beispielszenario:
      • Der Track enthält ein Feld mit den sequenziell angeordneten Werten [10, 20, 30, 40, 50]. Die Geometrien der Features lauten [{x: 1, y: 1},{x: 2, y: 2} ,{x: null, y: null},{x: 4, y: 4}, {x: 5, y: 5}]. Der Ausdruck wird bei jedem Feature im Track ausgewertet. In den zurückgegebenen Ergebnissen ist das Start-Feature enthalten, das End-Feature aber nicht. Dieses Beispiel wird für das zweite Feature (20) ausgewertet und gibt verschiedene vorherige Werte (einschließlich -1) zurück.
      • Arcade-Syntax: var window = TrackFieldWindow('MyField', -2,-1)[0].
      • Ergebniswert: 10, da die Syntax [0] verwendet wurde, um den ersten Wert dieses Arrays abzurufen.
  • Zugriff auf die Geometrie des Features vor dem aktuellen Feature.
    • Dies geschieht unter Verwendung der Track-Funktion TrackGeometryWindow, die ein Array mit Geometrien für die angegebenen Zeitindizes zurückgibt.
    • Diese Funktion wird wie z. B. TrackGeometryWindow(startIndex, endIndex) verwendet
      • startIndex: Zahl: Der Index des Anfangs-Features. Das aktuelle Feature ist Index 0. Positive Werte repräsentieren Features, die in der Zukunft nach dem aktuellen Wert auftreten. Zum Beispiel ist Position 1 der nächste Wert im Array. Negative Zahlen repräsentieren Features, die in der Vergangenheit, also vor dem aktuellen Feature, liegen. Zum Beispiel ist -1 der vorherige Wert im Array.
      • endIndex: Zahl: Der Index des Features am Ende des Fensters. Das aktuelle Feature ist Index 0. Positive Werte repräsentieren Features, die in der Zukunft nach dem aktuellen Wert auftreten. Zum Beispiel ist Position 1 der nächste Wert im Array. Negative Zahlen repräsentieren Features, die in der Vergangenheit, also vor dem aktuellen Feature, liegen. Zum Beispiel ist -1 der vorherige Wert im Array.
    • Beispielszenario:
      • Der Track enthält ein Feld mit den sequenziell angeordneten Werten [10, 20, 30, 40, 50]. Die Geometrien der Features lauten [{x: 1, y: 1},{x: 2, y: 2} ,{x: null, y: null},{x: 4, y: 4}, {x: 5, y: 5}]. Der Ausdruck wird bei jedem Feature im Track ausgewertet. Für dieses Beispiel untersuchen wir Ergebnisse bei einer Auswertung für das dritte Feature (30). In den zurückgegebenen Ergebnissen ist das Start-Feature enthalten, das End-Feature aber nicht.
      • Arcade-Syntax: var window = TrackGeometryWindow(-2,2)
      • Ergebniswert: [{x: 1, y: 1},{x: 2, y: 2} ,{x: null, y: null},{x: 4, y: 4}]

Verwendungshinweise

  • Die Arcade-Track-Funktionen sind nur in den Werkzeugen Feld berechnen und Felder zuordnen verfügbar.
  • Das Testen von Arcade-Ausdrücken ist für Ausdrücke, die Track-Funktionen enthalten, aktuell nicht verfügbar. Konsultieren Sie die Track-Funktionen- und Arcade-Dokumentation, um sicherzustellen, dass ein Ausdruck gültig ist und die Typen der Rückgabewerte berücksichtigt werden.
  • Echtzeitanalysen können nicht auf zukünftige Track-Werte (x) zugreifen, da zukünftige Beobachtungen zum Zeitpunkt der Verarbeitung noch nicht in die Echtzeitanalyse eingegangen sind. Echtzeitanalysen können nur auf vorherige (-x) und aktuelle (0) Track-Werte zugreifen.
  • Vorherige Track-Werte können für bis zu 5 vorherige Features (-5) abgerufen werden
  • Beim Erstellen von Arcade-Ausdrücken, die Track-Funktionen verwenden, ist unbedingt zu berücksichtigen, welcher Datentyp (Array, Zeichenfolge, Zahl, Datum) von der Track-Funktion sowie von Ihrem Ausdruck zurückgegeben wird. Ziehen Sie die Dokumentation zu Track-Funktionen zurate, um zu ermitteln, welcher Datentyp von den einzelnen Track-Funktionen zurückgegeben wird.