追踪邻近事件 (GeoAnalytics Server 工具)

汇总

追踪在空间（位置）和时间上彼此邻近的事件。启用时间的点数据必须包含表示时刻的要素。

旧版本：

即将在 ArcGIS Enterprise 中弃用 ArcGIS GeoAnalytics Server 扩展模块。 GeoAnalytics Server 的最终版本已随 ArcGIS Enterprise 11.3 一同发布。可通过 ArcGIS Enterprise 11.3 及较早版本获取此地理处理工具。

插图

用法

以下是可以通过追踪邻近事件工具执行的用例的示例：
- 组织会监控公司下发给工作人员进行携带的设备。该公司想要确定哪些员工在已知患有新冠肺炎 (COVID-19) 的个人附近。借助表示设备位置和时间的点图层，公司可以标识距离感染者和其他可能感染员工 6 米和 5 分钟范围内的设备。
- NGO 正在使用 GPS 监控鲑鱼种群，并且想要追踪鲑鱼虱在逃逸的养殖鲑鱼和野生种群之间的传播。将追踪一些进行 GPS 示踪的养殖鲑鱼，以确定它们是否与示踪的野生种群紧密邻近，以及这些野生种群如何进一步传播这种疾病。测量还包括一个深度字段，以供 NGO 用于寻找相似深度的鱼群。
将在追踪邻近事件工具中使用以下术语：
- Entity—按周期记录位置的对象，例如动物、人或车辆。实体可以静止或移动。
- Entities of interest—用于开始追踪的特定实体，例如，感染了 COVID-19 的人员。
- Proximity event—两个实体彼此靠近的时间段，例如，两个人彼此相距 3 米和 1 分钟时间窗之内。
- Depth—感兴趣实体和追踪中更远的实体（下游）之间的分离度。例如，感兴趣实体与其他人之间的邻近事件为深度 1。
- Trace event—感兴趣实体下游的指定实体的第一联系人。
下面的逻辑示意图显示了追踪邻近事件工具如何处理数据。在这些逻辑示意图中，时间位于 x 轴上。

在每个逻辑示意图中，存在 4 个实体：A、B、C 和 D。突出显示的文本描述了两个实体（“自”实体和“至”实体）之间发生的追踪事件以及邻近事件的深度。在此示例中，实体 C 是正在向下游追踪的感兴趣实体。

在逻辑示意图 1 中，实体 C 是所选的感兴趣实体。深度为 0。

在逻辑示意图 2 中，实体 C 和 B 之间发生了邻近事件。追踪的深度为 1。如果多个要素是后续邻近事件，则这是一个持续的邻近事件。

在逻辑示意图 3 中，实体 B 和 A 之间发生了邻近事件。追踪的深度为 2。

在逻辑示意图 4 中，实体 C 和 D 之间发生了邻近事件。追踪的深度为 1。

在下图中，实体 B 是感兴趣实体，并且与实体 A 邻近 3 次，由蓝色圆圈表示。假设时间位于 x 轴上，则第一个邻近事件是 1，之后是接触中断，然后是邻近事件 2 和 3。该工具将返回事件 1 作为追踪事件。邻近事件 2 和 3 不会在输出邻近事件参数图层中返回。邻近事件 1 之后的所有要素都将在输出轨迹参数中返回。
要素必须同时满足空间搜索距离和时间搜索距离参数条件才能视为彼此邻近。

图 A：两个要素位于彼此的空间搜索距离内。

