视域 (即用型)

摘要

针对给定的输入观察点集,返回可见区域多边形。

使用情况

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

  • 目前存在多个高程源,其空间分辨率不同且覆盖不同区域。 并非所有分辨率都适用于所有区域。 如果指定分辨率在任何输入观察点位置均不可用,则该工具将返回一条错误消息。

  • 如果未提供 DEM 分辨率参数,则将使用最粗糙的分辨率 (90m)。 如果指定了最佳,则该工具将使用最大距离参数允许的适用于观察点位置的最小分辨率。

  • 对于最大距离参数,10m 和 30m DEM 分辨率的允许值小于或等于 15 千米。 对于 90m DEM 分辨率,允许值为 50 千米或更小。 如果未指定此参数,则该工具将使用基于 DEM 分辨率参数的默认值。 对于 10 m 分辨率,默认最大距离为 5 千米。 对于 30 m 和 90 m DEM 分辨率,默认距离为 15 千米。

  • 对于输入要素,该工具将使用单分辨率高程源。 所有输入要素必须适应单分辨率;否则,该工具将确定覆盖输入要素的最高分辨率。

  • 水下的可见性是有限的,因此该工具将使用水体表面作为高程表面。 将向海洋分配值零,并向主要水体分配相应的平面局部高程。

  • 输出视域将作为面要素返回。 Frequency 字段用于记录可看见每个面的观察点数。 DEMResolution 字段用于记录视域计算的源 DEM 分辨率。

    将返回三个附加字段,用于标识计算中使用的 DEM 数据源。 这些字段包括 Product NameSourceSource URL

  • DEM 分辨率越低,工具响应速度越快。 例如,90m 分辨率的响应时间最短。 这一折衷结果在于,与较高 DEM 分辨率相比,较低 DEM 分辨率的视域结果的精度更低。

  • 最大距离参数也可能影响工具响应时间。 通常,使用较小的距离会导致响应时间更短。

  • 输入点的最大数量为 1000。 如果提供的输入点数大于 1,000,则该工具将返回错误且无法执行。

参数

标注说明数据类型
输入点要素

用作观察点位置的点要素。

Feature Set
最大距离
(可选)

用于计算视域的最大距离。

Double
最大距离单位
(可选)

指定最大距离参数的单位。

  • 单位为米。 这是默认设置。
  • 千米单位为千米。
  • 英尺单位为英尺。
  • 单位为码。
  • 英里单位为英里。
String
DEM 分辨率
(可选)

指定用于计算的源高程数据的近似空间分辨率(像元大小)。

分辨率关键字是数字高程模型空间分辨率的近似值。 许多高程源以弧秒为单位进行分布;关键字是以米为单位的近似值更方便理解。

  • 最精细适用于所使用范围的最精细单位。
  • 10 米高程源分辨率为 1/3 弧秒,或大约 10 米。
  • 24 米高程源是分辨率为 24 米的 Airbus WorldDEM4Ortho 数据集。
  • 30 米高程源分辨率为 1 弧秒,或大约 30 米。
  • 90 米高程源分辨率为 3 弧秒,或大约 90 米。 这是默认设置。
String
观察点高度
(可选)

观察点表面以上的高度。 默认值 1.75 米是人的平均身高。 如果您要从较高位置(如瞭望塔或高建筑物)进行观察,请使用该高度。

Double
观察点高度单位
(可选)

指定观察点高度参数的单位。

  • 单位为米。 这是默认设置。
  • 千米单位为千米。
  • 英尺单位为英尺。
  • 单位为码。
  • 英里单位为英里。
String
表面偏移
(可选)

正在查看的对象表面上方的高度。 默认值为 0。 如果正在查看建筑物或风力涡轮机,则使用其高度。

Double
表面偏移单位
(可选)

指定表面偏移参数的单位。

  • 单位为米。 这是默认设置。
  • 千米单位为千米。
  • 英尺单位为英尺。
  • 单位为码。
  • 英里单位为英里。
String
概化 Viewshed 多边形
(可选)

指定是否对视域面进行概化。

视域计算基于栅格高程模型,以创建带阶梯状边缘的结果。 要创建更美观的外观并提高性能,则默认行为是概化面。 对于超过 DEM 分辨率一半的所有地点,这种概化将不会更改结果的准确性。

  • 选中 - 将概化视域面。 这是默认设置。
  • 未选中 - 不会概化视域面。
Boolean

派生输出

标注说明数据类型
输出视域

输出视域。

Feature Set

arcpy.agolservices.Viewshed(InputPoints, {MaximumDistance}, {MaximumDistanceUnits}, {DEMResolution}, {ObserverHeight}, {ObserverHeightUnits}, {SurfaceOffset}, {SurfaceOffsetUnits}, {GeneralizeViewshedPolygons})
名称说明数据类型
InputPoints

用作观察点位置的点要素。

Feature Set
MaximumDistance
(可选)

用于计算视域的最大距离。

Double
MaximumDistanceUnits
(可选)

指定最大距离参数的单位。

  • Meters单位为米。 这是默认设置。
  • Kilometers单位为千米。
  • Feet单位为英尺。
  • Yards单位为码。
  • Miles单位为英里。
String
DEMResolution
(可选)

指定用于计算的源高程数据的近似空间分辨率(像元大小)。

分辨率关键字是数字高程模型空间分辨率的近似值。 许多高程源以弧秒为单位进行分布;关键字是以米为单位的近似值更方便理解。

  • FINEST适用于所使用范围的最精细单位。
  • 10m高程源分辨率为 1/3 弧秒,或大约 10 米。
  • 24m高程源是分辨率为 24 米的 Airbus WorldDEM4Ortho 数据集。
  • 30m高程源分辨率为 1 弧秒,或大约 30 米。
  • 90m高程源分辨率为 3 弧秒,或大约 90 米。 这是默认设置。
String
ObserverHeight
(可选)

观察点表面以上的高度。 默认值 1.75 米是人的平均身高。 如果您要从较高位置(如瞭望塔或高建筑物)进行观察,请使用该高度。

Double
ObserverHeightUnits
(可选)

指定观察点高度参数的单位。

  • Meters单位为米。 这是默认设置。
  • Kilometers单位为千米。
  • Feet单位为英尺。
  • Yards单位为码。
  • Miles单位为英里。
String
SurfaceOffset
(可选)

正在查看的对象表面上方的高度。 默认值为 0。 如果正在查看建筑物或风力涡轮机,则使用其高度。

Double
SurfaceOffsetUnits
(可选)

指定表面偏移参数的单位。

  • Meters单位为米。 这是默认设置。
  • Kilometers单位为千米。
  • Feet单位为英尺。
  • Yards单位为码。
  • Miles单位为英里。
String
GeneralizeViewshedPolygons
(可选)

指定是否对视域面进行概化。

视域计算基于栅格高程模型,以创建带阶梯状边缘的结果。 要创建更美观的外观并提高性能,则默认行为是概化面。 对于超过 DEM 分辨率一半的所有地点,这种概化将不会更改结果的准确性。

  • GENERALIZE将概化视域面。 这是默认设置。
  • NO_GENERALIZE不会概化视域面。
Boolean

派生输出

名称说明数据类型
OutputViewshed

输出视域。

Feature Set

环境

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

相关主题