Skip To Content

Verwenden von Arcade-Ausdrücken mit Feld berechnen

Die Toolbox GeoAnalytics-Werkzeuge enthält mehrere Werkzeuge, mit denen Sie einen Ausdruck anwenden können.

Die GeoAnalytics-Werkzeuge, die Ausdrücke verwenden, haben unterschiedliche Zwecke und weisen Beschränkungen bezüglich der Ausdrücke auf, die angewendet werden können. In Version 10.6 wird Arcade von allen in GeoAnalytics Server verwendeten Ausdrücken unterstützt.

Weitere Informationen zu Arcade-Funktionen

Ausdrücke in Feld berechnen

Im Werkzeug Feld berechnen dienen Ausdrücke zur Berechnung von Werten für das Feld. Bestimmen Sie mithilfe von Ausdrücken, wie jedes Feature gefüllt wird. Das Ergebnis eines Ausdrucks in "Feld berechnen" muss von demselben Typ wie das Feld sein. Die Abschnitte unten enthalten Beispiele für die Verwendung eines Ausdrucks.

Beispiele für mathematische Operatoren und Funktionen

Mit Ausdrücken können Zahlen mathematisch verarbeitet werden. In der folgenden Tabelle wird ein Beispiel für verfügbare Operationen gezeigt.

Weitere Informationen zu den in Arcade verfügbaren mathematischen Operationen und Funktionen

OperatorErklärungBeispielErgebnis

a + b

a plus b.

fieldname enthält den Wert 1,5

$feature["fieldname"] + 2,5

4,0

a - b

a minus b.

fieldname enthält den Wert 3,3

$feature["fieldname"] - 2,2

1,1

a * b

a mal b.

fieldname enthält den Wert 2,0

$feature["fieldname"] * 2,2

4,4

a / b

a dividiert durch b.

fieldname enthält den Wert 4,0

$feature["fieldname"] / 1,25

3,2

abs( a )

Gibt den absoluten (positiven) Wert von a zurück.

fieldname enthält den Wert -1,5

abs($feature["fieldname"])

1,5

log( a )

Gibt den natürlichen Logarithmus (Basis e) von a zurück.

fieldname enthält den Wert 1

log($feature["fieldname"])

0

sin( a )

Gibt den trigonometrischen Sinus von a zurück. Von der Eingabe wird angenommen, dass es sich um einen Winkel in Radiant handelt.

fieldname enthält den Wert 1,5707

sin($feature["fieldname"])

1

cos( a )

Gibt den trigonometrischen Cosinus von a zurück. Von der Eingabe wird angenommen, dass es sich um einen Winkel in Radianten handelt.

fieldname enthält den Wert 0

cos($feature["fieldname"])

1

tan( a )

Gibt den Tangens von a zurück. Von der Eingabe wird angenommen, dass es sich um einen Winkel in Radiant handelt.

fieldname enthält den Wert 0

tan($feature["fieldname"])

0

sqrt( a )

Gibt die Quadratwurzel von a zurück.

fieldname enthält den Wert 9

sqrt($feature["fieldname"])

3

min( a, b )

Gibt von a und b die Zahl mit dem niedrigsten Wert zurück.

fieldname enthält den Wert 1,5 und den Wert -3

min($feature["fieldname"], -3)

-3

max( a, b )

Gibt von a oder b die Zahl mit dem höchsten Wert zurück.

fieldname1 enthält den Wert 1,5, und fieldname2 enthält den Wert -3

max($feature["fieldname1"], $feature["fieldname2"])

1,5

constrain(<value>,<low>,<high>)

Gibt den Eingabewert zurück, sofern dieser innerhalb der Grenzwerte liegt. Wenn der Eingabewert kleiner als der niedrige Wert ist, wird der niedrige Wert zurückgegeben. Wenn der Eingabewert größer als der hohe Wert ist, wird der hohe Wert zurückgegeben.

constrain($feature["distance"], 0, 10)

constrain($feature['Store dist'], 6, distance)

Gibt 0 zurück, wenn distance kleiner als 0 ist, 10, wenn distance größer als 10 ist, und ansonsten distance.

Gibt 6 zurück, wenn Store dist kleiner als 6 ist, distance, wenn Store dist größer als distance ist, und ansonsten Store dist.

