按范围过滤

“按范围过滤”工具将基于指定的空间范围返回数据集的子集。 输出是一个新数据集，仅包含地理上位于指定范围内的记录。

示例

“按范围过滤”工具可用于以下场景：

• 您希望排除研究区域之外的点，因此您根据研究区域数据集的范围过滤输入数据集。
• 您有一个全国范围的数据集，并且想要为特定范围创建数据子集。

参数

下表概述了在“按范围过滤”工具中使用的参数：

参数	描述
输入数据集	要过滤的数据集。
几何	输入数据集中的几何字段包含将被过滤的位置。
范围类型	指定将用于过滤的范围类型。 您可以指定 x 和 y 值或使用另一个数据集的范围。
X 最小值	过滤范围的最小 x 值。 这也称为范围的左侧。
Y 最小值	过滤范围的最小 y 值。 这也称为范围的底部。
X 最大值	过滤范围的最大 x 值。 这也称为范围的右侧。
Y 最大值	过滤范围的最大 y 值。 这也称为范围的顶部。
范围数据集	包含表示将用于过滤的范围的几何字段数据集。
范围几何	范围数据集中的几何字段。 此几何范围将用于从输入数据集中过滤记录。

用法说明

使用输入数据集参数来识别要过时滤的数据集。

使用范围类型参数指定将用于过滤的范围类型。 选项如下：

• 定义范围 - 使用 x 值和 y 值将输入数据集过滤到指定范围。 要指定范围值，请使用 X 最小值、Y 最小值、X 最大值和 Y 最大值参数。
• 使用另一个数据集的范围 - 使用另一个数据集的范围过滤输入数据集。 使用范围数据集和范围几何参数选择具有适当范围的几何字段。

如果选择定义范围，输入范围值将采用与输入数据集坐标系相同的单位。 以下示例描述了如何指定范围值：

• 如果数据集位于使用线性单位英尺的投影坐标系中，请使用以英尺表示的范围值。 例如，如果输入数据集的空间参考为 NAD 1983 State Plane California V FIPS 0405（美国英尺），请指定以下值：X 最小值为 6500000.5，Y 最小值为 1700000.8，X 最大值为 6700000.1，Y 最大值为 1900000.3。
• 如果输入数据集位于使用角度单位的地理坐标系中，例如 WGS84，请指定以下值：X 最小值为 -180.0、Y 最小值为 -90.0、X 最大值为 180.0，Y 最大值为 90.0。

如果输入几何字段和范围图层几何字段之间的空间参考不同，则范围几何将投影到输入几何的空间参考。

输出

工具输出包括一个仅包含特定范围内记录的数据集。 输出数据集将包含输入数据集中的所有字段。

局限性

以下是“按范围过滤”工具的已知局限性：

• 该工具仅返回单个数据集，其中包含范围内的记录。 超出范围的记录将从结果中排除。
• 如果指定的范围值与输入数据集的坐标系的单位不同，则不会返回任何记录。
• 没有空间位置的输入记录（例如空值）将不会包含在结果中。

许可要求

需要以下许可和配置：

• Creator 或 Professional 用户类型
• 发布者、服务商或管理员角色，或等效的自定义角色

有关 Data Pipelines 要求的详细信息，请参阅要求。