按位置选择图层 (数据管理)

摘要

根据与另一个数据集中的要素的空间关系来选择要素。

输入要素参数中的每个要素将根据选择要素参数中的要素进行评估。 如果满足指定的关系参数值，则选择输入要素。

了解有关“按位置选择”的详细信息，其中包括关系的图像示例

使用情况

• 如果输入为要素类或数据集路径，则此工具将自动创建并返回应用了该工具结果的新图层。

• 用来评估空间关系的坐标系可能会对结果产生影响。 在一个坐标系中相交的要素在另一个坐标系中可能不相交。

  • 此工具可在输入要素数据源的坐标系中评估空间关系。 将输出坐标系环境设置为当前地图 [图层] 可使用与当前显示区域相同的坐标系。

• 可使用该工具根据要素与同一图层中其他要素的空间关系来选择要素。 有关示例，请参阅在图层内基于空间关系进行选择。

• 所选记录的数量将在参数 > 计数下的地理处理历史中列出。 此外，获取计数工具也可以用于计算所选记录的数量。 在 Python 中，也可以通过工具的 Result 对象访问所选记录的数量。

• 有关使用三维空间关系 3D 相交和在某一 3D 距离范围内（Python 中 INTERSECT_3D 和 WITHIN_A_DISTANCE_3D）的详细信息，请参阅按 3D 位置关系选择。

• 在使用企业级地理数据库数据时，相交 (DBMS) 空间关系（Python 中的 INTERSECT_DBMS）可提供比相交关系（Python 中的 INTERSECT）更好的性能；但是，其仅在特定条件下才受支持。 如果满足所有条件，则空间操作将在企业级地理数据库管理系统 (DBMS) 中而非客户端上执行。 使用此空间关系时应考虑以下问题：

  • 要在 DBMS 中运行该操作，必须满足以下要求：
    • 输入要素和选择要素参数值来自同一企业级地理数据库工作空间，并且必须具有相同的空间参考和几何存储类型。
    • 基础 DBMS 为 IBM Db2、Oracle、PostgreSQL、SAP HANA 或 Microsoft SQL Server。
    • 此选项支持的几何存储类型为 ST_GEOMETRY（Db2、Oracle、PostgreSQL 和 SAP HANA）、PostGIS (PostgreSQL)、SDO_GEOMETRY (Oracle)，以及 MSSQLGeometry 和 MSSQLGeography (SQL Server)。 有关安装和配置 DBMS 的信息，以及有关配置所选几何存储类型以使其可供使用的信息，请参阅地理数据库管理。
    • 如果您正在使用 Oracle ST_GEOMETRY，您必须配置 Oracle extproc 以访问 ST_Geometry。 有关详细信息，请参阅在 Oracle 中配置 extproc 以访问 ST_Geometry。
    • 未设置搜索距离参数。
    • 选择类型参数值为新建选择。
    • 运行该工具之前的现有选择是使用图层定义查询而非选择集进行的。
  • 在处理过程中无需应用 x,y 容差即可执行空间运算。 DBMS 不支持使用 x,y 容差。 与在应用 x,y 容差的客户端上执行分析时相比，这可能会导致返回的选择稍有不同。 有关如何在客户端操作期间应用 x,y 容差的详细信息，请参阅要素类基础知识。
  • 支持 Db2、Oracle、PostgreSQL、SAP HANA 和 SQL Server 中的企业级地理数据库。 每个数据库都有自己的受此关系支持的几何存储类型。 请参阅特定于您的 DBMS 的供应商文档，以确定每种几何存储类型的期望内容。 在运行空间操作时，可能会有一些存储限制会影响性能和可扩展性。

参数

对话框

