计算距离

实时和大数据分析中的可用。

“计算距离”工具 可计算从目标点要素到同一个源中或是其他源或数据集中的最近要素的距离。 可以基于目标和邻近要素之间的属性关系来限制候选最近要素。

示例

以下是“计算距离”工具的用例：

• 应急行动主管正在实时监控外业工作人员的位置。 每次更新工作人员的位置时，实时分析都会计算从工作人员的当前位置到为其分配的操作基地的距离。
• 计算紧急事件的传入源与在同一附近移动的其他应急响应车辆源之间的距离，以确定最接近的事件响应者。
• 计算运输船舶源中的要素与同一源中的其他要素之间的距离，以确定是否有任何要素相互处于危险的邻近位置。

用法说明

使用“计算距离”工具时，请谨记以下信息：

• 系统将针对每个目标要素计算连接图层中该要素与给定搜索半径内的最近要素之间的距离。 搜索半径内的要素数量会影响性能。
• 如果保持外部距离要素参数设置为否，则输出将仅包含在搜索半径内找到连接要素并满足属性关系（如果指定）的目标要素。 如果设置为是，输出将包含所有目标要素。 如果在所指定的搜索半径内未找到目标要素的连接要素，则 DistanceToFeature 输出值将为空。

• 空间关系参数可以设置为邻近测地线或邻近平面。
  • 邻近测地线用于计算测地线距离。 测地线距离表示地球的实际形状（即椭圆体，更准确地说是大地水准面）。 并会计算曲面（大地水准面）上而不是平坦表面（笛卡尔平面）上两点间的距离。 在下列情况下，请始终考虑计算测地线距离：
    • 输入要素处于分散状态（覆盖多个协调世界时间 (UTM) 区域、大面积区域或整个地球）。
    • 输入要素的空间参考（地图投影）为保留其他属性（如面积）使距离发生变形。
  • 邻近平面用于计算欧氏距离。 这是二维笛卡尔平面中的距离，该平面用于计算平坦表面（笛卡尔平面）上两点之间的直线距离或欧氏距离。 当分析集中于相对较小区域（如一个 UTM 带）的要素之间的距离时，此方法将非常有用。
  • 如果源连接到连接端口，则系统将根据目标源和连接源中不断变化的要素动态执行距离计算。
  • 在动态地理围栏中，必须设置连接时间窗参数。 如果连接源没有标记为 END_TIME 的字段，并且连接要素的最后已知观测值早于此时间窗，则系统会将其从工具的内存中移除，且不会将其包含在分析中。 如果连接源具有标记为 END_TIME 的字段，则该要素将根据标记为 END_TIME 的字段中的值或在关闭连接时间窗时（以先到的时间为准）从地理围栏存储中老化。
  • 必须在模型视图中向工具添加连接源。 无法在工作流视图中查看或编辑带有使用连接源的工具的分析。
• 可以指定属性关系，以测量从目标要素到另一个具有匹配属性值的数据集中最近要素的距离。
• 可以通过邻近（连接）要素指定一个或多个字段，以与目标要素连接。

参数

以下是“计算距离”工具的参数：

参数	描述	数据类型
目标图层	“计算工具”将处理的要素。	要素
连接图层	将在该图层中识别目标图层参数中每个要素的最近要素并计算其之间的距离。	要素
空间关系	用于创建搜索半径以查找最近要素的方法。 空间运算符包括邻近测地线或邻近平面。 注： 如果选择邻近平面，则必须同时投影目标要素和最近要素。 投影工具可用于在运行“计算距离”工具之前投影输入点。 注： 仅在目标和邻近（连接）要素均为点要素时，才支持邻近测地线空间搜索方法。 注： 仅在目标要素为点要素时，才支持邻近测地线和邻近平面空间搜索方法。	字符串
空间搜索半径	识别最近要素的距离。 将不考虑该距离之外的要素。	线性单位
属性关系（可选）	根据目标和邻近（连接）要素之间的关系限制候选最近要素。 指定目标图层中的哪个属性字段与邻近（连接）图层中的属性字段匹配。	字符串
输出距离单位	用于距离计算的输出距离单位。	字符串
连接字段（可选）	邻近（连接）要素中用于连接到目标要素的一组字段。	字符串
连接时间窗	连接源的时间窗（动态地理围栏）。 如果连接要素的最后一个已知观测点早于指定的时间窗，则其将被移除并且不会包含在分析中。 如果连接源具有标记为 END_TIME 的字段，则此参数为可选参数。	字符串
保留外部距离要素	指定是输出所有目标要素还是仅输出在搜索半径内找到连接要素并满足属性关系（如果指定）的目标要素。	布尔

输出图层

输出图层将追加新字段 DistanceToFeature。 此外，在连接字段参数中指定的任何字段也将追加到输出图层。

字段名	描述	字段类型
DistanceToFeature	从要素到连接图层中最近要素的距离，其单位在输出距离单位参数中进行定义。	Float64

注意事项和限制

使用“计算距离”工具时，需要牢记几个注意事项和限制：

• 仅在目标和邻近（连接）要素均为点要素时，才支持使用邻近测地线空间搜索方法作为空间关系。
• 仅在目标要素为点要素时，才支持邻近测地线和邻近平面空间搜索方法。