Multiplikationsbeispiel für das Berechnen eines Feldwertes.

$feature["Distance"] * 2

Beispiele für Textfunktion

Mit Ausdrücken von "Feld berechnen" kann Text verarbeitet werden. In der folgenden Tabelle wird ein Beispiel für verfügbare Operationen gezeigt.

Weitere Informationen zu den in Arcade verfügbaren Textfunktionen

OperatorErklärungBeispielErgebnis

concatenate( <Werte>, <Trennzeichen>)

Verbindet Werte und gibt eine Zeichenfolge zurück.

  • values: Eine Reihe zu verkettender Zeichenfolgenwerte.
  • separator (optional): Für die Verbindung zu verwendendes Trennzeichen, wenn der Parameter values ein Array ist, oder eine zu verbindende Zeichenfolge, wenn ein Einzelwert für den ersten Parameter angegeben wird. Wenn nicht angegeben, bleibt er leer.

fieldname enthält einen Wert von GeoAnalytics

Concatenate ([$features["fieldname"], "is", "great!"], ' ')

GeoAnalytics is great!

find(<searchText>, <text>, <startPos>)

Sucht eine Zeichenfolge in einer Zeichenfolge. Platzhalter werden nicht unterstützt.

  • searchText: Die zu suchende Unterzeichenfolge.
  • text: Der zu durchsuchende Text.
  • startPos (optional): Der nullbasierte Index der Position in der Zeichenfolge, von der aus gesucht werden soll.

fieldname1 enthält den Wert 14NorthStreet, und fieldname2 enthält den Wert North

find($feature["fieldname2"], $feature["fieldname1"])

2

lower(<Wert>)

Ändert eine Zeichenfolge in Kleinbuchstaben.

  • value: Die Zeichenfolge, die in Kleinbuchstaben erstellt werden soll.

fieldname enthält einen Wert von GEOANALYTICS

lower($feature["fieldname"])

GeoAnalytics

Textbeispiel mit find und lower.

find(("north"), lower("146NorthStreet"))

Beispiele für Datumsfunktionen

Mit Ausdrücken vom Typ "Feld berechnen" können Datumswerte verarbeitet werden. In der folgenden Tabelle wird ein Beispiel für verfügbare Operationen gezeigt.

Weitere Informationen zu den in Arcade verfügbaren Datumsfunktionen

In Arcade ist der Wertebereich für Monate 0 (Januar) bis 11 (Dezember), für Tage 1 bis 31, für Stunden 0 (12:00 Uhr) bis 23 (11:00 Uhr), für Minuten und Sekunden 0 bis 59 und für Millisekunden 0 bis 999. In Arcade werden Uhrzeitwerte für den Standort des GeoAnalytics Server zurückgegeben.

OperatorErklärungBeispielErgebnis

date( <Wert>, <Monat>, <Tag>, <Stunde>, <Minute>)

Gibt einen Wert oder einen Satz von Werten als Datumszeichenfolge aus.

  • value (optional): Entweder die Anzahl von Millisekunden seit dem 1. Januar 1970 UTC oder eine Zahl, die ein Jahr darstellt. Wenn ein Jahr angegeben wird, müssen in nachfolgenden Parametern auch der Monat und der Tag angegeben werden. Dieser Wert kann auch eine Datumszeichenfolge oder ISO 8601-Zeichenfolge sein, die in ein Datum konvertiert werden soll.
  • month (optional): Der Monat (0-11), wobei 0 Januar und 11 Dezember ist.
  • day (optional): Der Tag des Monats (1-31).
  • hour (optional): Die Stunde des Tages (0-23).
  • minute (optional): Die Minute der Stunde (0-59).
  • second (optional): Die Sekunde der Minute (0-59).
  • millisecond (optional): Die Millisekunde der Sekunde (0-999).

fieldname enthält einen Wert von 1476987783555

Beispiel 1: Date($features["fieldname"])

Beispiel 2: Date(2017,0,14,0)

Beispiel 3: Date()

Beispiel 1: 20 Oct 2016 11:23:03 am

Beispiel 2: 14 Jan 2017 12:00:00 am

Beispiel 3: Gibt die aktuelle Uhrzeit zurück.

DateDiff(<Datum1>, <Datum2>, <Einheiten>)

