Skip To Content

使用包含检测事件的 Arcade 表达式

GeoAnalytics 工具 工具箱中提供多个工具以应用表达式。

GeoAnalytics 工具 可使用表达式,它具有不同的用法以及对应用表达式的限制。在 10.6.1 版本中,ArcGIS GeoAnalytics Server 中使用的所有表达式都支持 Arcade。

了解有关 Arcade 函数的详细信息

检测事件中的表达式

将表达式用于检测事件工具中来指定事件开始和结束的条件。检测事件条件必须始终生成 truefalse 结果。使用条件来检查要素是否应该包含在事件中。将测试每个要素的条件,以确定哪些要素为事件。在 ArcGIS GeoAnalytics Server 上运行分析时会执行计算。可以使用的表达式示例包含在以下部分中。

数学运算符和函数示例

表达式能够利用数学方式处理数字。下表显示了可用运算的示例。

了解有关 Arcade 中可用数学运算和函数的详细信息

运算符说明示例结果

a + b

a 加 b。

fieldname 包含数值 1.5

$feature["fieldname"] + 2.5

4.0

a - b

a 减 b。

fieldname 包含数值 3.3

$feature["fieldname"]- 2.2

1.1

a * b

a 乘以 b。

fieldname 包含数值 2.0

$feature["fieldname"] * 2.2

4.4

a / b

a 除以 b。

fieldname 包含数值 4.0

$feature["fieldname"] / 1.25

3.2

abs( a )

返回 a 的绝对(正)值。

fieldname 包含数值 -1.5

abs($feature["fieldname"])

1.5

log( a )

返回 a 的自然对数(以 E 为底)。

fieldname 包含数值 1

log($feature["fieldname"])

0

sin( a )

返回 a 的三角正弦值。假设输入为以弧度为单位的角。

fieldname 包含数值 1.5707

sin($feature["fieldname"])

1

cos( a )

返回 a 的三角余弦值。假设输入为以弧度为单位的角。

fieldname 包含数值 0

cos($feature["fieldname"])

1

tan( a )

返回 a 的正切值。假设输入为以弧度为单位的角。

fieldname 包含数值 0

tan($feature["fieldname"])

0

sqrt( a )

返回 a 的平方根。

fieldname 包含数值 9

sqrt($feature["fieldname"])

3

min( a, b )

返回 a 和 b 间的最小数值。

fieldname 包含数值 1.5 和 -3

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

-3

max( a, b )

返回 a 或 b 间的最大数值。

fieldname1 包含数值 1.5,fieldname2 包含数值 -3

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

1.5

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

如果结果在限制范围内,则返回输入值。如果输入值小于低值,则返回低值。如果输入值大于高值,则返回高值。

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

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

如果 distance 小于 0,则返回 0,如果 distance 大于 10,则返回 10,其余情况下返回 distance

如果 Store dist 小于 6,则返回 6,如果 distance 大于 Store dist,则返回 distance,其余情况下返回 Store dist

用于检测事件的条件的乘法示例。

$feature["Distance"] * 2 > 50

文本函数示例

检测事件表达式能够处理文本。下表显示了可用运算的示例。

了解有关 Arcade 中可用文本函数的详细信息

运算符说明示例结果

concatenate( <values>, <separator>)

将值连接在一起,然后返回字符串。

  • values - 要连接的字符串值的数组。
  • separator(可选)- 如果 values 参数为数组,则为用于连接的分隔符;如果为第一个参数提供单个值,则为要连接的字符串。如果未提供,则其将为空。

fieldname 包含数值 GeoAnalytics

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

GeoAnalytics is great!

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

在字符串中查找某一字符串。不支持通配符。

  • searchText - 要搜索的子字符串。
  • text - 要搜索的文本。
  • startPos(可选)- 要在其中进行搜索的字符串中基于零的位置索引。

fieldname1 包含数值 14NorthStreetfieldname2 包含数值 North

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

2

lower(<value>)

将字符串转换为小写形式。

  • value - 要转换为小写形式的字符串。

fieldname 包含数值 GEOANALYTICS

lower($feature["fieldname"])

GeoAnalytics

