Python ArcGIS overlay_layers用法及代码示例

本文简要介绍 python 语言中 arcgis.features.analysis.overlay_layers 的用法。

用法:

arcgis.features.analysis.overlay_layers(input_layer, overlay_layer, overlay_type='Intersect', snap_to_input=False, output_type='Input', tolerance=None, output_name=None, context=None, gis=None, estimate=False, future=False)

返回：

result_layer：如果指定了output_name，则为 FeatureLayer ，否则为特征集合。

overlay_layers 方法将两个或多个层合并为一个层。您可以将叠加视为查看一堆Map并创建一个包含在堆栈中找到的所有信息的单个Map。事实上，在 GIS 出现之前，制图师会逐字地将Map复制到透明的醋酸纤维纸上，将这些纸覆盖在灯台上，然后从覆盖的数据中手绘一张新Map。叠加不仅仅是线条作品的合并；参与叠加的特征的所有属性都将传递到最终产品。覆盖用于回答地理中最基本的问题之一，“什么在什么之上？”例如：

• 100 年洪泛区内有哪些地块？ (在上面只是另一种说法。)

• 哪些县内有哪些道路？

• 在什么土壤类型之上有什么土地利用？

• 废弃的军事基地内有哪些井？

Parameter	Description
input_layer	必需的层。将被 overlay_layer 覆盖的点、线或面要素。请参阅特征输入。
overlay_layer	必需的层。将被input_layer 函数覆盖的函数。请参阅特征输入。
overlay_type	可选字符串。要执行的叠加类型。 选择列表：['Intersect', 'Union', 'Erase'] Intersect - 计算输入层的几何交集。在input_layer 和overlay_layer 层中重叠的特征或特征部分将被写入输出层。这是默认设置。 Union - 计算输入层的几何联合。所有要素及其属性都将写入输出层。仅当 input_layer 和 overlay_layer 都包含面要素时，此选项才有效。 Erase - 仅将overlay_layer 中不在input_layer 层中的特征内的那些特征或特征部分写入输出。 默认值为“相交”。
snap_to_input	可选的布尔值。一个布尔值，指示是否允许 input_layer 中的要素顶点移动。默认值为 false，表示如果要素之间的距离小于 tolerance 值，则两个图层中的所有要素都可以移动以允许彼此捕捉。设置为 true 时，只有 overlay_layer 中的要素可以移动以捕捉到 input_layer 要素。
output_type	可选字符串。您要查找的交叉点类型。该参数仅在overlay_type 为相交时有效。 选择列表：[‘Input’, ‘Line’, ‘Point’] Input - 返回的要素将与具有最低尺寸几何的 input_layer 或 overlay_layer 具有相同的几何类型。如果所有输入都是多边形，则输出将包含多边形。如果一个或多个输入是线，并且没有一个输入是点，则输出将为线。如果一个或多个输入是点，则输出将包含点。这是默认设置。 Line - 将返回线交点。仅当所有输入都不是点时这才有效。 Point - 将返回点交点。如果输入是线或面，则输出将为多点图层。
tolerance	可选浮点数。分隔所有要素坐标的最小距离的浮点值，以及坐标可以在 X 或 Y(或两者)中移动的距离。公差单位与 input_layer 的单位相同。
output_name	可选字符串或 FeatureLayer 。现有要素图层将导致新图层附加到要素服务。如果 overwrite 在上下文中为 True，则新层将覆盖现有层。如果未指示output_name，则创建新的 FeatureCollection 。
context	可选字典。处理范围和输出空间参考等附加设置。对于calculate_density，有三个设置。 extent - 定义分析区域的边界框。仅分析input_layer 中与边界框相交的那些特征。 outSR - 输出要素将投影到 wkid 引用的输出空间参考中。 overwrite - 如果为 True，则 output_name 中的要素层将被新要素层覆盖。适用于 ArcGIS Online 或 Enterprise 10.9.1+ # Example Usage context = {"extent": {"xmin": 3164569.408035, "ymin": -9187921.892449, "xmax": 3174104.927313, "ymax": -9175500.875353, "spatialReference":{"wkid":102100,"latestWkid":3857}}, "outSR": {"wkid": 3857}, "overwrite": True}
gis	可选，运行此工具的 GIS 。如果未指定，则使用活动 GIS。
future	可选布尔值。如果为 True，则将返回 future 对象，并且进程不会等待任务完成。默认为False，表示等待结果。

如果 future = True ，则结果是 Future 对象。调用result() 获取响应。

例子：

#USAGE EXAMPLE: To clip a buffer in the shape of Capitol hill neighborhood.
cliped_buffer = overlay_layers(buffer,
                               neighbourhood,
                               output_name="Cliped buffer")