Subtrahiert zwei Datumsangaben und gibt die Differenz in den angegebenen Einheiten zurück.

  • date1: Der Datumswert, von dem ein zweites Datum subtrahiert werden soll.
  • date2: Der Datumswert, der vom ersten angegebenen Datum subtrahiert werden soll.
  • startpos (optional): Die Einheiten, in denen die Differenz der beiden angegebenen Datumsangaben zurückgegeben werden soll. Die folgenden Einheitentypen werden unterstützt: milliseconds, seconds, minutes, hours, days, months und years. Der Standardwert ist Millisekunden.

Beispiel 1: DateDiff(Date(2017,1,14,0), Date())

Beispiel 2: DateDiff(Date(2017,1,14,0), Date(), "Years")

Das Ergebnis variiert abhängig vom Zeitpunkt, an dem Sie diesen Befehl ausführen.

Beispiel 1: -20532129137

Beispiel 2: -0.6546783768647119

Year(<Datumswert>)

Gibt das Jahr des angegebenen Datums zurück.

  • value: Ein Datumswert, aus dem das Jahr abgerufen werden soll.

Beispiel 1: fieldname ist ein Feld vom Typ Date mit dem Wert 09 Oct 2017 04:30:43 pm

Year($feature["fieldname"])

Beispiel 2: fieldname ist ein als ISO 8601-Zeichenfolge formatiertes Zeichenfolgenfeld mit dem Wert 2012-09-27.

Beispiel 1: 2017

Beispiel 2: 2012

Konditionale Operatoren

Konditionale Anweisungen können für die folgenden Operatoren verwendet werden:

OperatorErklärungBeispielErgebnisse

a > b

a < b

a ist größer als b

a ist kleiner als b

10 > 2

False

a >= b

a <= b

a ist größer als oder gleich b

a ist kleiner als oder gleich b

abs(-10) >= 10

True

a != b

a ist ungleich b

abs(-3) != -3

True

a == b

a ist gleich b

abs(-5) == 5

True

<Bedingung1> || <Bedingung2>

Bedingung 1 oder Bedingung 2 ist erfüllt.

(abs(-5) == 5) || (10 < 2)

True

<Bedingung1> && <Bedingung2>

Bedingung 1 und Bedingung 2 sind erfüllt.

(abs(-5) == 5) && (10 < 2)

False

Beispiele für logische Operatoren

Zusätzlich zu konditionalen Operatoren können für die Berechnung von Feldern auch erweiterte logische Operatoren verwendet werden.

Weitere Informationen zu den in Arcade verfügbaren logischen Funktionen

FunktionErklärungBeispielErgebnis

iif(<condition>,<true value>,<false value>)

Gibt einen Wert zurück, wenn eine Bedingungsauswertung true ergibt, und einen anderen Wert, wenn die Bedingungsauswertung false ergibt.

<true value> und <false value> können Folgendes sein:

  • Ein numerisches Feld. Verwenden Sie eckige Klammern, wenn der Feldname ein Leerzeichen enthält.
  • Eine Zahl.
  • Eine Funktion.

iif($feature["field1"] > $feature["field2"], $feature["field1"], 0)

iif($feature["field1"] > $feature["field2"], iif($feature["field2"] = 0, $feature["field3"], $feature["field4"]), 0)

Gibt field1 zurück, wenn field1 größer als field2 ist, und ansonsten 0.

Gibt das Ergebnis der zweiten iif-Funktion zurück, wenn field1 größer als field2 ist, und ansonsten 0.

when(<expression1> , <result1> , <expression2> , <result2> , ... , <expressionN> , <resultN>, <default>)

Wertet nacheinander eine Reihe von Ausdrücken aus, bis eine Auswertung true ergibt.

  • expression: Ein Ausdruck.
  • result: Kann eine Zahl oder ein Feld sein.
  • default: Ein optionaler Wert, wenn keiner der Ausdrücke übereinstimmt.

when(($feature["field1"] + 10) > 1, 1,($feature["field2"] + 10) > 2 , 2, $feature["field3"])

Wenn field1 + 10 größer als 1 ist, wird 1 zurückgegeben. Falls nicht, wird überprüft, ob field2 + 10 größer als 2 ist. Falls ja, wird 2 zurückgegeben. Falls nicht, wird field3 zurückgegeben.