使用 findlower 的文本示例。

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

日期函数示例

可以使用日期表达式中的检测事件。下表显示了可用运算的示例。

了解有关 Arcade 中可用日期函数的详细信息

在 Arcade 中,月份值范围从 0(1 月)到 11(12 月)、日期从 1 到 31、小时从 0(上午 12:00)到 23(下午 11:00)、分和秒从 0 到 59 以及毫秒从 0 到 999。Arcade 日期在您的 GeoAnalytics Server 位置返回时间值。

运算符说明示例结果

date( <value>, <month>, <day>, <hour>, <minute>)

将值或值集解析成日期字符串。

  • value(可选)- 自 1970 年 1 月 1 日 (UTC) 以来的毫秒数。还可以是代表年的数字。如果指定了某一年,则也必须在后续参数中提供月和日。该值可以是日期字符串或者是待转换成日期的 ISO 8601 字符串。
  • month(可选)- 月份 (0-11),其中 0 是一月,11 是十二月。
  • day(可选)- 一月中的某天 (1-31)。
  • hour(可选)- 一天中的某小时 (0-23)。
  • minute(可选)- 一小时中的某分钟 (0-59)。
  • second(可选)- 一分钟中的某秒 (0-59)。
  • millisecond(可选)- 一秒中的某毫秒 (0-999)。

fieldname 包含数值 1476987783555

示例1:Date($features["fieldname"])

示例 2:Date(2017,0,14,0)

示例 3:Date()

示例 1:20 Oct 2016 11:23:03 am

示例 2:14 Jan 2017 12:00:00 am

示例 3:返回当前时间

DateDiff(<date1>, <date2>, <units>)

将两个日期相减,并以指定的单位返回差值。

  • date1 - 从中减去第二个日期的日期值。
  • date2 - 要从第一个给定日期中减去的日期值。
  • startpos(可选)- 返回两个给定日期差值的单位。受支持的单位类型包括 millisecondssecondsminuteshoursdaysmonthsyears。默认值为毫秒。

示例 1:DateDiff(Date(2017,1,14,0), Date())

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

产生的结果会随运行此命令的时间而变化。

示例 1:-20532129137

示例 2:-0.6546783768647119

Year(<dateValue>)

返回给定日期中的年份。

  • value - 从中获取年份的日期值。

示例 1:fieldname 是一个值为 Date09 Oct 2017 04:30:43 pm 类型的字段

Year($feature["fieldname"])

示例 2:fieldname 是一个值为 2012-09-27 的 ISO 8601 字符串格式的字符串字段

示例 1:2017

示例 2:2012

条件运算符

条件语句可使用以下运算符:

运算符说明示例结果

a > b

a < b

a 大于 b

a 小于 b

10 > 2

False

a >= b

a <= b

a 大于或等于 b

a 小于或等于 b

abs(-10) >= 10

True

a != b

a 不等于 b

abs(-3) != -3

True

a == b

a 等于 b

abs(-5) == 5

True

<condition1> || <condition2>

满足条件 1 或条件 2。

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

True

<condition1> && <condition2>

满足条件 1 和条件 2。

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

False

逻辑运算符示例

除了条件运算符之外,还可以将更多高级逻辑运算符与检测事件配合使用。

了解有关 Arcade 中可用逻辑函数的详细信息

功能说明示例结果

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

如果条件的求值结果是 true,则返回一个值,如果条件的求值结果是 false,则返回其他值。

<true value><false value> 可为以下内容:

  • 数值字段。如果字段名称中含有空格,请使用方括号。
  • 数值。
  • 函数。

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

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

如果 field1 大于 field1,则返回 field2,其余情况下返回 0

如果 iff 大于 field1,则返回第二个 field2 函数的结果,其余情况下返回 0

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

依次对一系列表达式执行求值,直到求值结果为 true

  • expression - 表达式。
  • result - 可以为数值或字段。
  • default - 表达式均不匹配时的可选值。

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

如果 field1 + 10 大于 1,则返回 1。否则,检查 field2 + 10 是否大于 2。如果大于 2,则返回 2。否则,将返回 field3

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

