Layer lagebezogen auswählen (Data Management Tools)

Zusammenfassung

Wählt Features auf Grundlage einer räumlichen Beziehung zu Features in einem anderen oder im selben Dataset aus.

Die einzelnen Features im Parameter Eingabe-Features werden anhand der Features im Parameter Auswahl-Features ausgewertet. Wenn der festgelegte Parameterwert Beziehung erfüllt ist, wird das Eingabe-Feature ausgewählt.

Weitere Informationen zu "Lagebezogen auswählen" und Beispielabbildungen von Beziehungen

Verwendung

Wenn es sich bei der Eingabe um eine Feature-Class oder einen Dataset-Pfad handelt, wird von diesem Werkzeug ein neuer Layer erstellt und mit dem Ergebnis des angewendeten Werkzeugs zurückgegeben.
Das Koordinatensystem, in dem die räumliche Beziehung ausgewertet wird, kann sich auf das Ergebnis auswirken. Features, die sich in einem Koordinatensystem überschneiden, überschneiden sich in einem anderen möglicherweise nicht.
- Dieses Werkzeug wertet eine räumliche Beziehung im Koordinatensystem des Wertes des Parameters Eingabe-Features aus. Legen Sie die Umgebungseinstellung Ausgabe-Koordinatensystem auf Aktuelle Karte [Karte] fest, um dasselbe Koordinatensystem wie die aktuelle Anzeige zu verwenden.
Um Features auf der Grundlage ihrer räumlichen Beziehungen zu anderen Features im selben Layer auszuwählen, siehe die Beispiele unter Auswählen anhand einer räumlichen Beziehung im Layer.
Die Anzahl der ausgewählten Datensätze wird im Geoverarbeitungsverlauf aufgeführt. Klicken Sie für den Zugriff auf Parameter > Anzahl. Zusätzlich kann die Anzahl der ausgewählten Datensätze mit dem Werkzeug Anzahl erhalten bestimmt werden. In Python kann auch über das Objekt Result des Werkzeugs auf die Anzahl der ausgewählten Datensätze zugegriffen werden.
Bei Verwendung dieses Werkzeugs ist es ein mögliches und ein gültiges Ergebnis, wenn keines der Features die Kriterien für die Auswahl erfüllt. In diesem Fall wird eine Auswahl auf den Layer ohne ausgewählte Features angewendet. Geoverarbeitungswerkzeuge, die diesen Layer als Eingabe verwenden, erhalten dann bei ihrer Ausführung keine Features. Das Werkzeug Anzahl erhalten gibt dann zum Beispiel den Wert 0 zurück. Um diese oder eine andere Auswahl zu entfernen, verwenden Sie im Werkzeug Layer nach Attributen auswählen die Option Aktuelle Auswahl löschen des Parameters Auswahltyp.
Wenn der Eingabe-Layer eine Definitionsabfrage enthält, dann werden nur die Features, die mit der Definitionsabfrage übereinstimmen, in der Operation und als Kandidaten für die Auswahl verwendet.
Weitere Informationen zu den Optionen Überschneiden 3D und In einer Entfernung (3D) für die dreidimensionalen räumlichen Beziehungen finden Sie unter 3D-Beziehungen lagebezogen auswählen.
Für den Parameter Beziehung kann die Option Überschneiden (DBMS) eine bessere Performance als die Option Überschneiden bieten, wenn Enterprise-Geodatabase-Daten verwendet werden; diese Option wird jedoch nur unter bestimmten Bedingungen unterstützt. Wenn alle Bedingungen erfüllt sind, wird die räumliche Operation im Enterprise-Geodatabase-Datenbankmanagementsystem (DBMS) und nicht auf dem Client durchgeführt. Berücksichtigen Sie bei Verwendung dieser Option für räumliche Beziehungen Folgendes:
- Zum Ausführen der Operation innerhalb des DBMS müssen die folgenden Voraussetzungen erfüllt sein:
  - Die Parameterwerte für Eingabe-Features und Auswahl-Features müssen aus demselben Enterprise-Geodatabase-Workspace stammen und denselben Raumbezug sowie Geometriespeichertyp aufweisen.
  - Der Benutzer, der sich mit der Geodatenbank verbindet, muss über die Berechtigung verfügen, eine Ansicht in der Datenbank zu erstellen, in der die Feature-Classes gespeichert sind.
  - Die unterstützten Geometriespeichertypen für diese Option sind ST_Geometry (IBM Db2, Oracle, PostgreSQL und SAP HANA), PostGIS (PostgreSQL), SDO_GEOMETRY (Oracle) sowie "Geometrie" und "Geographie" (Microsoft SQL Server). Unter Geodatabase-Verwaltung finden Sie Informationen zum Installieren und Konfigurieren Ihres DBMS sowie zum Konfigurieren des Geometriespeichertyps Ihrer Wahl, damit Sie ihn verwenden können. Nähere Informationen zum jeweiligen Geometriespeichertyp finden Sie in der Dokumentation des Anbieters Ihres DBMS. Beim Durchführen räumlicher Operationen kann es durch Speicherbeschränkungen zu Beeinträchtigungen der Performance und Skalierbarkeit kommen.
  - Wenn die Feature-Classes in Oracle ST_Geometry verwenden, um räumliche Daten zu speichern, müssen Sie "extproc" in Oracle für den Zugriff auf ST_Geometry konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von "extproc" für den Zugriff auf "ST_Geometry" in Oracle.
  - Der Parameter Suchentfernung ist nicht festgelegt.
  - Der Parameterwert für Auswahltyp ist Neue Auswahl.
  - Jede vor der Ausführung des Werkzeugs vorgenommene Auswahl wurde mit einer Layer-Definitionsabfrage erstellt, nicht mit einem Auswahlsatz.