decode(<conditional val> , <case1> , <result1>, <case2>, <result2>, ... <caseN>, <resultN>, <defaultValue> )

Die Funktion decode wertet einen Ausdruck aus und vergleicht dessen Wert mit nachfolgenden Parametern. Wenn der Ausdruck übereinstimmt, wird der nächste Parameterwert zurückgegeben. Gibt es keine Übereinstimmung, kann der letzte Parameter als Standardrückgabewert verwendet werden.

  • conditional val: Kann ein Feld oder ein Ausdruck sein.
  • case: Ein Wert, der mit conditional val verglichen werden soll.
  • result: Das Ergebnis, wenn der entsprechende Fall mit conditional val übereinstimmt.
  • defaultValue: Ein optionaler Wert, wenn kein anderer Wert true ist.

decode($feature["field1"] + 3 , $feature["field1"], 1, $feature["field2"], 2, 0)

Überprüft den conditional val field1 + 3 und case1 field1 auf Gleichheit. Bei true wird 1 zurückgegeben. Bei false werden field1 + 3 und field2 auf Gleichheit überprüft. Bei true wird 2 zurückgegeben; ansonsten 0.

Beispiele für Tracking-bezogene Ausdrücke

Zudem können in einigen GeoAnalytics-Werkzeuge, z. B. "Ereignisse ermitteln" und "Feld berechnen", Tracking-bezogene Gleichungen in Arcade verwendet werden. In "Feld berechnen" können Tracking-Gleichungen verwendet werden, wenn im Eingabe-Layer Zeiteigenschaften aktiviert sind. Der Ausdruck ist Tracking-bezogen ist aktiviert, und es wird mindestens ein Feld zum Identifizieren von Spuren bestimmt.

FunktionErklärungBeispielErgebnis

TrackStartTime()

Berechnet die Startzeit eines Tracks in Millisekunden von der Unixzeit.

Verwendet wird ein Track, der am 2. Januar 2017 startet.

TrackStartTime()

1483315200000

TrackDuration()

Berechnet die Dauer eines Tracks in Millisekunden vom Start bis zum aktuellen Zeitschritt.

Verwendet wird ein Track, der am 2. Januar 2017 startet; die aktuelle Zeit ist 4. Januar 2017.

TrackDuration()

172800000

TrackCurrentTime()

Berechnet die aktuelle Uhrzeit in einem Track.

Verwendet wird ein Feature, das am 3. Januar 2017 um 9:00 Uhr auftritt.

TrackCurrentTime()

1483315200000

TrackIndex

Gibt den Zeitindex des berechneten Features zurück.

Die Berechnung dieses Wertes für das erste Feature in einem Track.

TrackIndex

0

TrackFieldWindow(<fieldName>, <startIndex>, <endIndex>)

Gibt ein Array aus Werten im angegebenen Feld für den angegebenen Zeitindex zurück. Die Funktion "window" ermöglicht die Vorwärts- oder Rückwärtsbewegung in der Zeit. Der Ausdruck wird bei jedem Feature im Track ausgewertet.

  • Das aktuelle Feature befindet sich bei 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 vor dem vorherigen Feature auftreten. Zum Beispiel ist -1 der vorherige Wert im Array.

MyField enthält die sequenziell angeordneten Werte [10, 20, 30, 40, 50]. Der Ausdruck wird bei jedem Feature im Trackausgewertet. In den zurückgegebenen Ergebnissen ist das Start-Feature enthalten, das End-Feature aber nicht.