标注	说明	数据类型
输入要素	将根据选择要素参数值进行评估的要素。 选择将应用于这些要素。	Feature Layer; Raster Layer; Mosaic Layer
关系 (可选)	指定要评估的空间关系。 相交—如果输入图层中的要素与某一选择要素相交，则会选择这些要素。 这是默认设置。 3D 相交—如果输入图层中的要素在三维空间（x、y 和 z）中与某一选择要素相交，则会选择这些要素。 相交 (DBMS)—如果输入图层中的要素与某一选择要素相交，则会选择这些要素。此选项仅适用于企业级地理数据库。 当满足所有要求时，选择将在企业级地理数据库 DBMS 中，而不是在客户端上进行处理（有关详细信息，请参阅使用说明）。与在客户端上执行选择相比，此选项可提供更好的性能。 在某一距离范围内—如果输入图层中的要素在某一选择要素的指定距离内（使用欧氏距离），则将选择这些要素。 使用搜索距离参数指定距离。 在某一测地线距离范围内—如果输入图层中的要素在某一选择要素的指定距离内，则会选择这些要素。 将使用测地线公式计算要素间的距离，这种方法考虑到椭球体的曲率，并可以正确处理跨越日期变更线和两极及其附近的数据。 使用搜索距离参数指定距离。 在某一 3D 距离范围内—如果输入图层中的要素在三维空间中的某一选择要素的指定距离内，则会选择这些要素。 使用搜索距离参数指定距离。 包含—如果输入图层中的要素包含选择要素，则会选择这些要素。 完全包含—如果输入图层中的要素完全包含选择要素，则会选择这些要素。 包含 (Clementini)—该空间关系产生的结果同包含，但有一种情况例外：如果选择要素完全位于输入要素的边界上（没有任何一部分完全位于里面或外面），则不会选择要素。Clementini 将边界面定义为用来分隔内部和外部的线，将线的边界定义为其端点，点的边界始终为空。 位于—如果输入图层中的要素位于选择要素中，则会选择这些要素。 完全在其他要素范围内—如果输入图层中的要素完全位于或包含在在选择要素之，则会选择这些要素。 包含于 (Clementini)—结果同位于，但下述情况例外：如果输入图层中的要素完全位于选择图层中要素的边界上，则不会选择该要素。Clementini 将边界面定义为用来分隔内部和外部的线，将线的边界定义为其端点，点的边界始终为空。 与其他要素相同—如果输入图层中的要素与选择要素相同（在几何形状上），则会选择这些要素。 边界接触—如果输入图层中要素的边界与某一选择要素接触，则会选择这些要素。 如果输入要素为线或面，则输入要素的边界只能接触选择要素的边界，且输入要素的任何部分均不可跨越选择要素的边界。 与其他要素共线—如果输入图层中的要素与某一选择要素共线，则会选择这些要素。 输入要素和选择要素必须是线或面。 与轮廓交叉—如果输入图层中的要素与某一选择要素的轮廓交叉，则会选择这些要素。 输入和选择要素必须是线或面。 如果将面用于输入或选择图层，则会使用面的边界（线）。 将选择在某一点交叉的线，而不会选择共线的线。 中心在要素范围内—如果输入图层中要素的中心落在某一选择要素内，则会选择这些要素。 要素中心的计算方式如下：对于面和多点，将使用几何的质心；对于线输入，则会使用几何的中点。	String
选择要素 (可选)	输入要素参数中的要素将根据它们与此图层或要素类中要素的关系进行选择。	Feature Layer
搜索距离 (可选)	将被搜索的距离。 仅当关系参数设置为在某一距离范围内、在某一测地线距离范围内、在某一 3D 距离范围内、相交、3D 相交、中心在要素范围内或者包含时，该参数才有效。 如果选择在某一测地线距离范围内选项，请使用线性单位（如千米或英里）。	Linear Unit
选择内容类型 (可选)	指定如何将选择内容应用于输入，以及如何同现有选择内容进行组合。 该工具不包含清除现有选择内容的选项；请使用按属性选择图层工具上的清除当前选择选项执行此操作。 新建选择内容—生成的选择内容将替换任何现有选择内容。 这是默认设置。 添加到当前选择内容—将生成的选择内容添加至现有选择内容。 如果不存在选择内容，该选项的作用同新建选择内容选项。 从当前选择内容中移除—将生成的选择内容从现有选择内容中移除。 如果不存在选择内容，此操作将不起作用。 选择当前选择内容的子集—将生成的选择内容与现有选择内容进行组合。 仅两者共有的记录保持选中状态。 切换当前选择内容—选择内容将被切换。 将所选的所有记录从选择内容中移除，将未选取的所有记录添加到当前选择内容中。如果选择该选项，则将忽略选择要素参数和关系参数。	String
反向空间关系 (可选)	指定将使用空间关系评估结果，还是使用反转结果。 例如，可使用此参数获取不相交或与另一数据集中的要素不在指定距离范围内的要素的列表。 未选中 - 将使用查询结果。 这是默认设置。 选中 - 将使用反转查询结果。 如果使用选择类型参数，则将先反转选择，然后再将其与现有选择组合。	Boolean

派生输出

标注	说明	数据类型
带有所选内容的图层	已应用选择的已更新输入。	Feature Layer; Mosaic Layer
输出图层名称	已更新输入的名称。	Feature Layer; Mosaic Layer
计数	所选记录的数量。	Long

