Räumliche Verbindung (Analysis Tools)

Zusammenfassung

Vereinigt Attribute aus einer oder mehreren Eingaben mit einer anderen Eingabe basierend auf der räumlichen Beziehung. Die Ziel-Features und die vereinigten Attribute aus den Verbindungs-Features werden in die Ausgabe-Feature-Class geschrieben.

Weitere Informationen zu räumlichen Verbindungen nach Feature-Typ

Verwendung

Bei der räumlichen Verbindung werden Zeilen aus den Werten Verbindungs-Features basierend auf ihren relativen räumlichen Positionen mit den Werten Ziel-Features verknüpft.
Standardmäßig werden alle Attribute der Verbindungs-Features an Attribute der Ziel-Features angehängt und in die Ausgabe-Feature-Class kopiert. Mithilfe des Parameters Feldzuordnung können Sie festlegen, welche Attribute in die Ausgabe geschrieben werden.
Der Ausgabe-Feature-Class werden die folgenden Felder hinzugefügt:
- Join_Count—Die Anzahl der Verbindungs-Features, die mit dem jeweiligen Ziel-Feature übereinstimmen.
  
  Wenn der Parameterwert für Verbindungs-Features eine einzelne Eingabe ist, enthält die Ausgabe standardmäßig ein Join_Count-Feld. Wenn es mehr als eine Eingabe gibt, enthält der Join-Zählfeldname standardmäßig den Namen der Eingabe, z. B. Input1_JoinCount, Input2_JoinCount und so weiter. Passen Sie diesen Feldnamen an, indem Sie die Spalte Join-Zählfeldname angeben.