Beispiel 1:TrackFieldWindow("MyField,-1,2)

Beispiel 2:TrackFieldWindow("MyField,-2,0)[0]

Beispiel 3:TrackFieldWindow("MyField,0,3)[2]

Beispiel 1: Nach Auswertung bei jedem Feature enthält die Tabelle die folgenden Ergebnisse.

Ausgewertetes Feature

Ergebnis

10

[10,20]

20

[10, 20, 30]

30

[20,30,40]

40

[30,40,50]

50

[40, 50]

Beispiel 2: Nach Auswertung bei Index 2 (Wert: 30) lautet das Ergebnis: 10.

Beispiel 3: Nach Auswertung bei Index 2 (Wert: 30) lautet das Ergebnis: 50.

TrackGeometryWindow(<startIndex>, <endIndex>)

Gibt ein Array aus Werten zur Darstellung der Geometrie für den angegebenen Zeitindex zurück. Die Funktion "window" ermöglicht die Vorwärts- oder Rückwärtsbewegung in der Zeit. Der Ausdruck wird bei jedem Feature im Track ausgewertet.

  • Das aktuelle Feature befindet sich bei 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 vor dem vorherigen Feature auftreten. Zum Beispiel ist -1 der vorherige Wert im Array.

MyField enthält die sequenziell angeordneten Werte [10, 20, 30, 40, 50]. Die Geometrie der Features lautet [{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.

Beispiel 1:TrackGeometryWindow(-1,2)

Beispiel 2: TrackGeometryWindow(0,1)[0] für ein Polylinien-Dataset

Beispiel 3: TrackGeometryWindow(0,1)[0] für ein Polygon-Dataset

Beispiel 4: Finde den X-Wert des vorherigen Punktes TrackGeometryWindow(-1,0)[0]["x"]

Beispiel 1: Nach Auswertung bei jedem Feature enthält die Tabelle die folgenden Ergebnisse.

Ausgewertetes Feature

Ergebnis

10

[{x: 1, y: 1},{x: 2, y: 2}]

20

[{x: 1, y: 1},{x: 2, y: 2} ,{x: null, y: null}]

30

[{x: 2, y: 2} ,{x: null, y: null},{x: 4, y: 4}]

40

[{x: null, y: null},{x: 4, y: 4}, {x: 5, y: 5}]

50

[{x: 4, y: 4}, {x: 5, y: 5}]

Beispiel 2: Polylinien werden im folgenden Format zurückgegeben: [{"paths":[[[-180,-22.88],[-177.6,-23.6]],[[180,-18.099999999999994],[179.7,-18.4],[179.4,-18.7],[178.9,-18.9],[178.5,-19.3],[178.2,-19.7],[178.4,-20],[178.8,-20.2],[178.9,-21.8],[179,-22.2],[179.4,-22.7],[180,-22.88]],[[-178,-17],[-178.8,-17.3],[-179.2,-17.5],[-179.6,-17.8],[-179.9,-18],[-180,-18.099999999999994]]]}]

Beispiel 3: Polygone werden im folgenden Format zurückgegeben: [{"rings":[[[-7882559.1197999995,6376090.883500002],[-7893142.474300001,6042715.216800004],[-8544018.775999999,6045361.0554000065],[-8544018.775999999,6376090.883500002],[-7882559.1197999995,6376090.883500002]]]}]

Beispiel 4: Nach Auswertung bei Index 2 (Wert: 30): 2

TrackWindow(<value1>, <value2>)

Gibt ein Array aus Werten zur Darstellung der Geometrie und allen Attributen für den angegebenen Zeitindex zurück. Die Funktion "window" ermöglicht die Vorwärts- oder Rückwärtsbewegung in der Zeit.

  • Das aktuelle Feature befindet sich bei 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 vor dem vorherigen Feature auftreten. Zum Beispiel ist -1 der vorherige Wert im Array.

MyField enthält die sequenziell angeordneten Werte [10, 20, 30, 40, 50] zusätzlich zu den Feldern objectID, globalID und instant_datetime. Die Geometrie der Features lautet [{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.

Beispiel 1:TrackWindow(-1,0)[0]

Beispiel 2:geometry(TrackWindow(-1,0)[0]["x"]

Beispiel 1: Nach Auswertung bei jedem Feature enthält die Tabelle die folgenden Ergebnisse.

Ausgewertetes Feature

Ergebnis

10

20

[{"geometry": {x: 1, y: 1}},{"attributes": {"MyField" : 10, "trackName":"ExampleTrack1"}}]

30

[{"geometry": {x: 2, y: 2}},{"attributes": {"MyField" : 20, "trackName":"ExampleTrack1"}}]

40

[{"geometry": {x: null, y: null}},{"attributes": {"MyField" : 30, "trackName":"ExampleTrack1"}}]

50

[{"geometry": {x: 4, y: 4}},{"attributes": {"MyField" : 40, "trackName":"ExampleTrack1"}}]

Beispiel 2: Nach Auswertung bei Index 2 (Wert: 30): 2