Python

arcpy.management.SelectLayerByLocation(in_layer, {overlap_type}, {select_features}, {search_distance}, {selection_type}, {invert_spatial_relationship})

名称	说明	数据类型
in_layer [in_layer,...]	将根据 select_features 参数值进行评估的要素。 选择将应用于这些要素。	Feature Layer; Raster Layer; Mosaic Layer
overlap_type (可选)	指定要评估的空间关系。 INTERSECT—如果输入图层中的要素与某一选择要素相交，则会选择这些要素。 这是默认设置。 INTERSECT_3D—如果输入图层中的要素在三维空间（x、y 和 z）中与某一选择要素相交，则会选择这些要素。 INTERSECT_DBMS—如果输入图层中的要素与某一选择要素相交，则会选择这些要素。此选项仅适用于企业级地理数据库。 当满足所有要求时，选择将在企业级地理数据库 DBMS 中，而不是在客户端上进行处理（请参阅使用说明）。与在客户端上执行选择相比，此选项可提供更好的性能。 WITHIN_A_DISTANCE—如果输入图层中的要素在某一选择要素的指定距离内（使用欧氏距离），则将选择这些要素。 使用 search_distance 参数指定距离。 WITHIN_A_DISTANCE_3D—如果输入图层中的要素在三维空间中的某一选择要素的指定距离内，则会选择这些要素。 使用 search_distance 参数指定距离。 WITHIN_A_DISTANCE_GEODESIC—如果输入图层中的要素在某一选择要素的指定距离内，则会选择这些要素。 将使用测地线公式计算要素间的距离，这种方法考虑到椭球体的曲率，并可以正确处理跨越日期变更线和两极及其附近的数据。 使用 search_distance 参数指定距离。 CONTAINS—如果输入图层中的要素包含选择要素，则会选择这些要素。 COMPLETELY_CONTAINS—如果输入图层中的要素完全包含选择要素，则会选择这些要素。 CONTAINS_CLEMENTINI—该空间关系产生的结果同 CONTAINS，但有一种情况例外：如果选择要素完全位于输入要素的边界上（没有任何一部分完全位于里面或外面），则不会选择要素。Clementini 将边界面定义为用来分隔内部和外部的线，将线的边界定义为其端点，点的边界始终为空。 WITHIN—如果输入图层中的要素位于选择要素中，则会选择这些要素。 COMPLETELY_WITHIN—如果输入图层中的要素完全位于或包含在在选择要素之，则会选择这些要素。 WITHIN_CLEMENTINI—结果同 WITHIN，但下述情况例外：如果输入图层中的要素完全位于选择图层中要素的边界上，则不会选择该要素。Clementini 将边界面定义为用来分隔内部和外部的线，将线的边界定义为其端点，点的边界始终为空。 ARE_IDENTICAL_TO—如果输入图层中的要素与选择要素相同（在几何形状上），则会选择这些要素。 BOUNDARY_TOUCHES—如果输入图层中要素的边界与某一选择要素接触，则会选择这些要素。 如果输入要素为线或面，则输入要素的边界只能接触选择要素的边界，且输入要素的任何部分均不可跨越选择要素的边界。 SHARE_A_LINE_SEGMENT_WITH—如果输入图层中的要素与某一选择要素共线，则会选择这些要素。 输入要素和选择要素必须是线或面。 CROSSED_BY_THE_OUTLINE_OF—如果输入图层中的要素与某一选择要素的轮廓交叉，则会选择这些要素。 输入和选择要素必须是线或面。 如果将面用于输入或选择图层，则会使用面的边界（线）。 将选择在某一点交叉的线，而不会选择共线的线。 HAVE_THEIR_CENTER_IN—如果输入图层中要素的中心落在某一选择要素内，则会选择这些要素。 要素中心的计算方式如下：对于面和多点，将使用几何的质心；对于线输入，则会使用几何的中点。	String
select_features (可选)	输入要素参数中的要素将根据它们与此图层或要素类中要素的关系进行选择。	Feature Layer
search_distance (可选)	将被搜索的距离。 仅当 overlap_type 参数设置为以下选项时，该参数才有效：WITHIN_A_DISTANCE、WITHIN_A_DISTANCE_GEODESIC、WITHIN_A_DISTANCE_3D、INTERSECT、INTERSECT_3D、HAVE_THEIR_CENTER_IN 或 CONTAINS。 如果选择 WITHIN_A_DISTANCE_GEODESIC 选项，请使用线性单位，例如千米或英里。	Linear Unit
selection_type (可选)	指定如何将选择内容应用于输入，以及如何同现有选择内容进行组合。 该工具不包含清除现有选择内容的选项；请使用按属性选择图层工具上的 CLEAR_SELECTION 选项执行此操作。 NEW_SELECTION—生成的选择内容将替换任何现有选择内容。 这是默认设置。 ADD_TO_SELECTION—将生成的选择内容添加至现有选择内容。 如果不存在选择内容，该选项的作用同 NEW_SELECTION 选项。 REMOVE_FROM_SELECTION—将生成的选择内容从现有选择内容中移除。 如果不存在选择内容，此操作将不起作用。 SUBSET_SELECTION—将生成的选择内容与现有选择内容进行组合。 仅两者共有的记录保持选中状态。 SWITCH_SELECTION—选择内容将被切换。 将所选的所有记录从选择内容中移除，将未选取的所有记录添加到当前选择内容中。选择该选项时，将忽略 select_features 和 overlap_type 参数。	String
invert_spatial_relationship (可选)	指定将使用空间关系评估结果，还是使用反转结果。 例如，可使用此参数获取不相交或与另一数据集中的要素不在指定距离范围内的要素的列表。 NOT_INVERT—将使用查询结果。 这是默认设置。 INVERT—将使用反转查询结果。 如果使用 selection_type 参数，则将先反转选择，然后再将其与现有选择组合。	Boolean

