将空间索引添加到 shapefile、文件地理数据库、移动地理数据库或企业级地理数据库要素类中。使用此工具可将空间索引添加到尚无空间索引的 shapefile 或要素类或者重新创建现有空间索引。
ArcGIS 使用空间索引来快速查找要素类中的要素。识别要素、通过点选或框选来选择要素以及平移和缩放都需要使用空间索引来查找要素。空间索引的定义方法是使用占据要素类中要素范围的基于格网的系统，类似于一般道路地图上的定位格网。
默认情况下，ArcGIS 创建和维护地理数据库要素类的空间索引。要使地理数据库不包含空间索引，必须使用移除空间索引工具将其显式移除。
向企业级地理数据库要素类添加新的空间索引是一项非常占用服务器资源的操作。在大量用户登录到服务器时，不得对大要素类执行此操作。
对于 SQL Server 和 Oracle 要素类，如果索引已经存在，则会将其删除和重新创建。边界框也会针对 SQL Server 要素类进行重新计算。
SAP HANA 要素类不支持空间索引。
| 标注 | 说明 | 数据类型 |
输入要素 | 要添加或重构空间索引的企业级地理数据库要素类、文件地理数据库要素类、移动地理数据库要素类或 shapefile。 | Feature Layer; Mosaic Layer |
空间格网 1 (可选) | 已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。 | Double |
空间格网 2 (可选) | 已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。 | Double |
空间格网 3 (可选) | 已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。 | Double |
| 标注 | 说明 | 数据类型 |
| 更新后的输入要素 | 更新后的输入要素。 | 要素图层；镶嵌图层 |
arcpy.management.AddSpatialIndex(in_features, {spatial_grid_1}, {spatial_grid_2}, {spatial_grid_3})| 名称 | 说明 | 数据类型 |
in_features | 要添加或重构空间索引的企业级地理数据库要素类、文件地理数据库要素类、移动地理数据库要素类或 shapefile。 | Feature Layer; Mosaic Layer |
spatial_grid_1 (可选) | 已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。 | Double |
spatial_grid_2 (可选) | 已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。 | Double |
spatial_grid_3 (可选) | 已在 ArcGIS Pro 中弃用此参数。将忽略您输入的任何值。 | Double |
| 名称 | 说明 | 数据类型 |
| out_feature_class | 更新后的输入要素。 | 要素图层；镶嵌图层 |
以下 Python 窗口脚本演示了如何在即时模式下使用 AddSpatialIndex 函数。
import arcpy
arcpy.env.workspace = "c:/Connections/Connection to esoracle.sde"
arcpy.AddSpatialIndex_management("LPI.Land/LPI.PLSSFirstDivision")以下 Python 脚本演示了如何在独立脚本中使用 AddSpatialIndex 函数。
# Name: AddSpatialIndex_Example2.py
# Description: Add a spatial index to a enterprise geodatabase feature class.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "c:/Connections/Connection to esoracle.sde"
# Execute AddSpatialIndex
arcpy.AddSpatialIndex_management(in_features)