Layer lagebezogen auswählen (Data Management)

Parameter

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; Raster 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 schneiden.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 Euklidischer Entfernung) angegebenen Entfernung zum Auswahl-Feature befinden. Geben Sie die Entfernung mithilfe des Parameters Suchentfernung an. In einer geodätischen Entfernung—Diese räumliche Beziehung entspricht 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. 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. 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. Ein Liniensegment gemeinsam haben 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 des betreffenden Layers oder der betreffenden Feature-Class ausgewählt.	Feature Layer
Suchentfernung (optional)	Die Entfernung, in der gesucht wird. Dieser Parameter ist nur gültig, wenn für den Parameter Beziehung eine der folgenden Optionen ausgewählt wurde: In einer Entfernung, In einer geodätischen Entfernung, In einer Entfernung 3D, Überschneiden, Überschneiden 3D, Mit Mittelpunkt in oder Enthält. Wenn die Option In einer Entfernung geodätisch ausgewählt ist, 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 von 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. Deaktiviert: Das Evaluierungsergebnis wird verwendet. Dies ist die Standardeinstellung. 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.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Layer mit Auswahl	Die erste Eingabe mit angewendeter 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; Raster 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 schneiden.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 Euklidischer Entfernung) 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 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 Ausgabe-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 des betreffenden Layers oder der 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 WITHIN_A_DISTANCE, WITHIN_A_DISTANCE_GEODESIC, WITHIN_A_DISTANCE_3D, INTERSECT, INTERSECT_3D, HAVE_THEIR_CENTER_IN oder CONTAINS. festgelegt wurde. Wenn die Option WITHIN_A_DISTANCE_GEODESIC ausgewählt ist, 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 von 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. NOT_INVERT—Das Evaluierungsergebnis wird verwendet. Dies ist die Standardeinstellung. 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.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_layer_or_view	Die erste Eingabe mit angewendeter 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: Beispiel1 (Python-Fenster)

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

Layer lagebezogen auswählen (Data Management)—ArcGIS Pro (2024)

Parameter

Abgeleitete Ausgabe

Abgeleitete Ausgabe

Codebeispiel