decode 函数将对表达式进行求值并将其值与后续参数进行比较。如果表达式匹配,则返回下一个参数值。如果均不匹配,则可以选择将最后一个参数作为默认返回值。

  • conditional val - 可以为字段或表达式。
  • case - 要与 conditional val 进行对比的值。
  • result - 相应实例与 conditional val 匹配时的结果。
  • defaultValue - 其他值均不是 true 时的可选值。

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

比较 conditional val field1 + 3 和 case1 field1 是否相等。如果 true,则返回 1。如果 false,则比较 field1 + 3field2 是否相等。如果 true,则返回 2;否则,返回 0。

跟踪感知型示例

此外,一些 GeoAnalytics 工具(例如“检测事件”和“计算字段”)也可以使用 Arcade 形式的跟踪感知型方程。

功能说明示例结果

$track.field["fieldname"].history(<value1>)

在指定字段中返回指定时间索引的值数组。

  • 一个正数返回一个从给定索引开始直到当前要素的数组。
  • 负数返回当前时间步长和之前的 <value1> - 1 时间步长值。

MyField 已对 [10, 20, 30, 40, 50, 60, 70, 80] 的值进行排序。值 10 位于索引 0 处,值 80 位于索引 7 处。表达式在每个索引处求值,示例概述了用于示例的索引。n 表示序列中的要素数,k 表示正在求值的索引。

示例 1:$track.field["MyField"].history(3))

示例 2:$track.field["MyField"].history(-3)

示例 3:mean($track.field["MyField"].history(-2))

示例 4:$track.field["MyField"].history(-3)[0]

当示例 1 在索引 k 处求值时,它将返回索引 3 到 k 的值数组。如果在索引 6 处求值 (70),将返回索引 [3,4,5,6] 处的值数组,因此,数组为 [40, 50, 60, 70]

示例 2 返回的值数组,其计算方法为索引 k 减去给定值再减 1 (k-2)。如果在索引 6 (value = 70) 处求值,将返回 k-2k-1k 的值 [50, 60, 70]

示例 3 返回位于索引 k-1 处和 k 处的值的平均数。如果在索引 4 (value = 50) 处求值,会发现 value 50 (索引 3) 和 value 60 (索引 4) 的平均值等于 65。如果在索引 7 处求值,结果将为 70 和 80 的平均值,即 75

示例 4 返回在示例 2 中创建的数组的首个项目(索引 0):50

$track.field["fieldname"].history(<value1>, <value2>)

返回起自 index1 (<value1>) 终至 index2 (<value2>) 的值数组。

MyField已对 [10, 20, 30, 40, 50, 60, 70, 80] 的值按顺序排列。10 位于索引 0 处,80 位于索引 7 处。本例的表达式求值结果位于索引 7 (80) 处。

示例 1:$track.field["MyField"].history(-3, -2))

示例 2:$track.field["MyField"].history(-5, -2))

示例 1:[60]

示例 2:[40, 50, 60]

$track.time.start

计算轨迹的起始时间,以从新纪元开始的微秒为单位。

使用 2017 年 1 月 2 日起始的轨迹。

$track.time.start

1483315200000

$track.time.duration

计算轨迹从起始到当前时间步长的持续时间,以微秒为单位。

使用 2017 年 1 月 2 日起始、当前时间为 2017 年 1 月 4 日的轨迹。

$track.time.duration

172800000

$track.time.current

计算轨迹的当前时间。

使用发生于 2017 年 1 月 3 日 9:00 a.m. 的要素。

$track.time.current

1483434000000

$track.index

返回正在计算的要素的时间索引。

根据轨迹中的第一个要素计算此值。

$track.index

0

$track.T(<value>, "<units>")

返回要素时间以及使用数字 <value> 和给定 <units> 创建的时间。

  • value - 要添加到要素时间的数值。
  • units - 数值 <value> 的单位。受支持的单位类型为毫秒、秒、分钟、小时、天、月和年。默认值为毫秒。

使用 2017 年 1 月 2 日 2 p.m. 的要素。

示例 1:$track.T(1, "hours")

示例 2:$track.T(-2, "days")