派生输出

名称	说明	数据类型
out_layer_or_view	已应用选择的已更新输入。	Feature Layer; Mosaic Layer
out_layers_or_views	已更新输入的名称。	Feature Layer; Mosaic Layer
count	所选记录的数量。	Long

代码示例

SelectLayerByLocation 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 SelectLayerByLocation 函数。

import arcpy
arcpy.SelectLayerByLocation_management("parcel_lyr", "have_their_center_in", 
                                       "c:/kamsack.gdb/city_limits")

SelectLayerByLocation 示例 2（独立脚本）

以下独立脚本显示了如何在工作流中使用 SelectLayerByLocation 函数，以便根据位置和属性查询提取要素并将其导入一个新要素类中。

# Description: Extract features to a new feature class based on a 
#              location and an attribute query

# Import arcpy and set path to data
import arcpy
arcpy.env.workspace = "c:/data/mexico.gdb"

# Make a layer and select cities that overlap the chihuahua polygon
chihuahua_cities = arcpy.SelectLayerByLocation_management('cities', 'INTERSECT', 
                                                          'chihuahua')

# From the previous selection, select a subset of cities that have 
# population > 10,000
arcpy.SelectLayerByAttribute_management(chihuahua_cities, 
                                        'SUBSET_SELECTION', 
                                        '"population" > 10000')

# If features matched criteria, write them to a new feature class
matchcount = int(arcpy.GetCount_management(chihuahua_cities)[0]) 

if matchcount == 0:
    print('no features matched spatial and attribute criteria')
else:
    arcpy.CopyFeatures_management(chihuahua_cities, 'chihuahua_10000plus')
    print('{0} cities that matched criteria written to {0}'.format(
        matchcount, chihuahua_10000plus))

SelectLayerByLocation 示例 3（独立脚本）

以下独立脚本显示了 overlap_type 参数的 WITHIN_A_DISTANCE 和 WITHIN_A_DISTANCE_GEODESIC 选项与 search_distance 参数搭配使用时的多种用法。

# Description: Select features within a distance

# Import arcpy and set path to data
import arcpy

arcpy.env.workspace = r"c:\data\mexico.gdb"

arcpy.SelectLayerByLocation_management('cities', 'WITHIN_A_DISTANCE', 
                                       'chihuahua', '1.5 Miles')
arcpy.SelectLayerByLocation_management('cities', 'WITHIN_A_DISTANCE_GEODESIC', 
                                       'chihuahua', '200 Kilometers')

# When using WITHIN_A_DISTANCE, if distance units are not specified, the 
# distance value is assumed to be in the units of the input dataset's coordinate 
# system
arcpy.SelectLayerByLocation_management('cities', 'WITHIN_A_DISTANCE', 
                                       'chihuahua', '200')

# When using WITHIN_A_DISTANCE_GEODESIC, if distance units are not specified, 
# the distance value is assumed to be in meters
arcpy.SelectLayerByLocation_management('cities', 'WITHIN_A_DISTANCE_GEODESIC', 
                                       'chihuahua', '200')

环境

当前工作空间, 输出坐标系, 范围

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是