要素图层

ArcGIS Velocity 中的要素图层源类型轮询 ArcGIS OnlineArcGIS Server 要素图层以获取要素。

示例

以下是源的使用示例:

  • 用户配置了引用 ArcGIS Server 托管要素图层的源来加载用户添加的要素。
  • GIS 分析师提供 ArcGIS Server 要素图层的 URL(例如 https://sampleserver6.arcgisonline.com/arcgis/rest/services/Wildfire/FeatureServer/2)以进行分析,图层中包含每分钟要加载的所需要素。

用法说明

使用源时,请谨记以下内容:

  • 源将按照源配置向导的源轮询间隔步骤中定义的速率轮询要素图层以加载要素。
    • 时间戳字段值是用于获取最新要素的日期字段。 您可以在时间戳字段步骤中定义时间戳字段值。 如果未指定时间戳字段值,则要素图层源将在每个间隔将要素图层中的所有要素加载为要处理的事件。
    • 如果指定了时间戳字段值,则 Velocity 第一次轮询要素图层时,将加载时间戳 datetime 字段在过去一分钟内且早于第一个源轮询时间,同时满足 WHERE 子句条件的所有要素。 对于每次后续轮询,仅将加载时间戳字段值在最后一次轮询时间和当前轮询时间之间的满足 WHERE 子句条件的要素。
    • Velocity 要求以协调世界时间 (UTC) 存储时间戳值。 如果指定了时间戳值,但该值未以 UTC 格式存储,则轮询要素图层可能会返回意外数据。
  • 浏览以选择要素图层项目时,可以按文件夹、收藏夹、群组或组织进行过滤,也可以过滤 ArcGIS Online 中的要素。 然后,您可以按修改日期、创建日期和标签进一步过滤。
  • 也可以使用 URL 加载 ArcGIS Server 要素图层。 该 URL 应为 ArcGIS Server 服务目录的 REST URL(例如 https://sampleserver6.arcgisonline.com/arcgis/rest/services/Wildfire/FeatureServer/2)。 URL 末尾应为 /FeatureServer/#/MapServer/#,其中 # 为图层编号。
  • 要从 URL 加载安全要素图层,您必须首先从 URL 将服务或文档添加ArcGIS Online,然后选择存储凭据。 然后,您可以浏览到已注册的 ArcGIS Online 项目以选择安全要素图层。
  • 设置轮询频率后,轮询将以常规时钟的间隔进行,而不依据源的开始时间。 例如,如果将源设置为每 5 分钟轮询一次数据,并且在 8:03 a.m. 开始,则第一个数据请求将在 8:05 a.m. 发生,下一个在 8:10 a.m. 发生,依此类推。
  • 定义源轮询间隔时请格外小心。 必须确保您正在轮询的要素图层可以在指定的轮询间隔内返回响应。 最佳做法是使用源配置中的查询来测试对此要素图层的查询请求的响应时间。 请勿将轮询间隔设置为比要素图层查询的通常响应时间更短。 有关计划源轮询间隔的详细信息,请参阅源轮询间隔计划
  • 配置要素图层连接参数后,请参阅配置输入数据以了解如何定义方案和关键参数。

参数

以下是源的参数:

参数说明数据类型
Where 子句

WHERE 子句参数指定一个结构化查询语言 (SQL) 子句,用于过滤从指定要素图层加载的要素。 默认为加载所有使用 1=1 的要素。 可以修改默认的 WHERE 子句以包括特定的属性值和逻辑条件。

大多数要素图层都支持图层中字段上的 SQL 92 Where 子句语法。

Velocity 生成的在时空数据源上运行的要素图层对支持的内容有所限制;它们只支持 SQL-92 的一个子集。

下方列出了此类要素图层支持的 SQL-92:

  • ( '<=' | '>=' | '<' | '>' | '=' | '!=' | '<>' | LIKE )
  • (AND | OR)
  • (IS | IS_NOT)
  • (IN | NOT_IN) ( '(' ( expr ( ',' expr )* )? ')' )
  • COLUMN_NAME BETWEEN LITERAL_VALUE AND LITERAL_VALUE

您可以在过滤数据步骤中更新此参数。

QueryString

输出字段

输出字段参数指定要从要素图层加载到 Velocity 的字段。

默认值为星号 (*),表示加载的所有字段。

如果提供了特定字段,则应采用逗号分隔的字段名称列出,例如:

OBJECTID,device_id,timestamp,horizontal_accuracy,latitude,longitude

您可以在过滤数据步骤中更新此参数。

字符串

输出空间参考(可选)

输出空间参考参数可指定空间参考的熟知 ID (WKID)。 默认 WKID 为 4326

Velocity 将从此参数设置的空间参考中的要素图层加载数据。

您可以在过滤数据步骤中更新此参数。

字符串

其他日志记录

(可选)

指定是否打开对 Velocity 发出的原始请求的日志记录。 默认值为 False

注:

仅打开此参数以进行故障排除,并在完成故障排除时关闭。 在打开参数后启动源,信息级别日志即会出现在源日志页面上。 请联系 Esri 技术 支持 以获得故障排除方面的帮助。

布尔

时间戳字段

指定用于仅检索最新要素的日期字段。

如果未指定时间戳字段值,则源将在每个间隔将要素图层中的所有要素加载为要处理的事件。

如果已指定时间戳字段值,则当 Velocity 第一次轮询要素图层时,将加载 datetime 时间戳字段为过去一分钟内,且早于第一次源轮询时间,同时符合 WHERE 子句条件的所有要素。 每次后续轮询时,仅将加载时间戳字段值在最后一次轮询时间和当前轮询时间之间,同时符合 WHERE 子句条件的要素。

字符串

注意事项和限制

使用源时,请考虑以下事项:

  • 要素图层必须可以通过 Internet 访问。
  • 不应将轮询间隔设置为比要素图层查询的通常响应时间更短。
  • Velocity 不支持需要消耗配额以进行数据查询的图层。