图 B：两个要素位于彼此的时间距离（时间搜索距离）内。
指定的时间搜索距离和空间搜索距离越大，生成的事件越多，并且处理结果所需的时间越长。距离越小，生成的事件越少，并且处理时间越短。
使用领域特定知识可确定用于空间搜索距离和时间搜索距离参数的值。设置距离时，请考虑设备准确性等因素。
定义感兴趣实体参数支持以下选项：
- 感兴趣实体 ID -此选项用于启用感兴趣实体 ID 参数，该参数需要实体 ID 值和可选开始时间时间值才能开始追踪。
- 指定感兴趣实体图层中的选定要素 -此选项用于启用感兴趣实体图层参数，该参数用于选择包含实体 ID 以及（可选）追踪的开始时间的图层。对于此图层，实体 ID 字段名称必须与输入图层中的实体 ID 字段名称匹配。如果该图层启用了时间，则将在该图层上使用时间。
感兴趣实体是开始邻域追踪的位置。如果指定了开始时间，则将从该时间开始对该实体进行追踪。如果未指定时间，则将从 1970 年 1 月 1 日开始对该实体进行追踪。
可以为邻近事件设置其他要求。例如，可以仅追踪校园中特定建筑物中的个人，也可以仅追踪建筑物的某一楼层内的个人。使用属性匹配条件参数可指定约束属性。例如，要约束同一楼层的实体，请指定 Floor 字段。
输出邻近事件图层将包含追踪中实体的第一个邻近事件，以及以下字段：
- from_id—上游实体 ID。
- to_id—下游实体 ID。
- depth—感兴趣实体与 to_id 字段之间的分离度。
- duration_minutes—追踪事件的持续时间，以分钟为单位。该字段计算为开始时间和结束时间之差。例如，1.5 分钟是 90 秒。值 0 表示只有一个邻近事件（开始时间和结束时间相同）。
- instant_datetime—邻近事件的日期和时间。该字段计算为满足邻近事件条件的第一个记录时间。
输出邻近事件图层可以使用时间滑块进行可视化或在链接图表中进行展示，以可视化追踪结果。
可以使用可选输出轨迹参数创建包含该实体的第一个追踪事件和所有后续要素的图层。这些结果有助于可视化实体的行驶位置并可在 重新构建轨迹 工具中使用。 输出轨迹参数将包含以下字段：
- entity_id—实体 ID。
- depth—感兴趣实体和追踪轨迹之间的分离度。单条轨迹沿线的深度相同。
- date—每个要素的日期。该日期将与输入要素中的记录的日期相同。
不会在结果中包含没有时间值、几何值或实体 ID 字段的输入点。
当使用邻域追踪来查找传播（例如疾病）时，请考虑以下几点：
- 存在追踪事件并不能保证已经发生传播；可能只是偶然遇到。
- 不存在追踪事件并不意味着尚未发生传播。在疾病等情况下，可能通过其他载体传播。
- 如果可能，使用属性匹配条件参数在必要时约束邻近事件。例如，使用属性约束房间、楼层或高程。
如果您希望计算所有邻近事件，而不希望从感兴趣实体向下游追踪，使用 连接要素 工具。
可执行以下一项或多项操作来提高追踪邻近事件工具的性能。
- 为空间搜索距离和时间搜索距离参数提供较小值。
- 使用属性匹配条件参数限制感兴趣实体。
- 指定最大追踪深度参数值，以限制给定实体和感兴趣实体的下游追踪数。
- 设置范围环境，以便仅分析感兴趣的数据。
- 使用与分析运行位置同属本地的数据。
运行 GeoAnalytics Server 工具时，分析将在 GeoAnalytics Server 上完成。要获得最佳性能，请通过在 ArcGIS Enterprise 门户上托管的要素图层或通过大数据文件共享，使 GeoAnalytics Server 可以访问数据。非 GeoAnalytics Server 本地的数据，将在分析开始前移动至 GeoAnalytics Server。这意味着运行工具需要更长时间，并且在某些情况下，从 ArcGIS Pro 到 GeoAnalytics Server 移动数据可能会失败。失败的阈值取决于网络速度，以及数据的大小和复杂性。建议您始终共享数据或创建大数据文件共享。

了解有关将数据共享至您的门户的详细信息

了解有关通过 Server Manager 创建大数据文件共享的详细信息

图 A：两个要素位于彼此的空间搜索距离内。	图 B：两个要素位于彼此的时间距离（时间搜索距离）内。

标注	说明	数据类型
输入点	启用时间的点要素类，用于追踪邻近事件。	Feature Set
实体 ID 字段	表示每个实体的唯一 ID 的文本字段。	Field
输出名称	输出要素服务的名称。	String
距离法	指定将与空间搜索距离参数一起使用的距离类型。平面—要素之间将使用平面距离。这是默认设置。测地线—将在要素之间使用测地线距离。这种线类型考虑到椭球体的曲率，并可以正确处理日期变更线和两极附近的数据。	String
空间搜索距离（可选）	两点视为邻近时相距的最大距离。满足空间搜索距离和时间搜索距离条件的要素视为彼此邻近。	Linear Unit
时间搜索距离（可选）	两点视为邻近时相距的最大持续时间。时间搜索距离内满足空间搜索距离条件的要素视为彼此邻近。	Time Unit
定义感兴趣实体	指定感兴趣实体。感兴趣实体 ID—实体名称和时间将用作感兴趣实体。这是默认设置。指定感兴趣实体图层中的选定要素—在指定感兴趣实体图层中选择的要素将用作感兴趣实体。	String
感兴趣实体 ID	感兴趣实体的实体名称和开始时间。仅当为定义感兴趣实体参数指定感兴趣实体 ID 时，此参数才受支持。值表列： Entity ID—A unique entity name. The names are case sensitive and must be strings. Starting From—An optional starting time to trace an entity of interest. If a time is not specified, January 1, 1970, will be used.	Value Table
感兴趣实体图层	包含感兴趣实体的图层或表。仅当为定义感兴趣实体参数指定指定感兴趣实体图层中的选定要素时，此参数才受支持。	Record Set
输出轨迹（可选）	指定是否将生成相应输出图层，其中包含第一个追踪事件以及该指定实体的所有后续要素。选中—将生成包含第一个追踪事件以及所有后续要素的输出图层。未选中—将不会生成包含第一个追踪事件以及所有后续要素的输出图层。这是默认设置。	Boolean
最大追踪深度	感兴趣实体和追踪中更远的实体（下游）之间的最大分离度。	Long
属性匹配条件（可选）	用于约束邻近事件的字段。	Field
数据存储（可选）	指定将用于存储输出的 ArcGIS Data Store。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。时空大数据存储—输出将存储在时空大数据存储中。这是默认设置。关系数据存储—输出将存储在关系数据存储中。	String