- Die räumliche Operation wird ohne Anwendung einer XY-Toleranz bei der Verarbeitung durchgeführt. Die Verwendung einer XY-Toleranz wird im DBMS nicht unterstützt. Dies kann dazu führen, dass im Vergleich zur Durchführung der Analyse auf dem Client unter Anwendung einer XY-Toleranz geringfügig andere Auswahlen zurückgegeben werden. Weitere Informationen dazu, wie bei clientseitigen Operationen eine XY-Toleranz angewendet wird, finden Sie unter Grundlagen zu Feature-Classes.

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Features, die anhand der Werte des Parameters Auswahl-Features ausgewertet werden. Die Auswahl wird auf diese Features angewendet.	Feature Layer; Mosaic Layer
Beziehung (Optional)	Gibt die auszuwertende räumliche Beziehung an. Überschneiden—Die Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature schneiden. Dies ist die Standardeinstellung. Überschneiden 3D—Die Features im Eingabe-Layer werden ausgewählt, wenn sie sich mit einem Auswahl-Feature im dreidimensionalen Raum (x, y und z) überschneiden. Überschneiden (DBMS)—Die Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature überschneiden. Diese Option gilt nur für Enterprise-Geodatabases. Wenn alle Anforderungen erfüllt sind (siehe die Verwendungshinweise), wird die Auswahl im Enterprise-Geodatabase-DBMS und nicht auf dem Client verarbeitet. Diese Option bietet möglicherweise eine bessere Performance als die Durchführung der Auswahl auf dem Client. In einer Entfernung—Die Features im Eingabe-Layer werden ausgewählt, wenn sie sich innerhalb der (mittels Euklidischen Abstands) angegebenen Entfernung zum Auswahl-Feature befinden. Geben Sie die Entfernung mithilfe des Parameters Suchentfernung an. In einer Entfernung (3D)—Die Features im Eingabe-Layer werden ausgewählt, wenn sie sich in einem bestimmten Abstand zu einem Auswahl-Feature im dreidimensionalen Raum befinden. Geben Sie die Entfernung mithilfe des Parameters Suchentfernung an. In einer geodätischen Entfernung—Diese räumliche Beziehung entspricht der Option In einer Entfernung, es wird jedoch geodätische anstelle von planarer Entfernung verwendet. Die Entfernung zwischen Features wird mit einer geodätischen Formel berechnet, bei der die Krümmung des Sphäroiden berücksichtigt und die Daten in der Nähe der Datumsgrenze und der Pole richtig verarbeitet werden. Wählen Sie diese Option aus, wenn die Daten eine große geographische Ausdehnung abdecken oder das Koordinatensystem der Eingaben für Entfernungsberechnungen ungeeignet ist. Geben Sie die Entfernung mithilfe des Parameters Suchentfernung an. Enthält—Die Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature enthalten. Enthält vollständig—Die Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature vollständig enthalten. Enthält Clementini—Diese räumliche Beziehung liefert die gleichen Ergebnisse wie die Option Enthält. Eine Ausnahme ist, wenn sich das Auswahl-Feature vollständig auf der Grenze des Eingabe-Features befindet (kein Teil liegt inner- oder außerhalb). In diesem Fall wird das Feature nicht ausgewählt. "Clementini" legt das Grenzpolygon als Linie zwischen innen und außen fest. Die Grenze einer Linie ist als ihr Endpunkt definiert, und die Grenze eines Punktes ist immer leer. Innerhalb—Die Features im Eingabe-Layer werden ausgewählt, wenn sie innerhalb eines Auswahl-Features liegen. Vollständig innerhalb von—Die Features im Eingabe-Layer werden ausgewählt, wenn sie vollständig innerhalb eines Auswahl-Features liegen bzw. in diesem enthalten sind. Innerhalb von Clementini—Das Ergebnis stimmt mit dem Ergebnis für die Option Innerhalb überein, es sei denn, das gesamte Feature im Eingabe-Layer befindet sich auf der Grenze des Features im Auswahl-Layer. In diesem Fall wird das Feature nicht ausgewählt. "Clementini" legt das Grenzpolygon als Linie zwischen innen und außen fest. Die Grenze einer Linie ist als ihr Endpunkt definiert, und die Grenze eines Punktes ist immer leer. Sind identisch zu—Die Features im Eingabe-Layer werden ausgewählt, wenn ihre geometrische Form mit der eines Auswahl-Features übereinstimmt. Grenzberührungen—Die Features im Eingabe-Layer werden ausgewählt, wenn ihre Grenze ein Auswahl-Feature berührt. Wenn es sich bei den Eingabe-Features um Linien oder Polygone handelt, kann die Grenze des Eingabe-Features die Grenze des Auswahl-Features nur berühren. Kein Teil des Eingabe-Features kann die Grenze des Auswahl-Features kreuzen. Haben ein Liniensegment gemeinsam mit—Die Features im Eingabe-Layer werden ausgewählt, wenn sie mit einem Auswahl-Feature ein gemeinsames Liniensegment teilen. Die Eingabe- und Auswahl-Features müssen Linien oder Polygone sein. Gekreuzt durch den Umriss von—Die Features im Eingabe-Layer werden ausgewählt, wenn sie vom Umriss eines Auswahl-Features geschnitten werden. Die Eingabe- und Auswahl-Features müssen Linien oder Polygone sein. Wenn für den Eingabe- oder Auswahl-Layer Polygone verwendet werden, wird die Grenze (Linie) des Polygons verwendet. Linien, die sich in einem Punkt schneiden, werden ausgewählt. Dies gilt jedoch nicht für Linien, die ein Liniensegment gemeinsam haben. Mit Mittelpunkt in—Die Features im Eingabe-Layer werden ausgewählt, wenn ihr Mittelpunkt innerhalb eines Auswahl-Features liegt. Der Mittelpunkt des Features wird wie folgt berechnet: Bei Polygonen und Multipoints wird der Schwerpunkt der Geometrie verwendet, bei Linien die geometrische Mitte.	String
Auswahl-Features (Optional)	Die Features im Parameter Eingabe-Features werden auf Grundlage ihrer Beziehung zu den Features dieses Layers oder dieser betreffenden Feature-Class ausgewählt.	Feature Layer
Suchentfernung (Optional)	Die Entfernung, in der gesucht wird. Dieser Parameter ist nur dann gültig, wenn der Parameter Beziehung auf eine der folgenden Optionen festgelegt wurde: Überschneiden, Überschneiden 3D, In einer Entfernung, In einer Entfernung 3D, In einer geodätischen Entfernung, Enthält oder Mit Mittelpunkt in. Wenn die Option In einer geodätischen Entfernung angegeben ist, dann verwenden Sie eine lineare Einheit wie Kilometer oder Meilen.	Linear Unit
Auswahltyp (Optional)	Gibt an, wie die Auswahl auf die Eingabe angewendet und mit einer vorhandenen Auswahl kombiniert wird. Dieses Werkzeug bietet keine Option, eine vorhandene Auswahl aufzuheben. Verwenden Sie dazu im Werkzeug Layer nach Attributen auswählen die Option Aktuelle Auswahl löschen des Parameters Auswahltyp. Neue Auswahl—Die getätigte Auswahl ersetzt eine bestehende Auswahl. Dies ist die Standardeinstellung. Zur aktuellen Auswahl hinzufügen—Die getätigte Auswahl wird einer bestehenden Auswahl hinzugefügt. Wenn keine Auswahl vorhanden ist, entspricht diese Option der Option Neue Auswahl. Aus aktueller Auswahl entfernen—Die getätigte Auswahl wird aus einer bestehenden Auswahl entfernt. Wenn keine Auswahl vorhanden ist, hat der Vorgang keine Auswirkungen. Teilmenge aus der aktuellen Auswahl auswählen—Die getätigte Auswahl wird mit der bestehenden Auswahl kombiniert. Nur Datensätze, die in beiden Auswahlen vorhanden sind, bleiben ausgewählt. Aktuelle Auswahl umkehren—Die Auswahl wird umgekehrt. Alle bisher ausgewählten Datensätze werden aus der Auswahl entfernt, und alle bisher nicht ausgewählten Datensätze werden der Auswahl hinzugefügt. Die Parameter Auswahl-Features sowie Beziehung werden bei Aktivierung dieser Option ignoriert.	String
Räumliche Beziehung umkehren (Optional)	Gibt an, ob das Ergebnis der Auswertung der räumlichen Beziehung verwendet wird oder das gegenteilige Ergebnis. Dieser Parameter kann beispielsweise verwendet werden, um eine Liste von Features abzurufen, die sich nicht überschneiden oder nicht innerhalb einer angegebenen Entfernung von Features in einem anderen Dataset liegen. Aktiviert—Das Gegenteil des Evaluierungsergebnisses wird verwendet. Wenn der Parameter Auswahltyp verwendet wird, erfolgt die Umkehrung der Auswahl vor dem Kombinieren mit einer vorhandenen Auswahl. Deaktiviert—Das Evaluierungsergebnis wird verwendet. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Layer mit Auswahl	Die erste Eingabe mit der angewendeten Auswahl.	Feature Layer; Mosaic Layer
Ausgabe-Layer-Namen	Ein MultiValue-Parameter, der alle Eingaben enthält, für die eine Auswahl vorliegt. Verwenden Sie diesen Ausgabeparameter in einem Modell, um ein Werkzeug wie Zusammenführen (Merge) mit einer MultiValue-Eingabe zu verbinden.	Feature Layer; Mosaic Layer
Anzahl	Die Anzahl der ausgewählten Datensätze. Wenn es mehrere Werte für den Parameter Eingabe-Features gibt, wird die Anzahl in der Reihenfolge der Eingaben ausgegeben.	Long

