描述
返回输入线要素的高程剖面。
使用方法
即用型工具箱中的工具是利用 ArcGIS Online 托管数据和分析功能的 ArcGIS Online 地理处理服务。
此工具的输出是折线要素,其高程值沿每个折点的输入线要素进行提取。高程值作为 z 值在形状几何中存储。距离值作为 m 值在形状几何中存储。可使用最大采样距离参数将输入折线折点增密为不同的点度。
对于异步剖面服务,最大输入行数为 1,000。对于同步剖面服务,最大输入行数为 100。如果提供的输入行超过允许数量,则服务将返回错误且无法执行。
返回的线要素与输入线要素处于相同的坐标系中。折点的 z 和 m 值以米为单位。
如果未提供 DEM 分辨率参数,则将使用 90 米分辨率的 SRTM 数据。如果指定了最佳,则服务将使用可用于输入行要素区域的最小分辨率。
如果未提供最大采样距离参数,则系统将根据输入线要素上的可用折点数计算默认采样距离。如果输入线要素所含的折点少于 50 个,则默认的采样距离为输入线要素的长度除以 49。如果输入线要素包含的折点多于 50 个但少于 200 个,则默认的采样距离是输入线要素的长度除以 199。如果输入线要素包含的折点数大于 200 但小于或等于 1,024,则在未指定采样距离参数的情况下,不会增密输入线要素。
从服务返回的高程值的最大数量是输入行数的 2,000 倍。如果请求的结果高于此高程值最大数量,则该服务将返回错误消息且无法执行。如果发生这种情况,指定较大的采样距离和/或输入折点数较少的线要素。
目前存在多个高程源,其空间分辨率不同且覆盖不同区域。并非所有分辨率都适用于所有区域。如果指定的 DEM 分辨率在任何输入要素位置均不可用,则工具将返回一条错误消息。
Length Meters 输出字段包含按照测地距离计算的剖面线长度,该长度不管数据的坐标系为何都是正确的长度。由于地图投影失真的影响,此长度会与 shape_length 属性不同。DEMResolution 输出字段用于记录工具使用的 源 DEM 分辨率。
将返回三个附加字段,用于标识计算中使用的 DEM 数据源。这些字段为 Product Name、Source 和 Source URL。
语法
arcpy.agolservices.Profile(InputLineFeatures, {ProfileIDField}, {DEMResolution}, {MaximumSampleDistance}, {MaximumSampleDistanceUnits})
参数 | 说明 | 数据类型 |
InputLineFeatures | 将在表面输入上描绘剖面的线要素。 | Feature Set |
ProfileIDField (可选) | 将剖面与其对应的输入线要素关联的唯一标识符。 | String |
DEMResolution (可选) | 指定用于计算的源高程数据的近似空间分辨率(像元大小)。 分辨率关键字是数字高程模型空间分辨率的近似值。许多高程源以弧秒为单位进行分布;关键字是以米为单位的近似值更方便理解。
| String |
MaximumSampleDistance (可选) | 沿线采样高程值的最大采样距离。 | Double |
MaximumSampleDistanceUnits (可选) | 指定最大采样距离参数的单位。
| String |
派生输出
名称 | 说明 | 数据类型 |
OutputProfile | 输入线要素的输出高程剖面。 | 要素集 |