将多个图层中的几何叠加到一个图层中。 叠加可用于合并、擦除、修改或更新空间要素。
叠加操作用于回答一个最基本的地理问题：什么在什么上？ 以下为示例：
此地理处理工具适用于 ArcGIS Enterprise 10.6.1 或更高版本。
可使用的示例包括：
在 ArcGIS Enterprise 10.6.1 中，输入图层和叠加图层必须具有匹配的几何类型。 ArcGIS Enterprise 10.7 版本中还支持其他关系。
下表概述了涉及 ArcGIS Enterprise 10.6.1 中可用的不同几何类型的相交和擦除叠加操作：
| 输入图层（绿色）和叠加图层（黄色） | 相交结果 | 擦除结果 |
|---|---|---|
 面输入图层（绿色）和叠加图层（黄色）。 |  输入和叠加图层的相交面。 B 是 B 和 2 的交点。 D 是 D 和 4 的交点。 E 是 E 和 5 的交点。 |  作为擦除操作结果的面。 E 被完全擦除，B 和 D 被部分擦除。 A 和 C 未被擦除。 |
 线输入图层（绿色）和叠加图层（黄色）。 |  作为相交操作结果的线。 B 是 B 和 2 的交点。 D 是 D 和 4 的交点。 |  作为擦除操作结果的线。 要素 B 被完全擦除，且 D 被部分擦除。 A 和 C 未被擦除。 |
 点输入图层（绿色）和叠加图层（黄色）。 |  作为相交操作结果的点。 C 是 C 和 3 的交点。 |  作为擦除操作结果的点。 要素 C 已被擦除。 A 和 B 为操作结果。 |
在 ArcGIS Enterprise 10.6.1 中，如果两个图层均为面，则可以通过取消选中包含叠加输入图层参数（Python 中的 include_overlaps=NOT_OVERLAPPING）来提高分析速度。 如果以下两个条件均为 true，则仅应取消选中此输入：
如果您不希望为每个自相交重叠返回唯一结果，也可以取消选中此参数。 例如，人口普查边界不会有任何自叠置要素，且如果将其叠加到另一个不相交面图层上，则可以取消选中此参数。 此参数未在 ArcGIS Enterprise 10.7 或更高版本中使用。
在 ArcGIS Enterprise 10.7 或更高版本中，受支持的叠加方法和输入几何将如下表所述：
| 输入和叠加几何类型 | 相交 | 擦除 | 联合（10.7 中提供） | 标识（10.7 中提供） | 对称差集（10.7 中提供） |
|---|---|---|---|---|---|
点和点 |  可在 10.6.1 及更高版本中使用。 | 可在 10.6.1 及更高版本中使用。 | 可在 10.7 及更高版本中使用。 | 可在 10.7 及更高版本中使用。 | |
点和折线 | 可在 10.7 及更高版本中使用。 | ||||
点和面 | 可在 10.7 及更高版本中使用。 | 可在 10.7 及更高版本中使用。 | |||
折线和点 | 可在 10.7 及更高版本中使用。 | ||||
折线和折线 | 可在 10.6.1 及更高版本中使用。 | 可在 10.6.1 及更高版本中使用。 | 可在 10.7 及更高版本中使用。 | 可在 10.7 及更高版本中使用。 | |
折线和面 | 可在 10.7 及更高版本中使用。 | 可在 10.7 及更高版本中使用。 | |||
面和点 | 可在 10.7 及更高版本中使用。 | ||||
面和折线 | 可在 10.7 及更高版本中使用。 | ||||
面和面 | 可在 10.6.1 及更高版本中使用。 | 可在 10.6.1 及更高版本中使用。 | 可在 10.7 及更高版本中使用。 | 可在 10.7 及更高版本中使用。 | 可在 10.7 及更高版本中使用。 |
| 叠加方法 | 描述 |
|---|---|
相交
| 将保留叠加中与输入要素叠加的要素或要素的各部分。 输入几何与要素几何必须相同。 这是默认设置。 |
擦除
| 会将输入图层中与叠加图层中的要素不重叠的部分写入输出。 |
联合
| 结果将包含输入图层和叠加图层的几何并集。 将所有要素及其属性都写入图层。 |
标识
| 结果中将包含输入要素和叠加要素的要素或部分要素。 输入图层和叠加图层中相叠置的要素或要素的各部分将被写入到输出图层中。 |
对称差集
| 结果中将包含不重叠的输入图层和叠加图层的要素或部分要素。 |
| 标注 | 说明 | 数据类型 |
输入图层 | 将与叠加图层重叠的点、线或面要素。 | Feature Set |
叠加图层 | 将与输入图层要素重叠的要素。 | Feature Set |
输出名称
| 输出要素服务的名称。 | String |
叠加类型
| 指定要执行的叠加的类型。
| String |
包括重叠输入图层
(可选) | 用于指定是一个还是两个输入图层具有重叠要素。 仅 ArcGIS Enterprise 10.6.1 支持此参数。
| Boolean |
Data Store
(可选) | 指定将用于保存输出的 ArcGIS Data Store。 默认设置为时空大数据存储。 在时空大数据存储中存储的所有结果都将存储在 WGS84 中。 在关系数据存储中存储的结果都将保持各自的坐标系。
| String |
| 标注 | 说明 | 数据类型 |
| 输出要素图层 | 将多个图层叠加到单个图层中。 | 要素集 |
arcpy.geoanalytics.OverlayLayers(input_layer, overlay_layer, output_name, overlay_type, {include_overlaps}, {data_store})| 名称 | 说明 | 数据类型 |
input_layer | 将与叠加图层重叠的点、线或面要素。 | Feature Set |
overlay_layer | 将与输入图层要素重叠的要素。 | Feature Set |
output_name | 输出要素服务的名称。 | String |
overlay_type | 指定要执行的叠加的类型。
| String |
include_overlaps (可选) | 用于指定是一个还是两个输入图层具有重叠要素。 仅 ArcGIS Enterprise 10.6.1 支持此参数。
| Boolean |
data_store (可选) | 指定将用于保存输出的 ArcGIS Data Store。 默认为 SPATIOTEMPORAL_DATA_STORE。 在时空大数据存储中存储的所有结果都将存储在 WGS84 中。 在关系数据存储中存储的结果都将保持各自的坐标系。
| String |
| 名称 | 说明 | 数据类型 |
| output | 将多个图层叠加到单个图层中。 | 要素集 |
以下 Python 窗口脚本演示了如何使用 OverlayLayers 函数。
# Name: OverlayLayers.py
# Description: Remove areas that are already developed from proposed development sites
#
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
inFeatures = "https://myGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_cityData/BigDataCatalogServer/areasOfInterest"
overlayFeatures = "https://myGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_cityData/BigDataCatalogServer/commercial"
outFS = "DevelopmentSites"
overlayType = "ERASE"
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Execute Overlay Layers
arcpy.geoanalytics.OverlayLayers(inFeatures, overlayFeatures, outFS,
overlayType, dataStore)将用于分析的坐标系。 除非由该参数进行指定，否则将基于输入坐标系完成分析。 对于 GeoAnalytics Tools，最终结果将存储于 WGS84 中的时空数据存储之内。