Beschriftung

Erläuterung

Datentyp

Layer mit Auswahl

Die erste Eingabe mit der angewendeten Auswahl.

Feature Layer; Mosaic Layer

Ausgabe-Layer-Namen

Ein MultiValue-Parameter, der alle Eingaben enthält, für die eine Auswahl vorliegt.

Verwenden Sie diesen Ausgabeparameter in einem Modell, um ein Werkzeug wie Zusammenführen (Merge) mit einer MultiValue-Eingabe zu verbinden.

Feature Layer; Mosaic Layer

Anzahl

Die Anzahl der ausgewählten Datensätze.

Wenn es mehrere Werte für den Parameter Eingabe-Features gibt, wird die Anzahl in der Reihenfolge der Eingaben ausgegeben.

Long

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

Name	Erläuterung	Datentyp
in_layer [in_layer,...]	Die Features, die anhand der Werte des Parameters `select_features` ausgewertet werden. Die Auswahl wird auf diese Features angewendet.	Feature Layer; Mosaic Layer
overlap_type (Optional)	Gibt die auszuwertende räumliche Beziehung an. `INTERSECT`—Die Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature schneiden. Dies ist die Standardeinstellung. `INTERSECT_3D`—Die Features im Eingabe-Layer werden ausgewählt, wenn sie sich mit einem Auswahl-Feature im dreidimensionalen Raum (x, y und z) überschneiden. `INTERSECT_DBMS`—Die Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature überschneiden. Diese Option gilt nur für Enterprise-Geodatabases. Wenn alle Anforderungen erfüllt sind (siehe die Verwendungshinweise), wird die Auswahl im Enterprise-Geodatabase-DBMS und nicht auf dem Client verarbeitet. Diese Option bietet möglicherweise eine bessere Performance als die Durchführung der Auswahl auf dem Client. `WITHIN_A_DISTANCE`—Die Features im Eingabe-Layer werden ausgewählt, wenn sie sich innerhalb der (mittels Euklidischen Abstands) angegebenen Entfernung zum Auswahl-Feature befinden. Geben Sie die Entfernung mithilfe des Parameters `search_distance` an. `WITHIN_A_DISTANCE_3D`—Die Features im Eingabe-Layer werden ausgewählt, wenn sie sich in einem bestimmten Abstand zu einem Auswahl-Feature im dreidimensionalen Raum befinden. Geben Sie die Entfernung mithilfe des Parameters `search_distance` an. `WITHIN_A_DISTANCE_GEODESIC`—Diese räumliche Beziehung entspricht der Option `WITHIN_A_DISTANCE`, es wird jedoch geodätische anstelle von planarer Entfernung verwendet. Die Entfernung zwischen Features wird mit einer geodätischen Formel berechnet, bei der die Krümmung des Sphäroiden berücksichtigt und die Daten in der Nähe der Datumsgrenze und der Pole richtig verarbeitet werden. Wählen Sie diese Option aus, wenn die Daten eine große geographische Ausdehnung abdecken oder das Koordinatensystem der Eingaben für Entfernungsberechnungen ungeeignet ist. Geben Sie die Entfernung mithilfe des Parameters `search_distance` an. `CONTAINS`—Die Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature enthalten. `COMPLETELY_CONTAINS`—Die Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature vollständig enthalten. `CONTAINS_CLEMENTINI`—Diese räumliche Beziehung liefert die gleichen Ergebnisse wie die Option `CONTAINS`. Eine Ausnahme ist, wenn sich das Auswahl-Feature vollständig auf der Grenze des Eingabe-Features befindet (kein Teil liegt inner- oder außerhalb). In diesem Fall wird das Feature nicht ausgewählt. "Clementini" legt das Grenzpolygon als Linie zwischen innen und außen fest. Die Grenze einer Linie ist als ihr Endpunkt definiert, und die Grenze eines Punktes ist immer leer. `WITHIN`—Die Features im Eingabe-Layer werden ausgewählt, wenn sie innerhalb eines Auswahl-Features liegen. `COMPLETELY_WITHIN`—Die Features im Eingabe-Layer werden ausgewählt, wenn sie vollständig innerhalb eines Auswahl-Features liegen bzw. in diesem enthalten sind. `WITHIN_CLEMENTINI`—Das Ergebnis stimmt mit dem Ergebnis für die Option `WITHIN` überein, es sei denn, das gesamte Feature im Eingabe-Layer befindet sich auf der Grenze des Features im Auswahl-Layer. In diesem Fall wird das Feature nicht ausgewählt. "Clementini" legt das Grenzpolygon als Linie zwischen innen und außen fest. Die Grenze einer Linie ist als ihr Endpunkt definiert, und die Grenze eines Punktes ist immer leer. `ARE_IDENTICAL_TO`—Die Features im Eingabe-Layer werden ausgewählt, wenn ihre geometrische Form mit der eines Auswahl-Features übereinstimmt. `BOUNDARY_TOUCHES`—Die Features im Eingabe-Layer werden ausgewählt, wenn ihre Grenze ein Auswahl-Feature berührt. Wenn es sich bei den Eingabe-Features um Linien oder Polygone handelt, kann die Grenze des Eingabe-Features die Grenze des Auswahl-Features nur berühren. Kein Teil des Eingabe-Features kann die Grenze des Auswahl-Features kreuzen. `SHARE_A_LINE_SEGMENT_WITH`—Die Features im Eingabe-Layer werden ausgewählt, wenn sie mit einem Auswahl-Feature ein gemeinsames Liniensegment teilen. Die Eingabe- und Auswahl-Features müssen Linien oder Polygone sein. `CROSSED_BY_THE_OUTLINE_OF`—Die Features im Eingabe-Layer werden ausgewählt, wenn sie vom Umriss eines Auswahl-Features geschnitten werden. Die Eingabe- und Auswahl-Features müssen Linien oder Polygone sein. Wenn für den Eingabe- oder Auswahl-Layer Polygone verwendet werden, wird die Grenze (Linie) des Polygons verwendet. Linien, die sich in einem Punkt schneiden, werden ausgewählt. Dies gilt jedoch nicht für Linien, die ein Liniensegment gemeinsam haben. `HAVE_THEIR_CENTER_IN`—Die Features im Eingabe-Layer werden ausgewählt, wenn ihr Mittelpunkt innerhalb eines Auswahl-Features liegt. Der Mittelpunkt des Features wird wie folgt berechnet: Bei Polygonen und Multipoints wird der Schwerpunkt der Geometrie verwendet, bei Linien die geometrische Mitte.	String
select_features (Optional)	Die Features im Parameter Eingabe-Features werden auf Grundlage ihrer Beziehung zu den Features dieses Layers oder dieser betreffenden Feature-Class ausgewählt.	Feature Layer
search_distance (Optional)	Die Entfernung, in der gesucht wird. Dieser Parameter ist nur gültig, wenn der Parameter `overlap_type` auf `INTERSECT`, `INTERSECT_3D`, `WITHIN_A_DISTANCE`, `WITHIN_A_DISTANCE_3D`, `WITHIN_A_DISTANCE_GEODESIC`, `CONTAINS` oder `HAVE_THEIR_CENTER_IN` festgelegt wurde. Wenn die Option `WITHIN_A_DISTANCE_GEODESIC` angegeben ist, dann verwenden Sie eine lineare Einheit wie Kilometer oder Meilen.	Linear Unit
selection_type (Optional)	Gibt an, wie die Auswahl auf die Eingabe angewendet und mit einer vorhandenen Auswahl kombiniert wird. Dieses Werkzeug bietet keine Option, eine vorhandene Auswahl aufzuheben. Verwenden Sie dazu im Werkzeug Layer nach Attributen auswählen die Option `CLEAR_SELECTION` des Parameters `selection_type`. `NEW_SELECTION`—Die getätigte Auswahl ersetzt eine bestehende Auswahl. Dies ist die Standardeinstellung. `ADD_TO_SELECTION`—Die getätigte Auswahl wird einer bestehenden Auswahl hinzugefügt. Wenn keine Auswahl vorhanden ist, entspricht diese Option der Option `NEW_SELECTION`. `REMOVE_FROM_SELECTION`—Die getätigte Auswahl wird aus einer bestehenden Auswahl entfernt. Wenn keine Auswahl vorhanden ist, hat der Vorgang keine Auswirkungen. `SUBSET_SELECTION`—Die getätigte Auswahl wird mit der bestehenden Auswahl kombiniert. Nur Datensätze, die in beiden Auswahlen vorhanden sind, bleiben ausgewählt. `SWITCH_SELECTION`—Die Auswahl wird umgekehrt. Alle bisher ausgewählten Datensätze werden aus der Auswahl entfernt, und alle bisher nicht ausgewählten Datensätze werden der Auswahl hinzugefügt. Die Parameter `select_features` sowie `overlap_type` werden bei Aktivierung dieser Option ignoriert.	String
invert_spatial_relationship (Optional)	Gibt an, ob das Ergebnis der Auswertung der räumlichen Beziehung verwendet wird oder das gegenteilige Ergebnis. Dieser Parameter kann beispielsweise verwendet werden, um eine Liste von Features abzurufen, die sich nicht überschneiden oder nicht innerhalb einer angegebenen Entfernung von Features in einem anderen Dataset liegen. `INVERT`—Das Gegenteil des Evaluierungsergebnisses wird verwendet. Wenn der Parameter `selection_type` verwendet wird, erfolgt die Umkehrung der Auswahl vor dem Kombinieren mit einer vorhandenen Auswahl. `NOT_INVERT`—Das Evaluierungsergebnis wird verwendet. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Name Erläuterung Datentyp