派生输出

标注	说明	数据类型
输出邻近事件	包含追踪的邻近事件的图层。	Feature Set
输出轨迹	包含轨迹中的第一个追踪事件和所有后续要素的可选图层。	Feature Set

arcpy.geoanalytics.TraceProximityEvents(in_points, entity_id_field, output_name, distance_method, {spatial_search_distance}, {temporal_search_distance}, entities_of_interest_input_type, entities_interest_ids, entities_interest_layer, {include_tracks_layer}, max_trace_depth, {attribute_match_criteria}, {data_store})

名称	说明	数据类型
in_points	启用时间的点要素类，用于追踪邻近事件。	Feature Set
entity_id_field	表示每个实体的唯一 ID 的文本字段。	Field
output_name	输出要素服务的名称。	String
distance_method	指定将与空间搜索距离参数一起使用的距离类型。 `PLANAR`—要素之间将使用平面距离。这是默认设置。 `GEODESIC`—将在要素之间使用测地线距离。这种线类型考虑到椭球体的曲率，并可以正确处理日期变更线和两极附近的数据。	String
spatial_search_distance （可选）	两点视为邻近时相距的最大距离。满足空间搜索距离和时间搜索距离条件的要素视为彼此邻近。	Linear Unit
temporal_search_distance （可选）	两点视为邻近时相距的最大持续时间。时间搜索距离内满足空间搜索距离条件的要素视为彼此邻近。	Time Unit
entities_of_interest_input_type	指定感兴趣实体。 `ID_START_TIME`—实体名称和时间将用作感兴趣实体。这是默认设置。 `SELECTED_FEATURE`—在指定感兴趣实体图层中选择的要素将用作感兴趣实体。	String
entities_interest_ids [entities_interest_ids,...]	感兴趣实体的实体名称和开始时间。仅当为 `entities_of_interest_input_type` 参数指定 `ID_START_TIME` 时，此参数才受支持。值表列： `Entity ID`—A unique entity name. The names are case sensitive and must be strings. `Starting From`—An optional starting time to trace an entity of interest. If a time is not specified, January 1, 1970, will be used.	Value Table
entities_interest_layer	包含感兴趣实体的图层或表。仅当为 `entities_of_interest_input_type` 参数指定 `SELECTED_FEATURE` 时，此参数才受支持。	Record Set
include_tracks_layer （可选）	指定是否将生成相应输出图层，其中包含第一个追踪事件以及该指定实体的所有后续要素。 `TRACKS`—将生成包含第一个追踪事件以及所有后续要素的输出图层。 `NO_TRACKS`—将不会生成包含第一个追踪事件以及所有后续要素的输出图层。这是默认设置。	Boolean
max_trace_depth	感兴趣实体和追踪中更远的实体（下游）之间的最大分离度。	Long
attribute_match_criteria [attribute_match_criteria,...] （可选）	用于约束邻近事件的字段。	Field
data_store （可选）	指定将用于存储输出的 ArcGIS Data Store。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。 `SPATIOTEMPORAL_DATA_STORE`—输出将存储在时空大数据存储中。这是默认设置。 `RELATIONAL_DATA_STORE`—输出将存储在关系数据存储中。	String

派生输出

名称	说明	数据类型
output	包含追踪的邻近事件的图层。	Feature Set
tracks_layer	包含轨迹中的第一个追踪事件和所有后续要素的可选图层。	Feature Set

代码示例

TraceProximityEvents 示例（独立脚本）

以下独立脚本演示了如何使用 TraceProximityEvents 函数。

# Name: TraceProximityEvents.py
# Description: Trace proximity events for user1 and user4 with 30 feet
#              spatial search distance and 10 minute temporal search distance.

# Import system modules
import arcpy

inFeatures = "https://analysis.mydomain.com/server/rest/services/sample_tracks/FeatureServer/0"
entityIDField = "user_id"
outFS = "ProximityEvents"
spatialDistance = "30 Feet"
temporalDistance = "10 Minutes"
entitiesOfInterest = "user1 '3/30/2020 9:00:00 AM';user4 '3/30/2020 9:00:00 AM'"
outTracks = "out_tracks"
max_trace_depth = 3
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run Trace Proximity Events
arcpy.geoanalytics.TraceProximityEvents(inFeatures, entityIDField, outFS,
                                        "PLANAR", spatialDistance,
                                        temporalDistance, "ID_START_TIME",
                                        entitiesOfInterest, None, "TRACKS",
                                        None, None, max_trace_depth, dataStore)

环境

输出坐标系, 范围, 当前工作空间

特殊情况

输出坐标系: The coordinate system that will be used for analysis. Analysis will be completed in the input coordinate system unless specified by this parameter. For GeoAnalytics Tools, final results will be stored in the spatiotemporal data store in WGS84.

许可信息

基本: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.9
标准: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.9
高级: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.9

追踪邻近事件 (GeoAnalytics Server 工具)

汇总

旧版本：

插图

用法

参数

派生输出

环境

特殊情况

许可信息

相关主题