集水区 (即用型)

摘要

用于确定各个输入点之上的汇流区域。 集水区是汇集水流的上坡区域。

使用情况

• 即用型工具箱中的工具是利用 ArcGIS Online 托管数据和分析功能的 ArcGIS Online 地理处理服务。

• 对于每个输入点，将返回集水区要素。

• 输出集水区要素是汇集水流的整个上游区域。 例如，路易斯安那州密西西比河上的输入点或倾泻点将创建一个集水区要素，其中包括从纽约经蒙大拿州到加拿大的区域。

• 如果倾泻点未落入特定数据源的范围内，则将不返回集水区要素。

• 如果未指定点标识字段，则默认使用唯一 ID 字段。

• 输入点的最大数量为 1000。 如果提供的输入要素过多，则服务将返回错误且无法执行。

• 倾泻点标识字段必须为整型或字符串类型。 使用由唯一值构成的字段非常有用。

• 此工具将创建一个包含流域面的输出要素图层。 面要素图层将包含以下各种字段：

  • PourPtID - 如果指定，则使用提供的点识别字段中的值。 如果未指定任何值，则对应于输入点要素图层中的唯一 ID 字段。
  • Data Resolution - 生成输出所用的预处理数据的分辨率（以原生单位表示）。
  • Area Square Kilometers - 每个流域的面积（以平方公里为单位）。

• 默认捕捉距离是指定数据库中数据的分辨率乘以 5。

• 捕捉点的可选输出包含名为 PointID 的字段。 该字段包含倾泻点 ID 字段中提供的值。 该值用于将输入倾泻点与其集水区相关联。

• 要提供有关此服务的反馈，请访问 Hydro 论坛。

参数

对话框

标注	说明	数据类型
输入点	用于计算集水区的点要素。 这些点要素被称为倾泻点，因为其是水从集水区倾泻而出的位置。	Feature Set
点标识字段 (可选)	用于标识输入点的整型或字符串字段。 默认使用唯一 ID 字段。	String
捕捉距离 (可选)	用于移动输入点位置的最大距离。 交互式输入点和记录的标尺位置可能与 DEM 中的河流位置未完全对齐。 此参数允许服务将该点移动到具有最大汇集水流面积的附近位置。 默认情况下，捕捉距离的计算方法为源数据的分辨率乘以 5。	String
捕捉距离单位 (可选)	针对捕捉距离指定的线性单位。 米—单位为米。 这是默认设置。 千米—单位为千米。 英尺—单位为英尺。 码—单位为码。 英里—单位为英里。	String
数据源分辨率 (可选)	指定将用于分析的源数据分辨率。 这些值是用于构建基础水文数据库的数字高程模型的空间分辨率近似值。 由于许多高程源以弧秒为单位进行分布，为了更方便理解，我们提供了以米为单位的近似值。 空—将使用基于 3 弧秒的数据源（分辨率大约为 90 米的高程数据）构建的水文源。 最精细—将使用所有可能数据源的每个位置的最佳可用分辨率。 这是默认设置。 10 米—将使用基于 1/3 弧秒的数据源（分辨率大约为 10 米的高程数据）构建的水文源。 30 米—将使用基于 1 弧秒的数据源（分辨率大约为 30 米的高程数据）构建的水文源。 90 米—将使用基于 3 弧秒的数据源（分辨率大约为 90 米的高程数据）构建的水文源。	String
概化 (可选)	指定是将输出流域平滑处理为更简单的形状还是将其与原始 DEM 的像元边保持一致。 未选中 - 面的边缘将与原始 DEM 的像元边缘保持一致。 这是默认设置。 选中 - 面边界将被平滑处理为简单的形状。	Boolean
返回捕捉到的点 (可选)	确定是否将返回集水区倾泻点处的点要素。 如果启用捕捉，则捕捉到的点可能与输入点不同。 未选中 - 将不返回点要素。 选中 - 将返回点要素。 这是默认设置。	Boolean

派生输出

标注	说明	数据类型
输出集水区	输出集水区。	Feature Set
输出捕捉到的点	输出捕捉点。	Feature Set

Python

arcpy.agolservices.Watershed(InputPoints, {PointIDField}, {SnapDistance}, {SnapDistanceUnits}, {DataSourceResolution}, {Generalize}, {ReturnSnappedPoints})

名称	说明	数据类型
InputPoints	用于计算集水区的点要素。 这些点要素被称为倾泻点，因为其是水从集水区倾泻而出的位置。	Feature Set
PointIDField (可选)	用于标识输入点的整型或字符串字段。 默认使用唯一 ID 字段。	String
SnapDistance (可选)	用于移动输入点位置的最大距离。 交互式输入点和记录的标尺位置可能与 DEM 中的河流位置未完全对齐。 此参数允许服务将该点移动到具有最大汇集水流面积的附近位置。 默认情况下，捕捉距离的计算方法为源数据的分辨率乘以 5。	String
SnapDistanceUnits (可选)	针对捕捉距离指定的线性单位。 Meters—单位为米。 这是默认设置。 Kilometers—单位为千米。 Feet—单位为英尺。 Yards—单位为码。 Miles—单位为英里。	String
DataSourceResolution (可选)	指定将用于分析的源数据分辨率。 这些值是用于构建基础水文数据库的数字高程模型的空间分辨率近似值。 由于许多高程源以弧秒为单位进行分布，为了更方便理解，我们提供了以米为单位的近似值。 Blank—将使用基于 3 弧秒的数据源（分辨率大约为 90 米的高程数据）构建的水文源。 FINEST—将使用所有可能数据源的每个位置的最佳可用分辨率。 这是默认设置。 10m—将使用基于 1/3 弧秒的数据源（分辨率大约为 10 米的高程数据）构建的水文源。 30m—将使用基于 1 弧秒的数据源（分辨率大约为 30 米的高程数据）构建的水文源。 90m—将使用基于 3 弧秒的数据源（分辨率大约为 90 米的高程数据）构建的水文源。	String
Generalize (可选)	指定是将输出流域平滑处理为更简单的形状还是将其与原始 DEM 的像元边保持一致。 True—面边界将被平滑处理为简单的形状。 False—面的边缘将与原始 DEM 的像元边缘保持一致。 这是默认设置。	Boolean
ReturnSnappedPoints (可选)	确定是否将返回集水区倾泻点处的点要素。 如果启用捕捉，则捕捉到的点可能与输入点不同。 True—将返回点要素。 False—将不返回点要素。 这是默认设置。	Boolean

派生输出

名称	说明	数据类型
WatershedArea	输出集水区。	Feature Set
SnappedPoints	输出捕捉点。	Feature Set

环境

此工具不使用任何地理处理环境。