Name	Erläuterung	Datentyp
out_layer_or_view	Die erste Eingabe mit der angewendeten Auswahl.	Feature Layer; Mosaic Layer
out_layers_or_views	Ein MultiValue-Parameter, der alle Eingaben enthält, für die eine Auswahl vorliegt. Verwenden Sie diesen Ausgabeparameter in einem Modell, um ein Werkzeug wie Zusammenführen (Merge) mit einer MultiValue-Eingabe zu verbinden.	Feature Layer; Mosaic Layer
count	Die Anzahl der ausgewählten Datensätze. Wenn es mehrere Werte für den Parameter `in_features` gibt, wird die Anzahl in der Reihenfolge der Eingaben ausgegeben.	Long

out_layer_or_view

Die erste Eingabe mit der angewendeten Auswahl.

Feature Layer; Mosaic Layer

out_layers_or_views

Ein MultiValue-Parameter, der alle Eingaben enthält, für die eine Auswahl vorliegt.

Verwenden Sie diesen Ausgabeparameter in einem Modell, um ein Werkzeug wie Zusammenführen (Merge) mit einer MultiValue-Eingabe zu verbinden.

Feature Layer; Mosaic Layer

count

Die Anzahl der ausgewählten Datensätze.

Wenn es mehrere Werte für den Parameter in_features gibt, wird die Anzahl in der Reihenfolge der Eingaben ausgegeben.