- TARGET_FID—Die Objekt-ID des Ziel-Features
Ein zusätzliches Feld, JOIN_FID, wird der Ausgabe hinzugefügt, wenn der Parameter Verbindungsvorgang auf Eins-zu-Viele-Verbindung festgelegt ist. Dieses Feld stellt die Objekt-ID des Verbindungs-Features dar.
Wenn für den Parameter Verbindungsvorgang die Option Eins-zu-Viele-Verbindung gewählt ist, kann für jedes Ziel-Feature mehr als eine Zeile in der Ausgabe-Feature-Class vorhanden sein. Bestimmen Sie mit dem Feld JOIN_FID, welches Feature mit welchem Ziel-Feature (TARGET_FID) verbunden ist. Der Wert -1 für das JOIN_FID-Feld bedeutet, dass kein Feature der angegebenen räumlichen Beziehung mit dem Ziel-Feature entspricht.
Alle Eingabe-Ziel-Features werden in die Ausgabe-Feature-Class geschrieben, wenn die beiden folgenden Bedingungen erfüllt sind:
- Der Parameter Verbindungsvorgang ist auf Eins-zu-Viele-Verbindung festgelegt.
- Der Parameter Alle Ziel-Features beibehalten ist aktiviert.
Verwenden Sie zum dauerhaften Übertragen von Feldern in die Ziel-Feature-Class das Werkzeug [Räumliche Verbindung hinzufügen[(../data-management/add-spatial-join.yml) mit aktiviertem Parameter Felder dauerhaft verbinden.

Verwenden Sie den Parameter Feldzuordnung, um die Felder und deren Inhalte im Ausgabe-Dataset zu verwalten.
- Sie können Felder aus der Feldliste hinzufügen und entfernen, die Feldliste umsortieren und Felder umbenennen.
- Der Standarddatentyp eines Ausgabefeldes ist der Datentyp des zuerst gefundenen Eingabefeldes (mit diesem Namen). Sie können den Datentyp in einen anderen gültigen Datentyp ändern.
- Verwenden Sie eine Aktion, um festzulegen, wie die Werte aus einem oder mehreren Eingabefeldern in einem einzigen Ausgabefeld zusammengeführt werden sollen. Die verfügbaren Aktionen sind: Erste(r), Letzte(r), Verbinden, Summe, Mittelwert, Medianwert, Modus, Minimum, Maximum, Standardabweichung und Anzahl.
- Bei Verwendung von Verbinden können Sie ein Trennzeichen angeben, z. B. ein Komma oder andere Zeichen. Klicken Sie auf den Beginn des Textfeldes Trennzeichen, um die Trennzeichen hinzuzufügen.
- Standardabweichung ist keine gültige Option für einzelne Eingabewerte.
- Verwenden Sie die Option Exportieren, , um eine Feldzuordnung als .fieldmap-Datei zu speichern.
- Verwenden Sie die Option Laden , um eine .fieldmap-Datei zu laden. Der Feature-Layer oder das Dataset, der bzw. das in der Datei angegeben ist, muss mit dem im Werkzeug verwendeten Dataset übereinstimmen. Andernfalls wird der Parameter Feldzuordnung zurückgesetzt.
- Verwenden Sie die Schaltfläche Text ausschneiden bei Textquellfeldern, um auszuwählen, welche Zeichen aus einem Eingabewert in das Ausgabefeld extrahiert werden sollen. Um auf die Schaltfläche Text ausschneiden zuzugreifen, bewegen Sie den Mauszeiger über ein Textfeld in der Liste der Eingabefelder, und geben Sie dann die Start- und Endposition der Zeichen an.
- Felder können auch in Python-Skripts zugeordnet werden.

Die Aktionen im Parameter Feldzuordnung gelten nur für Attribute aus den Verbindungs-Features und wenn mehr als ein Feature einem Ziel-Feature zugeordnet ist (wenn Join_Count > 1). Wenn beispielsweise drei Features mit den DEPTH-Attributwerten 15,5, 2,5 und 3,3 vereinigt werden und die Aktion Mittelwert angegeben ist, weist das Ausgabefeld den Wert 6,1 auf. NULL-Werte in Join-Feldern werden bei der Statistikberechnung ignoriert. Beispielsweise führen 15,5, ein NULL-Wert und 2,5 zu einem Mittelwert von 9,0 und der Anzahl 2.
Wenn der Parameter Zuordnungsoption auf Nächste(r) oder Nächste(r) (geodätisch) festgelegt ist, können sich zwei oder mehrere Verbindungs-Features im gleichen Abstand zum Ziel-Feature befinden. In diesem Fall wird eines der Verbindungs-Features zufällig als passendes Feature ausgewählt (die Objekt-ID des Verbindungs-Features wirkt sich nicht auf diese zufällige Auswahl aus). Für die Suche nach dem zweit-, dritt- oder N-nächsten Feature verwenden Sie das Werkzeug Near-Tabelle erstellen.

Weitere Informationen zur Berechnung der Nähe
Wenn ein Verbindungs-Feature eine räumliche Beziehung mit mehreren Ziel-Features aufweist, wird es so oft gezählt, wie es dem Ziel-Feature zugeordnet wurde. Wenn sich beispielsweise ein Punkt in drei Polygonen befindet, wird er dreimal gezählt – einmal pro Polygon.
Der Parameter Attributabgleich filtert die Features, die mit der im Parameter Zuordnungsoption angegebenen räumlichen Beziehung übereinstimmen. Geben Sie Felder aus den Verbindungs- und Ziel-Features an, die zusätzlich zu ihrer räumlichen Beziehung übereinstimmende Attribute haben müssen.
Weitere Informationen zu der Verwendung der räumlichen Beziehungen Überschneiden 3D und In einer Entfernung (3D) finden Sie unter 3D-Beziehungen lagebezogen auswählen.

Beschriftung	Erläuterung	Datentyp
Ziel-Features	Die Attribute der Ziel-Features und die Attribute aus den verbundenen Features werden in die Ausgabe-Feature-Class übertragen. Eine Untermenge der Attribute kann aber im Parameter "Feldzuordnung" definiert werden.	Feature Layer
Features verbinden	Die Attribute aus den Verbindungs-Features werden mit den Attributen der Ziel-Features verbunden. In der Hilfe zum Parameter Verbindungsvorgang finden Sie weitere Informationen zu den Auswirkungen des Typs des Verbindungsvorgangs auf die Aggregation der verbundenen Attribute. Verwenden Sie die Spalte Join-Zählfeldname, um einen benutzerdefinierten Namen für das Join-Zählfeld anzugeben. Wenn es mehr als eine Eingabe gibt, wird standardmäßig der Feldname der Feature-Class verwendet. Spalten der Wertetabelle: Join Features—The features whose attributes will be joined to the target features. Join Count Field Name—The name of the join count field.	Value Table
Ausgabe-Feature-Class	Eine neue Feature-Class, in der die Attribute der Ziel- und Verbindungs-Features enthalten sind. Standardmäßig werden alle Attribute der Ziel-Features und die Attribute der verbundenen Features in die Ausgabe geschrieben. Welche Attribute übertragen werden, kann jedoch vom Parameter "Feldzuordnung" definiert werden.	Feature Class
Verbindungsvorgang (Optional)	Der Vorgang, bei dem die Ziel-Features mit den Verbindungs-Features in der Ausgabe-Feature-Class verbunden werden, wenn mehrere Verbindungs-Features gefunden werden, die über die gleiche räumliche Beziehung zu einem einzelnen Ziel-Feature verfügen. Eins-zu-Eins-Verbindung—Wenn mehrere Verbindungs-Features gefunden werden, die über die gleiche räumliche Beziehung zu einem einzelnen Ziel-Feature verfügen, werden die Attribute aus den vielen Verbindungs-Features mithilfe einer Feldzuordnungs-Vereinigungsregel zusammengefasst. Wenn innerhalb von zwei separaten Polygon-Verbindungs-Features beispielsweise ein einzelnes Punkt-Ziel-Feature gefunden wird, werden die Attribute aus den beiden Polygonen zusammengefasst, bevor sie in die Ausgabe-Point-Feature-Class übertragen werden. Wenn ein Polygon den Attributwert 3 und das andere den Wert 7 hat und die Vereinigungsregel "Sum" angegeben ist, ist der zusammengefasste Wert in der Ausgabe-Feature-Class 10. Dies ist die Standardeinstellung. Eins-zu-Viele-Verbindung—Falls mehrere Verbindungs-Features gefunden werden, die über die gleiche räumliche Beziehung zu einem einzelnen Ziel-Feature verfügen, enthält die Ausgabe-Feature-Class mehrere Kopien (Einträge) des Ziel-Features. Wenn zum Beispiel ein einzelnes Punkt-Ziel-Feature innerhalb von zwei separaten Polygon-Verbindungs-Features gefunden wird, enthält die Ausgabe-Feature-Class zwei Kopien des Ziel-Features: einen Eintrag mit den Attributen des einen Polygons und einen Eintrag mit den Attributen des anderen Polygons.	String
Alle Ziel-Features beibehalten (Optional)	Gibt an, ob in der Ausgabe-Feature-Class alle Ziel-Features beibehalten werden (Outer Join) oder nur jene, die über die angegebene räumliche Beziehung zu den Verbindungs-Features verfügen (Inner Join). Aktiviert—Alle Ziel-Features werden in der Ausgabe beibehalten (Outer Join). Dies ist die Standardeinstellung. Deaktiviert—Nur die Ziel-Features, die über die angegebene räumliche Beziehung zu den Verbindungs-Features verfügen, werden in der Ausgabe-Feature-Class beibehalten (Inner Join). Wenn beispielsweise eine Point-Feature-Class für die Ziel-Features und eine Polygon-Feature-Class für die Verbindungs-Features angegeben ist, und der Parameter `match_option` auf `WITHIN` festgelegt ist, enthält die Ausgabe-Feature-Class nur die Ziel-Features, die sich innerhalb eines Polygon-Verbindungs-Features befinden. Alle Ziel-Features, die sich nicht innerhalb eines Verbindungs-Features befinden, werden von der Ausgabe ausgeschlossen.	Boolean
Feldzuordnung (Optional)	Die Felder, die mit ihren jeweiligen Eigenschaften und Quellfeldern in die Ausgabe-Feature-Class einbezogen werden sollen. Die Ausgabe enthält standardmäßig alle Felder der Verbindungs- und Ziel-Features. Verwenden Sie die Feldzuordnung, um Felder hinzuzufügen, zu löschen, umzubenennen und neu anzuordnen sowie andere Feldeigenschaften zu ändern. Die Feldzuordnung kann verwendet werden, um Werte aus zwei oder mehr Eingabefeldern in einem einzigen Ausgabefeld zu kombinieren.	Field Mappings
Zuordnungsoption (Optional)	Gibt die Kriterien für die Zuordnung von Zeilen an. Überschneiden—Die Features in den Verbindungs-Features werden zugeordnet, wenn sie sich mit einem Ziel-Feature überschneiden. Dies ist die Standardeinstellung. Geben Sie im Parameter Suchradius die Entfernung an. Überschneiden 3D—Die Features in den Verbindungs-Features werden zugeordnet, wenn sie sich mit einem Ziel-Feature im dreidimensionalen Raum (x, y und z) überschneiden. Geben Sie im Parameter Suchradius die Entfernung an. In einer Entfernung—Die Features in den Verbindungs-Features werden zugeordnet, wenn sie sich innerhalb einer bestimmten Entfernung zum Ziel-Feature befinden. Geben Sie im Parameter Suchradius die Entfernung an. In einer geodätischen Entfernung—Diese Option 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. Verwenden Sie diese Option, wenn die Daten eine große geographische Ausdehnung abdecken oder das Koordinatensystem der Eingaben für Entfernungsberechnungen ungeeignet ist. In einer Entfernung (3D)—Die Features in den Verbindungs-Features werden zugeordnet, wenn sie sich innerhalb einer bestimmten Entfernung zum Ziel-Feature im dreidimensionalen Raum befinden. Geben Sie im Parameter Suchradius die Entfernung an. Enthält—Die Features in den Verbindungs-Features werden zugeordnet, wenn ein Ziel-Feature sie enthält. Als Ziel-Features müssen Polygone oder Polylinien verwendet werden. Bei dieser Option können die Ziel-Features keine Punkte sein, und die Verbindungs-Features können nur Polygone sein, wenn die Ziel-Features auch Polygone sind. Enthält vollständig—Die Features in den Verbindungs-Features werden zugeordnet, wenn ein Ziel-Feature sie vollständig enthält. Polygone können jedes beliebige Feature vollständig enthalten. Punkte können kein Feature vollständig enthalten, nicht einmal einen Punkt. Polylinien können nur Polylinien- und Punkt-Features vollständig enthalten. Enthält Clementini—Diese räumliche Beziehung ergibt die gleichen Ergebnisse wie Enthält vollständig. Eine Ausnahme ist, wenn sich das Verbindungs-Feature vollständig auf der Grenze des Ziel-Features befindet (kein Teil liegt inner- oder außerhalb). In diesem Fall wird das Feature nicht zugeordnet. "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 in den Verbindungs-Features werden zugeordnet, wenn sich ein Ziel-Feature innerhalb von ihnen befindet. Dies ist das Gegenteil von Enthält. Bei dieser Option können die Ziel-Features nur dann Polygone sein, wenn es sich bei den Verbindungs-Features ebenfalls um Polygone handelt. Punkte können nur dann Join-Features sein, wenn sie das Ziel sind. Vollständig innerhalb von—Die Features in den Verbindungs-Features werden zugeordnet, wenn ein Ziel-Feature vollständig darin enthalten ist. Dies ist das Gegenteil von Enthält vollständig. Innerhalb von Clementini—Die Ergebnisse stimmen mit denen für Innerhalb überein, es sei denn, das gesamte Feature in den Verbindungs-Features befindet sich auf der Grenze des Ziel-Features. In diesem Fall wird das Feature nicht zugeordnet. "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 in den Verbindungs-Features werden zugeordnet, wenn sie mit einem Ziel-Feature identisch sind. Verbindungs- und Ziel-Features müssen vom gleichen Shape-Typ sein – Punkt-zu-Punkt, Linie-zu-Linie oder Polygon-zu-Polygon. Grenzberührungen—Die Features in den Verbindungs-Features werden zugeordnet, wenn ihre Grenze ein Ziel-Feature berührt. Wenn es sich bei den Ziel- und Verbindungs-Features um Linien oder Polygone handelt, kann die Grenze der Verbindungs-Features die Grenze des Ziel-Features nur berühren. Kein Teil des Verbindungs-Features kann die Grenze des Ziel-Features durchdringen. Haben ein Liniensegment gemeinsam mit—Die Features in den Verbindungs-Features werden zugeordnet, wenn sie ein Liniensegment mit einem Ziel-Feature teilen. Die Verbindungs- und Ziel-Features müssen über eine Linien- oder Polygonform verfügen. Gekreuzt durch den Umriss von—Die Features in den Verbindungs-Features werden zugeordnet, wenn ein Ziel-Feature durch ihren Umriss gekreuzt wird. Die Verbindungs- und Ziel-Features müssen über eine Linien- oder Polygonform verfügen. Wenn für die Verbindungs- oder Ziel-Features Polygone verwendet werden, wird die Grenze (Linie) des Polygons verwendet. Linien, die einen Punkt schneiden, werden zugeordnet. Linien, die ein Liniensegment gemeinsam haben, werden nicht zugeordnet. Mit Mittelpunkt in—Die Features in den Verbindungs-Features werden zugeordnet, wenn der Mittelpunkt eines Ziel-Features darin enthalten ist. Der Mittelpunkt des Features wird wie folgt berechnet: Bei Polygonen und Multipoints wird der Schwerpunkt der Geometrie verwendet, bei Linien die geometrische Mitte. Geben Sie im Parameter Suchradius die Entfernung an. Nächste(r)—Das Feature in den Verbindungs-Features, das sich im kleinsten Abstand zu einem Ziel-Feature befindet, wird zugeordnet. Weitere Informationen finden Sie im Verwendungshinweis. Geben Sie im Parameter Suchradius die Entfernung an. Nächste(r) (geodätisch)—Diese Option entspricht der Option Nächste(r), es wird jedoch geodätische anstelle von planarer Entfernung verwendet. Verwenden Sie diese Option, wenn die Daten eine große geographische Ausdehnung abdecken oder das Koordinatensystem der Eingaben für Entfernungsberechnungen ungeeignet ist. Größte Überlappung—Die Features in den Verbindungs-Features werden dem Ziel-Feature mit der größten Überlappung zugeordnet.	String
Suchradius (Optional)	Verbindungs-Features, die sich innerhalb der hier angegebenen Entfernung eines Ziel-Features befinden, werden für die räumliche Verbindung berücksichtigt. Ein Suchradius ist nur gültig, wenn die räumliche Beziehung angegeben ist (der Parameter Zuordnungsoption ist auf Überschneiden, In einer Entfernung, In einer geodätischen Entfernung, Mit Mittelpunkt in, Nächste(r) oder Nächste(r) (geodätisch) festgelegt). Zum Beispiel wird bei Verwendung eines Suchradius von 100 Metern mit der räumlichen Beziehung In einer Entfernung ein Feature innerhalb von 100 Metern von einem Ziel-Feature verbunden. Für die drei In einer Entfernung-Beziehungen wird eine Entfernung von 0 verwendet, wenn kein Wert für den Suchradius angegeben wird.	Linear Unit
Entfernungsfeldname (Optional)	Der Name des Feldes, das die Entfernung zwischen dem Ziel-Feature und dem nächstgelegenen Verbindungs-Feature enthält. Dieses Feld wird der Ausgabe-Feature-Class hinzugefügt. Dieser Parameter ist nur gültig, wenn die räumliche Beziehung angegeben ist und der Parameter Zuordnungsoption auf Nächste(r) oder Nächste(r) (geodätisch) festgelegt ist. Der Wert dieses Feldes ist -1, wenn kein Feature innerhalb eines Suchradius gefunden wird. Wenn kein Feldname zur Verfügung steht, wird das Feld der Ausgabe-Feature-Class nicht hinzugefügt.	String
Felder abgleichen (Optional)	Feldpaare aus den Verbindungs-Features und Ziel-Features, die für den Attributabgleich verwendet werden. Nur die Datensätze aus den Verbindungs-Features, die übereinstimmende Feldwerte mit den Ziel-Features aufweisen, sind Teil der räumlichen Verbindung. Spalten der Wertetabelle: Join Fields—Fields from the join features that will be used for attribute matching. Target Fields—Fields from the target features that will be used for attribute matching.	Value Table

arcpy.analysis.SpatialJoin(target_features, join_features, out_feature_class, {join_operation}, {join_type}, {field_mapping}, {match_option}, {search_radius}, {distance_field_name}, {match_fields})

Name	Erläuterung	Datentyp
target_features	Die Attribute der Ziel-Features und die Attribute aus den verbundenen Features werden in die Ausgabe-Feature-Class übertragen. Eine Untermenge der Attribute kann aber im Parameter "Feldzuordnung" definiert werden.	Feature Layer
join_features [join_features,...]	Die Attribute aus den Verbindungs-Features werden mit den Attributen der Ziel-Features verbunden. In der Hilfe zum Parameter `join_operation` finden Sie weitere Informationen zu den Auswirkungen des Typs des Verbindungsvorgangs auf die Aggregation der verbundenen Attribute. Verwenden Sie die zweite Spalte, um einen benutzerdefinierten Namen für das Join-Zählfeld anzugeben. Wenn es mehr als eine Eingabe gibt, wird standardmäßig der Feldname der Feature-Class verwendet. Spalten der Wertetabelle: `Join Features`—The features whose attributes will be joined to the target features. `Join Count Field Name`—The name of the join count field.	Value Table
out_feature_class	Eine neue Feature-Class, in der die Attribute der Ziel- und Verbindungs-Features enthalten sind. Standardmäßig werden alle Attribute der Ziel-Features und die Attribute der verbundenen Features in die Ausgabe geschrieben. Welche Attribute übertragen werden, kann jedoch vom Parameter "Feldzuordnung" definiert werden.	Feature Class
join_operation (Optional)	Der Vorgang, bei dem die Ziel-Features mit den Verbindungs-Features in der Ausgabe-Feature-Class verbunden werden, wenn mehrere Verbindungs-Features gefunden werden, die über die gleiche räumliche Beziehung zu einem einzelnen Ziel-Feature verfügen. `JOIN_ONE_TO_ONE`—Wenn mehrere Verbindungs-Features gefunden werden, die über die gleiche räumliche Beziehung zu einem einzelnen Ziel-Feature verfügen, werden die Attribute aus den vielen Verbindungs-Features mithilfe einer Feldzuordnungs-Vereinigungsregel zusammengefasst. Wenn innerhalb von zwei separaten Polygon-Verbindungs-Features beispielsweise ein einzelnes Punkt-Ziel-Feature gefunden wird, werden die Attribute aus den beiden Polygonen zusammengefasst, bevor sie in die Ausgabe-Point-Feature-Class übertragen werden. Wenn ein Polygon den Attributwert 3 und das andere den Wert 7 hat und die Vereinigungsregel "Sum" angegeben ist, ist der zusammengefasste Wert in der Ausgabe-Feature-Class 10. Dies ist die Standardeinstellung. `JOIN_ONE_TO_MANY`—Falls mehrere Verbindungs-Features gefunden werden, die über die gleiche räumliche Beziehung zu einem einzelnen Ziel-Feature verfügen, enthält die Ausgabe-Feature-Class mehrere Kopien (Einträge) des Ziel-Features. Wenn zum Beispiel ein einzelnes Punkt-Ziel-Feature innerhalb von zwei separaten Polygon-Verbindungs-Features gefunden wird, enthält die Ausgabe-Feature-Class zwei Kopien des Ziel-Features: einen Eintrag mit den Attributen des einen Polygons und einen Eintrag mit den Attributen des anderen Polygons.	String
join_type (Optional)	Gibt an, ob in der Ausgabe-Feature-Class alle Ziel-Features beibehalten werden (Outer Join) oder nur jene, die über die angegebene räumliche Beziehung zu den Verbindungs-Features verfügen (Inner Join). `KEEP_ALL`—Alle Ziel-Features werden in der Ausgabe beibehalten (Outer Join). Dies ist die Standardeinstellung. `KEEP_COMMON`—Nur die Ziel-Features, die über die angegebene räumliche Beziehung zu den Verbindungs-Features verfügen, werden in der Ausgabe-Feature-Class beibehalten (Inner Join). Wenn beispielsweise eine Point-Feature-Class für die Ziel-Features und eine Polygon-Feature-Class für die Verbindungs-Features angegeben ist, und der Parameter `match_option` auf `WITHIN` festgelegt ist, enthält die Ausgabe-Feature-Class nur die Ziel-Features, die sich innerhalb eines Polygon-Verbindungs-Features befinden. Alle Ziel-Features, die sich nicht innerhalb eines Verbindungs-Features befinden, werden von der Ausgabe ausgeschlossen.	Boolean
field_mapping (Optional)	Die Felder, die mit ihren jeweiligen Eigenschaften und Quellfeldern in die Ausgabe-Feature-Class einbezogen werden sollen. Die Ausgabe enthält standardmäßig alle Felder der Verbindungs- und Ziel-Features. Verwenden Sie die Feldzuordnung, um Felder hinzuzufügen, zu löschen, umzubenennen und neu anzuordnen sowie andere Feldeigenschaften zu ändern. Die Feldzuordnung kann verwendet werden, um Werte aus zwei oder mehr Eingabefeldern in einem einzigen Ausgabefeld zu kombinieren. Verwenden Sie in Python die Klasse `FieldMappings` zur Definition dieses Parameters.	Field Mappings
match_option (Optional)	Gibt die Kriterien für die Zuordnung von Zeilen an. `INTERSECT`—Die Features in den Verbindungs-Features werden zugeordnet, wenn sie sich mit einem Ziel-Feature überschneiden. Dies ist die Standardeinstellung. Geben Sie im Parameter `search_radius` die Entfernung an. `INTERSECT_3D`—Die Features in den Verbindungs-Features werden zugeordnet, wenn sie sich mit einem Ziel-Feature im dreidimensionalen Raum (x, y und z) überschneiden. Geben Sie im Parameter `search_radius` die Entfernung an. `WITHIN_A_DISTANCE`—Die Features in den Verbindungs-Features werden zugeordnet, wenn sie sich innerhalb einer bestimmten Entfernung zum Ziel-Feature befinden. Geben Sie im Parameter `search_radius` die Entfernung an. `WITHIN_A_DISTANCE_GEODESIC`—Diese Option 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. Verwenden Sie diese Option, wenn die Daten eine große geographische Ausdehnung abdecken oder das Koordinatensystem der Eingaben für Entfernungsberechnungen ungeeignet ist. `WITHIN_A_DISTANCE_3D`—Die Features in den Verbindungs-Features werden zugeordnet, wenn sie sich innerhalb einer bestimmten Entfernung zum Ziel-Feature im dreidimensionalen Raum befinden. Geben Sie im Parameter `search_radius` die Entfernung an. `CONTAINS`—Die Features in den Verbindungs-Features werden zugeordnet, wenn ein Ziel-Feature sie enthält. Als Ziel-Features müssen Polygone oder Polylinien verwendet werden. Bei dieser Option können die Ziel-Features keine Punkte sein, und die Verbindungs-Features können nur Polygone sein, wenn die Ziel-Features auch Polygone sind. `COMPLETELY_CONTAINS`—Die Features in den Verbindungs-Features werden zugeordnet, wenn ein Ziel-Feature sie vollständig enthält. Polygone können jedes beliebige Feature vollständig enthalten. Punkte können kein Feature vollständig enthalten, nicht einmal einen Punkt. Polylinien können nur Polylinien- und Punkt-Features vollständig enthalten. `CONTAINS_CLEMENTINI`—Diese räumliche Beziehung ergibt die gleichen Ergebnisse wie `COMPLETELY_CONTAINS`, es sei denn, das Verbindungs-Feature befindet sich vollständig auf der Grenze des Ziel-Features (kein Teil liegt inner- oder außerhalb). In diesem Fall wird das Feature nicht zugeordnet. "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 in den Verbindungs-Features werden zugeordnet, wenn sich ein Ziel-Feature innerhalb von ihnen befindet. Dies ist das Gegenteil von `CONTAINS`. Bei dieser Option können die Ziel-Features nur dann Polygone sein, wenn es sich bei den Verbindungs-Features ebenfalls um Polygone handelt. Punkte können nur dann Join-Features sein, wenn sie das Ziel sind. `COMPLETELY_WITHIN`—Die Features in den Verbindungs-Features werden zugeordnet, wenn ein Ziel-Feature vollständig darin enthalten ist. Dies ist das Gegenteil von `COMPLETELY_CONTAINS`. `WITHIN_CLEMENTINI`—Die Ergebnisse stimmen mit denen für `WITHIN` überein, es sei denn, das gesamte Feature in den Verbindungs-Features befindet sich auf der Grenze des Ziel-Features. In diesem Fall wird das Feature nicht zugeordnet "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 in den Verbindungs-Features werden zugeordnet, wenn sie mit einem Ziel-Feature identisch sind. Verbindungs- und Ziel-Features müssen vom gleichen Shape-Typ sein – Punkt-zu-Punkt, Linie-zu-Linie oder Polygon-zu-Polygon. `BOUNDARY_TOUCHES`—Die Features in den Verbindungs-Features werden zugeordnet, wenn ihre Grenze ein Ziel-Feature berührt. Wenn es sich bei den Ziel- und Verbindungs-Features um Linien oder Polygone handelt, kann die Grenze der Verbindungs-Features die Grenze des Ziel-Features nur berühren. Kein Teil des Verbindungs-Features kann die Grenze des Ziel-Features durchdringen. `SHARE_A_LINE_SEGMENT_WITH`—Die Features in den Verbindungs-Features werden zugeordnet, wenn sie ein Liniensegment mit einem Ziel-Feature teilen. Die Verbindungs- und Ziel-Features müssen über eine Linien- oder Polygonform verfügen. `CROSSED_BY_THE_OUTLINE_OF`—Die Features in den Verbindungs-Features werden zugeordnet, wenn ein Ziel-Feature durch ihren Umriss gekreuzt wird. Die Verbindungs- und Ziel-Features müssen über eine Linien- oder Polygonform verfügen. Wenn für die Verbindungs- oder Ziel-Features Polygone verwendet werden, wird die Grenze (Linie) des Polygons verwendet. Linien, die einen Punkt schneiden, werden zugeordnet. Linien, die ein Liniensegment gemeinsam haben, werden nicht zugeordnet. `HAVE_THEIR_CENTER_IN`—Die Features in den Verbindungs-Features werden zugeordnet, wenn der Mittelpunkt eines Ziel-Features darin enthalten ist. Der Mittelpunkt des Features wird wie folgt berechnet: Bei Polygonen und Multipoints wird der Schwerpunkt der Geometrie verwendet, bei Linien die geometrische Mitte. Geben Sie im Parameter `search_radius` die Entfernung an. `CLOSEST`—Das Feature in den Verbindungs-Features, das sich im kleinsten Abstand zu einem Ziel-Feature befindet, wird zugeordnet. Weitere Informationen finden Sie im Verwendungshinweis. Geben Sie im Parameter `search_radius` die Entfernung an. `CLOSEST_GEODESIC`—Diese Option entspricht der Option `CLOSEST`, es wird jedoch geodätische anstelle von planarer Entfernung verwendet. Verwenden Sie diese Option, wenn die Daten eine große geographische Ausdehnung abdecken oder das Koordinatensystem der Eingaben für Entfernungsberechnungen ungeeignet ist. `LARGEST_OVERLAP`—Die Features in den Verbindungs-Features werden dem Ziel-Feature mit der größten Überlappung zugeordnet.	String
search_radius (Optional)	Verbindungs-Features, die sich innerhalb der hier angegebenen Entfernung eines Ziel-Features befinden, werden für die räumliche Verbindung berücksichtigt. Ein Suchradius ist nur gültig, wenn die räumliche Beziehung angegeben ist (der Parameter `match_option` ist auf `INTERSECT`, `WITHIN_A_DISTANCE`, `WITHIN_A_DISTANCE_GEODESIC`, `HAVE_THEIR_CENTER_IN`, `CLOSEST` oder `CLOSEST_GEODESIC` festgelegt). Zum Beispiel wird bei Verwendung von 100 Metern mit der räumlichen Beziehung `WITHIN_A_DISTANCE` ein Feature innerhalb von 100 Metern von einem Ziel-Feature verbunden Für die drei In einer Entfernung-Beziehungen wird eine Entfernung von 0 verwendet, wenn kein Wert für `search_radius` angegeben wird.	Linear Unit
distance_field_name (Optional)	Der Name des Feldes, das die Entfernung zwischen dem Ziel-Feature und dem nächstgelegenen Verbindungs-Feature enthält. Dieses Feld wird der Ausgabe-Feature-Class hinzugefügt. Dieser Parameter ist nur gültig, wenn die räumliche Beziehung angegeben ist und der Parameter `match_option` auf `CLOSEST` oder `CLOSEST_GEODESIC` festgelegt ist. Der Wert dieses Feldes ist -1, wenn kein Feature innerhalb eines Suchradius gefunden wird. Wenn kein Feldname zur Verfügung steht, wird das Feld der Ausgabe-Feature-Class nicht hinzugefügt.	String
match_fields [[join_field, target_field],...] (Optional)	Feldpaare aus den Verbindungs-Features und Ziel-Features, die für den Attributabgleich verwendet werden. Nur die Datensätze aus den Verbindungs-Features, die übereinstimmende Feldwerte mit den Ziel-Features aufweisen, sind Teil der räumlichen Verbindung. Spalten der Wertetabelle: `Join Fields`—Fields from the join features that will be used for attribute matching. `Target Fields`—Fields from the target features that will be used for attribute matching.	Value Table

Codebeispiel

SpatialJoin: Beispiel 1 (Python-Fenster)

Das folgende Skript veranschaulicht, wie die Funktion SpatialJoin in einem Python-Fenster verwendet wird.

import arcpy

target_features = "C:/data/usa.gdb/states"
join_features = "C:/data/usa.gdb/cities"
out_feature_class = "C:/data/usa.gdb/states_cities"

arcpy.analysis.SpatialJoin(target_features, join_features, out_feature_class)

SpatialJoin: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie Sie die Funktion SpatialJoin zum Verbinden der Attribute von Städten mit Bundesstaaten verwenden.

# Name: SpatialJoin_Example2.py
# Description: Join attributes of cities to states based on spatial relationships.

# Import system modules
import arcpy
import os

# Set local variables
workspace = r"C:\gpqa\mytools\spatialjoin\usa.gdb"
outWorkspace = r"C:\gpqa\mytools\spatialjoin\output.gdb"

# Want to join USA cities to states and calculate the mean city population
# for each state
targetFeatures = os.path.join(workspace, "states")
joinFeatures = os.path.join(workspace, "cities")

# Output will be the target features, states, with a mean city population field (mcp)
outfc = os.path.join(outWorkspace, "states_mcp2")

# Create a new fieldmappings and add the two input feature classes.
fieldmappings = arcpy.FieldMappings()
fieldmappings.addTable(targetFeatures)
fieldmappings.addTable(joinFeatures)

# First get the POP1990 fieldmap. POP1990 is a field in the cities feature class.
# The output will have the states with the attributes of the cities. Setting the
# field's merge rule to mean will aggregate the values for all of the cities for
# each state into an average value. The field is also renamed to be more appropriate
# for the output.
pop1990FieldIndex = fieldmappings.findFieldMapIndex("POP1990")
fieldmap = fieldmappings.getFieldMap(pop1990FieldIndex)

# Get the output field's properties as a field object
field = fieldmap.outputField

# Rename the field and pass the updated field object back into the field map
field.name = "mean_city_pop"
field.aliasName = "mean_city_pop"
fieldmap.outputField = field

# Set the merge rule to mean and then replace the old fieldmap in the mappings object
# with the updated one
fieldmap.mergeRule = "mean"
fieldmappings.replaceFieldMap(pop1990FieldIndex, fieldmap)

# Delete fields that are no longer applicable, such as city CITY_NAME and CITY_FIPS
# as only the first value will be used by default
x = fieldmappings.findFieldMapIndex("CITY_NAME")
fieldmappings.removeFieldMap(x)
y = fieldmappings.findFieldMapIndex("CITY_FIPS")
fieldmappings.removeFieldMap(y)

#Run the Spatial Join tool, using the defaults for the join operation and join type
arcpy.analysis.SpatialJoin(targetFeatures, joinFeatures, outfc, "#", "#", fieldmappings)

Umgebungen

Standard-Ausgabe-Z-Werte, M-Auflösung, M-Toleranz, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-M-Domäne, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, Ausgabe-Koordinatensystem, Ausdehnung, Ausgabe hat M-Werte, Ausgabe hat Z-Werte, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz

Lizenzierungsinformationen