示例 1:返回 1 月 2 日 3 p.m.:1483369200000

示例 2:返回 12 月 31 日 2 p.m.:1483192800000

$track.field["fieldname"].window(<value1>, <value2>)

在指定字段中返回指定时间索引的值数组。窗口功能可用于前进和后退时间。表达式在轨迹的各个要素处求值。

  • 当前要素位于索引 0 处。
  • 正值代表当前值后的未来发生的要素。例如,位置 1 是数组中的下一个值。
  • 负值代表上一要素之前发生的要素。例如,-1 是数组中的上一个值。

窗口功能可用于 ArcGIS Enterprise 10.6.1 版本。

MyField 已对 [10, 20, 30, 40, 50] 的值进行排序。表达式在轨迹的各个要素处求值。返回的结果包括开始要素,但不包括结尾要素。

示例 1:$track.field["MyField"].window(-1,2)

示例 2:$track.field["MyField"].window(-2,0)[0]

示例 3:$track.field["MyField"].window(0,3)[2]

示例 1:在各个要素处求值时,表格显示以下结果。

求值的要素

结果

10

[10,20]

20

[10, 20, 30]

30

[20,30,40]

40

[30,40,50]

50

[40, 50]

示例 2:在索引 2(值为 30)处求值时,返回:10

示例 3:在索引 2(值为 30)处求值时,返回:50

$track.geometry.window(<value1>, <value2>)

返回表示指定时间索引几何的值数组。窗口功能可用于前进和后退时间。表达式在轨迹的各个要素处求值。

  • 当前要素位于索引 0 处。
  • 正值代表当前值后的未来发生的要素。例如,位置 1 是数组中的下一个值。
  • 负值代表上一要素之前发生的要素。例如,-1 是数组中的上一个值。

窗口功能可用于 ArcGIS Enterprise 10.6.1 版本。

MyField 已对 [10, 20, 30, 40, 50] 的值进行排序。这些要素几何是 [{x: 1, y: 1},{x: 2, y: 2} ,{x: null, y: null},{x: 4, y: 4}, {x: 5, y: 5}]表达式在轨迹的各个要素处求值。返回的结果包括开始要素,但不包括结尾要素。

示例 1:$track.geometry.window(-1,2)

示例 2:折线数据集上的 $track.geometry.window(0,1)[0]

示例 3:折线数据集上的 $track.geometry.window(0,1)[0]

示例 4:查找上一点的 X 值 $track.geometry.window(-1,0)[0]["x"]

示例 1:在各个要素处求值时,表格显示以下结果。

求值的要素

结果

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}]

示例 2:以下列格式返回折线: [{"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]]]}]

示例 3:以下列格式返回面:[{"rings":[[[-7882559.1197999995,6376090.883500002],[-7893142.474300001,6042715.216800004],[-8544018.775999999,6045361.0554000065],[-8544018.775999999,6376090.883500002],[-7882559.1197999995,6376090.883500002]]]}]

示例 4:在索引 2(值为 20)处求值:1

$track.window(<value1>, <value2>)

返回表示指定时间索引几何和所有属性的值数组。窗口功能可用于前进和后退时间。

  • 当前要素位于索引 0 处。
  • 正值代表当前值后的未来发生的要素。例如,位置 1 是数组中的下一个值。
  • 负值代表上一要素之前发生的要素。例如,-1 是数组中的上一个值。

窗口功能可用于 ArcGIS Enterprise 10.6.1 版本。

除了 objectIDglobalIDinstant_datetime 字段之外,MyField 也对 [10, 20, 30, 40, 50] 的值进行排序。这些要素几何是 [{x: 1, y: 1},{x: 2, y: 2} ,{x: null, y: null},{x: 4, y: 4}, {x: 5, y: 5}]表达式在轨迹的各个要素处求值。返回的结果包括开始要素,但不包括结尾要素。

示例 1:$track.window(-1,0)[0]

示例 2:geometry($track.window(-1,0)[0]["x"]

示例 1:在各个要素处求值时,表格显示以下结果。

求值的要素

结果

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"}}]

示例 2:在索引 2(值为 20)处求值:1