Long

Codebeispiel

SelectLayerByLocation: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion SelectLayerByLocation im Direkt-Modus verwendet wird.

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

SelectLayerByLocation: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript zeigt, wie mit der Funktion SelectLayerByLocation in einem Workflow Features auf Grundlage von Position und einer Attributabfrage in eine neue Feature-Class extrahiert werden.

# 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.management.SelectLayerByLocation('cities', 'INTERSECT',
                                                          'chihuahua')

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

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

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

SelectLayerByLocation: Beispiel 3 (eigenständiges Skript)

Das folgende eigenständige Skript zeigt eine Vielzahl von Verwendungsmöglichkeiten für die Optionen overlap_type und WITHIN_A_DISTANCE des Parameters WITHIN_A_DISTANCE_GEODESIC mit dem Parameter 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.management.SelectLayerByLocation('cities', 'WITHIN_A_DISTANCE',
                                       'chihuahua', '1.5 Miles')
arcpy.management.SelectLayerByLocation('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.management.SelectLayerByLocation('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.management.SelectLayerByLocation('cities', 'WITHIN_A_DISTANCE_GEODESIC',
                                       'chihuahua', '200')

Umgebungen

Aktueller Workspace, Ausgabe-Koordinatensystem, Ausdehnung

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Layer lagebezogen auswählen (Data Management Tools)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen