实时和大数据分析中的可用
。
检测间距工具 
在实时和大数据分析中均可用，但是，使用不同的分析类型时，该工具的功能和具体运行情况将有所不同。 在实时分析中，检测间距工具会监测所有传入观测值，并在任意追踪超出指定间距持续时间时发出报告。 间距检测可以设置为指定的时间间隔，并生成间距通知作为输出事件。 或者，在大数据分析中，检测间距工具将处理提供给工具的完整要素集并且基于为追踪 ID 和开始时间选项设置的关键字段值，根据为每条轨迹定义的参数识别开始、结束或持续间距要素。
示例
以下是检测间距工具的用例：
- 在实时分析中，智能压力仪表网络每 10 秒报告一次压力等级。 维护工作队希望知道压力仪表何时离线且无法报告压力信息。 可以对检测间距工具进行如下配置：间距持续时间为 30 秒，间距检测间隔为 5 秒。 使用此配置，检测间距工具将每 5 秒检查一次所有已知仪表，以确定是否有任何仪表超过 30 秒未报告压力信息。
- 在大数据分析中，车队经理正在检查几周内自动车辆定位 (AVL) 数据报告的一致性，确保车辆传感器及其传感器供应商 API 一致地提供要素。 可以将检测间距工具配置为识别缺失要素之处大于指定间距持续时间（例如 15 分钟）的要素追踪。
用法说明
使用检测间距工具时，请谨记以下信息：
- 推荐将间距持续时间参数值设置为等于或大于观测之间的预期间隔。 如果间距持续时间设置为小于正常预期间隔的值，将会频繁检测到错误间距。
- 此工具只能处理具有唯一追踪 ID 的事件。 必须在输入数据集追踪 ID 选项中指定关键字段，才能使用该工具。
- 实时分析特定用法说明：
- 检测间距工具按间距检测间隔参数指定的速率运行。 也就是说，如果间距检测间隔设置为 20 分钟，检测间距工具将每 20 分钟检查一次所有已知追踪，以确定是否有任何追踪超过间距持续时间。
- 适用于实时分析的检测间距工具在检测到间距时提供连续或待更改通知模式。
- 连续 - 首次针对特定追踪 ID 检测到间距时，将创建间距事件。 只要存在持续间距，便将按间距检测间隔参数中指定的速率额外创建一个间距事件。 再次观测到同一追踪 ID 时，将发出最终间距事件。
- 待更改 - 首次针对特定追踪 ID 检测到间距时，将创建间距事件。 再次观测到同一追踪 ID 时，将发出第二个也是最终间距事件。
- 必须指定间距持续时间和间距检测间隔才能识别间距。 等于或大于指定间距持续时间的要素缺失将被识别为间距。 间距检测将按间距检测间隔参数指定的速率进行。
- 在实时分析中，检测间距工具将为每个追踪 ID 保留当前观测点的状态存储。 当接收到新的观测点时，将会对其与相同追踪 ID（如果存在）的当前观测点进行比较，以确定是否出现间距。 如果新观测点的时间戳比状态存储中当前观测点的时间戳更近，则将替换当前观测点。 如果新观测点的时间戳与相同追踪 ID 的当前观测点的时间戳相同，则该工具无法区分这两个观测点。 这意味着该工具不会将状态存储中的当前观测点替换为新观测点，也不会将新观测点添加至状态存储，并且将对此追踪 ID 的未来观测点与保留在状态存储中的当前观测点进行比较，直到具有更近时间戳的新观测点到达为止。 当出现这种情况时，该工具将记录警告。
- 大数据分析特定用法说明
- 适用于大数据分析的检测间距工具提供单个或累积间距检测方法。
- 单个 - 当给定追踪 ID 的两个连续要素之间的时间差超过间距持续时间时，将识别唯一的间距。
- 累积 - 将给定追踪 ID 超过间距持续时间的两个连续要素之间的连续时间差识别为单个间距。
- 要识别间距，必须指定间距持续时间参数值。 时间间距等于或大于间距持续时间的要素将被识别为间距。
- 选择输出所有间距要素类型（开始、持续和结束要素）还是仅输出结束间距（结束要素）
- 除了追踪 ID 字段外，还可以指定一个或多个字段来识别轨迹。 追踪由一个或多个追踪字段的唯一组合表示。
- 适用于大数据分析的检测间距工具提供单个或累积间距检测方法。
参数
以下是检测间距工具的参数：
| 参数 | 描述 | 数据类型 |
|---|---|---|
输入图层 | 将在数据流中观测是否存在间距的追踪。 | 要素 |
间距持续时间 | 指定必须收到追踪观测值的时间窗。 | 字符串 |
通知模式/方法 | 指定间距通知或间距检测方法。 此参数的可用选项在实时分析和大数据分析中有所不同。
| 字符串 |
间距检测间隔（仅限实时分析） | 指定检查事件是否超过间距持续时间参数中指定的值的频率。 此参数仅适用于实时分析。 | 字符串 |
仅已结束间距（仅限大数据分析） | 指定是否输出参与间距的所有要素（启动、持续和结束要素），或者仅输出每个间距的结束要素。 此参数仅适用于大数据分析。 | 布尔 |
追踪 ID 字段 | 选择一个或多个字段以唯一标识将要处理的要素。 如果在输入中为追踪 ID 设置了关键字段，则该参数会自动填充。 | 字段 |
输出图层：实时分析
在实时分析中来自此工具的输出图层将具有传入要素的字段和值，并且也会包含 lastReceived、IsGap 和 GapDuration 等三个附加字段。
| 字段名 | 描述 | 字段类型 |
|---|---|---|
LastReceived | 最新接收到的追踪观测值的时间戳。 | 日期 |
IsGap | 当前间距状态，如果间距条件存在，为 true，不存在则为 false。 | 布尔 |
GapDuration | 持续间距经历的总时间。 | 整型 |
输出图层：大数据分析
在大数据分析中来自此工具的输出图层将具有传入要素的字段和值，并且也会包含 GapFeatureType、GapId、GapStartTime、GapEndTime、GapCurrentDuration 和 GapOverallDuration 等六个附加字段。
| 字段名 | 描述 | 字段类型 |
|---|---|---|
GapFeatureType | 要素代表的已识别间距部分。 可能的值为已开始、持续和已结束。 | 字符串 |
GapId | 为识别每个独立间距生成的唯一 ID。 | 字符串 |
GapStartTime | 间距事件开始时的日期时间。 | 日期 |
GapEndTime | 间距事件结束时的日期时间。 | 日期 |
GapCurrentDuration | 间距类型的当前持续间距经历的当前时间。 已开始间距要素类型的 GapCurrentDuration 始终为 0。 已结束间距要素类型的 GapCurrentDuration 和 GapOverallDuration 值相同。 | 转为浮点型 |
GapOverallDuration | 要素所属间距经历的总时间。 | 转为浮点型 |
注意事项和限制
使用检测间距工具时，需要牢记几点注意事项：
- 间距持续时间参数（仅限实时分析）不能超过 24 小时。 如果预计间距持续时间会更长，可以考虑使用大数据分析监控要素。
- 检测间距工具（仅限实时分析）会将间距状态最多保留 7 天。