Räumliche Verbindung hinzufügen (Data Management)

Zusammenfassung

Vereinigt Attribute eines Features basierend auf der räumlichen Beziehung mit den Attributen eines anderen. Die Ziel-Features und die verbundenen Attribute aus den Verbindungs-Features werden verbunden. Die Verbindung ist temporär.

Weitere Informationen finden Sie unter Lagebezogen auswählen – grafische Beispiele.

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.

• Mit dem Werkzeug werden für die temporäre Verbindung folgende Felder erstellt:

  • Join_Count: Die Anzahl der Verbindungs-Features, die mit dem jeweiligen Ziel-Feature übereinstimmen
  • TARGET_FID: Die Objekt-ID des Ziel-Features

• Dieses Werkzeug unterstützt keine Eins-zu-Viele-Verbindungen. Verwenden Sie für Eins-zu-Viele-Verbindungen das Werkzeug Räumliche Verbindung.

• Standardmäßig werden alle Attribute aus den Verbindungs-Features mit den Attributen der Ziel-Features verbunden. Mithilfe des Parameters Feldzuordnung können Sie festlegen, welche Attribute in die verbundene Ausgabe übernommen werden.

• Verwenden Sie den Parameter Feldzuordnung, um die Felder im Ausgabe-Dataset und deren Inhalt zu verwalten.

  • Um die Feldreihenfolge zu ändern, wählen Sie den Namen eines Feldes aus, und ziehen Sie es an die neue Position.
  • Als Datentyp der Ausgabefelder wird der Datentyp des zuerst gefundenen Eingabefeldes (dieses Namens) übernommen. Sie können den Datentyp jederzeit manuell in einen anderen gültigen Datentyp ändern.
  • Die verfügbaren Vereinigungsregeln lauten: Erste(r), Letzte(r), Verbinden, Summe, Mittelwert, Medianwert, Modus, Minimum, Maximum, Standardabweichung und Anzahl.
  • Bei der Anwendung der Vereinigungsregel Verbinden können Sie Ihr ein Trennzeichen angeben, wie z. B. Leerzeichen, Komma, Punkt, Bindestrich. Um ein Leerzeichen zu verwenden, muss sich der Mauszeiger am Anfang des Eingabefeldes befinden. Drücken Sie dann einmal die Leertaste.
  • Sie können Start- und Endpositionen von Textfeldern mithilfe der Formatoption festlegen.
  • Führen Sie die Standardabweichung nicht für eine einzelne Eingabe aus, da die Werte nicht durch 0 geteilt werden können. Die Standardabweichung ist daher keine gültige Option für Einzeleingaben.

  Weitere Informationen zur Feldzuordnung in Skripten

• Die Vereinigungsregeln im Parameter Feldzuordnung von Verbindungs-Features 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 Vereinigungsregel "Mean" 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, <Null> 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.

• Weitere Informationen zu der Verwendung der räumlichen Beziehungen Überschneiden 3D und In einer Entfernung (3D) finden Sie unter 3D-Beziehungen lagebezogen auswählen.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Ziel-Features	Die Attribute aus den Ziel-Features sowie den verbundenen Features werden mit dem Ziel-Feature-Layer verbunden. Allerdings kann eine Untermenge der zu übertragenden Attribute im Parameter Feldzuordnung definiert werden.	Feature Layer
Verbindungs-Features	Die Attribute aus den Verbindungs-Features werden mit den Attributen der Ziel-Features verbunden. In der Erläuterung zum Parameter Verbindungsvorgang finden Sie Informationen darüber, inwiefern sich der Verbindungsvorgang auf die Zusammenfassung der verbundenen Attribute auswirkt.	Feature Layer
Verbindungsvorgang (optional)	Dieser Parameter ist ausgeblendet und wird nicht unterstützt. Alle Verbindungen erfolgen als Eins-zu-Eins-Verbindung. Um bei der Erstellung der Ausgabe in einer Ausgabe-Feature-Class eine Eins-zu-Viele-Verbindung zu erhalten, müssen Sie das Werkzeug Räumliche Verbindung verwenden.	String
Alle Ziel-Features beibehalten (optional)	Gibt an, ob nur Ziel-Features, die eine räumliche Beziehung zu einem Verbindungs-Feature aufweisen, beibehalten werden (sog. Inner Join) oder ob alle Ziel-Features beibehalten werden, selbst wenn sie nicht über eine räumliche Beziehung zu den Verbindungs-Features verfügen (sog. Outer Join). Aktiviert: Alle Features im Ziel-Feature-Layer werden beibehalten. Dies ist die Standardeinstellung. Deaktiviert: Nur die Features im Ziel-Feature-Layer, die über eine räumliche Beziehung zu einem Verbindungs-Feature verfügen, werden beibehalten.	Boolean
Feldzuordnung (optional)	Die Attributfelder, die in die Ausgabe geschrieben werden, sowie zugehörige Feldeigenschaften und Quellfelder. Standardmäßig werden alle Felder der Eingaben aufgenommen. Felder können hinzugefügt, gelöscht, umbenannt und neu angeordnet werden. Zudem können Sie deren Eigenschaften ändern. Mit Vereinigungsregeln geben Sie an, wie Werte aus zwei oder mehr Eingabefeldern zu einem einzigen Ausgabewert zusammengeführt bzw. kombiniert werden. Es gibt mehrere Vereinigungsregeln, mit denen Sie bestimmen können, wie das Ausgabefeld mit Werten gefüllt wird. Erste(r): Der erste Wert des Eingabefeldes wird verwendet. Letzte(r): Der letzte Wert des Eingabefeldes wird verwendet. Verbinden: Führt die Werte des Eingabefeldes zusammen (verbindet sie). Summe: Berechnet den Gesamtbetrag der Werte des Eingabefeldes. Mittelwert: Berechnet den Mittelwert (Durchschnitt) der Werte des Eingabefeldes. Medianwert: Berechnet den Medianwert (Mittelwert) der Werte des Eingabefeldes. Modus: Verwendet den Wert mit der größten Häufigkeit. Min: Verwendet den Minimalwert aller Werte des Eingabefeldes. Max: Verwendet den Maximalwert aller Werte des Eingabefeldes. Standardabweichung: Wendet die Klassifizierungsmethode "Standardabweichung" auf alle Werte des Eingabefeldes an. Anzahl: Gibt die Anzahl der Datensätze zurück, die in der Berechnung enthalten sind.	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 ein Ziel-Feature schneiden. Dies ist die Standardeinstellung. Geben Sie im Parameter Suchradius eine 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 eine 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 eine Entfernung an. In einer geodätischen Entfernung—Wie In einer Entfernung, es wird jedoch geodätische anstelle von planarer Entfernung verwendet. Legen Sie fest, ob die Daten eine große geographische Ausdehnung abdecken oder ob das Koordinatensystem der Eingaben für Entfernungsberechnungen geeignet 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 eine 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 Punkte vollständig enthalten. Enthält Clementini—Diese räumliche Beziehung liefert 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. Es 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-Feature müssen vom gleichen Shape-Typ sein – Punkt-zu-Punkt, Linie-zu-Linie und 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. Dies gilt nicht für Linien, die ein Liniensegment gemeinsam haben. 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 eine Entfernung an. Nächste(r)—Das Feature in den Verbindungs-Features wird zugeordnet, das sich im kleinsten Abstand zu einem Ziel-Feature befindet. Weitere Informationen finden Sie im Verwendungshinweis. Geben Sie im Parameter Suchradius eine Entfernung an. Nächster(r) (geodätisch)—Wie Nächste(r), es wird jedoch geodätische anstelle von planarer Entfernung verwendet. Legen Sie fest, ob die Daten eine große geographische Ausdehnung abdecken oder ob das Koordinatensystem der Eingaben für Entfernungsberechnungen geeignet 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 eines Feldes, das der Verbindung hinzugefügt wird und die Entfernung zwischen dem Ziel-Feature und dem nächstgelegenen Verbindungs-Feature enthält. Dieser Parameter ist nur gültig, wenn die räumliche Beziehung angegeben ist (Zuordnungsoption ist auf Nächste(r) oder Nächste(r) (geodätisch) festgelegt). Der Wert dieses Feldes ist -1, wenn kein Feature innerhalb eines Suchradius gefunden wird. Wenn kein Feldname angegeben wird, wird das Feld nicht der Verbindung hinzugefügt.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Feature-Class	Das aktualisierte Eingabe-Dataset.	Feature Class

Python

arcpy.management.AddSpatialJoin(target_features, join_features, {join_operation}, {join_type}, {field_mapping}, {match_option}, {search_radius}, {distance_field_name})

Name	Erläuterung	Datentyp
target_features	Die Attribute aus den Ziel-Features sowie den verbundenen Features werden mit dem Ziel-Feature-Layer verbunden. Allerdings kann eine Untermenge der zu übertragenden Attribute im Parameter field_mapping definiert werden.	Feature Layer
join_features	Die Attribute aus den Verbindungs-Features werden mit den Attributen der Ziel-Features verbunden. In der Erläuterung zum Parameter join_operation finden Sie Informationen darüber, inwiefern sich der Verbindungsvorgang auf die Zusammenfassung der verbundenen Attribute auswirkt.	Feature Layer
join_operation (optional)	Dieser Parameter wird nicht unterstützt. Alle Verbindungen erfolgen als Eins-zu-Eins-Verbindung. Bei der Verwendung von Positionsargumenten in Python müssen Sie den Typ None, eine leere Zeichenfolge ("" oder '') oder das Schlüsselwort JOIN_ONE_TO_ONE verwenden. Um bei der Erstellung der Ausgabe in einer Ausgabe-Feature-Class eine Eins-zu-Viele-Verbindung zu erhalten, müssen Sie das Werkzeug Räumliche Verbindung verwenden.	String
join_type (optional)	Gibt an, ob nur Ziel-Features, die eine räumliche Beziehung zu einem Verbindungs-Feature aufweisen, beibehalten werden (sog. Inner Join) oder ob alle Ziel-Features beibehalten werden, selbst wenn sie nicht über eine räumliche Beziehung zu den Verbindungs-Features verfügen (sog. Outer Join). KEEP_ALL—Alle Features im Ziel-Feature-Layer werden beibehalten. Dies wird als "Outer Join" bezeichnet. Dies ist die Standardeinstellung. KEEP_COMMON—Nur die Features im Ziel-Feature-Layer, die über eine räumliche Beziehung zu einem Verbindungs-Feature verfügen, werden beibehalten. Dies wird als "Inner Join" bezeichnet.	Boolean
field_mapping (optional)	Die Attributfelder, die in die Ausgabe geschrieben werden, sowie zugehörige Feldeigenschaften und Quellfelder. Standardmäßig werden alle Felder der Eingaben aufgenommen. Felder können hinzugefügt, gelöscht, umbenannt und neu angeordnet werden. Zudem können Sie deren Eigenschaften ändern. Mit Vereinigungsregeln geben Sie an, wie Werte aus zwei oder mehr Eingabefeldern zu einem einzigen Ausgabewert zusammengeführt bzw. kombiniert werden. Es gibt mehrere Vereinigungsregeln, mit denen Sie bestimmen können, wie das Ausgabefeld mit Werten gefüllt wird. Erste(r): Der erste Wert des Eingabefeldes wird verwendet. Letzte(r): Der letzte Wert des Eingabefeldes wird verwendet. Verbinden: Führt die Werte des Eingabefeldes zusammen (verbindet sie). Summe: Berechnet den Gesamtbetrag der Werte des Eingabefeldes. Mittelwert: Berechnet den Mittelwert (Durchschnitt) der Werte des Eingabefeldes. Medianwert: Berechnet den Medianwert (Mittelwert) der Werte des Eingabefeldes. Modus: Verwendet den Wert mit der größten Häufigkeit. Min: Verwendet den Minimalwert aller Werte des Eingabefeldes. Max: Verwendet den Maximalwert aller Werte des Eingabefeldes. Standardabweichung: Wendet die Klassifizierungsmethode "Standardabweichung" auf alle Werte des Eingabefeldes an. Anzahl: Gibt die Anzahl der Datensätze zurück, die in der Berechnung enthalten sind. In Python kann dieser Parameter mit der Klasse FieldMappings definiert werden.	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 ein Ziel-Feature schneiden. Dies ist die Standardeinstellung. Geben Sie im Parameter search_radius eine 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 eine 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 eine Entfernung an. WITHIN_A_DISTANCE_GEODESIC—Wie WITHIN_A_DISTANCE, es wird jedoch geodätische anstelle von planarer Entfernung verwendet. Legen Sie fest, ob die Daten eine große geographische Ausdehnung abdecken oder ob das Koordinatensystem der Eingaben für Entfernungsberechnungen geeignet 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 eine 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 Punkte vollständig enthalten. CONTAINS_CLEMENTINI—Diese räumliche Beziehung liefert die gleichen Ergebnisse wie COMPLETELY_CONTAINS. 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. WITHIN—Die Features in den Verbindungs-Features werden zugeordnet, wenn sich ein Ziel-Feature innerhalb von ihnen befindet. Es 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-Feature müssen vom gleichen Shape-Typ sein – Punkt-zu-Punkt, Linie-zu-Linie und 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. Dies gilt nicht für Linien, die ein Liniensegment gemeinsam haben. 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 eine Entfernung an. CLOSEST—Das Feature in den Verbindungs-Features wird zugeordnet, das sich im kleinsten Abstand zu einem Ziel-Feature befindet. Weitere Informationen finden Sie im Verwendungshinweis. Geben Sie im Parameter search_radius eine Entfernung an. CLOSEST_GEODESIC—Wie CLOSEST, es wird jedoch geodätische anstelle von planarer Entfernung verwendet. Legen Sie fest, ob die Daten eine große geographische Ausdehnung abdecken oder ob das Koordinatensystem der Eingaben für Entfernungsberechnungen geeignet 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 WITHIN_A_DISTANCE-Beziehungen wird eine Entfernung von 0 verwendet, wenn kein Wert für search_radius angegeben wird.	Linear Unit
distance_field_name (optional)	Der Name eines Feldes, das der Verbindung hinzugefügt wird und die Entfernung zwischen dem Ziel-Feature und dem nächstgelegenen Verbindungs-Feature enthält. Dieser Parameter ist nur gültig, wenn die räumliche Beziehung angegeben ist (match_option ist auf CLOSEST oder CLOSEST_GEODESIC festgelegt). Der Wert dieses Feldes ist -1, wenn kein Feature innerhalb eines Suchradius gefunden wird. Wenn kein Feldname angegeben wird, wird das Feld nicht der Verbindung hinzugefügt.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_feature_class	Das aktualisierte Eingabe-Dataset.	Feature Class

Codebeispiel

AddSpatialJoin – Beispiel 1 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht die Verwendung der Funktion AddSpatialJoin in einem eigenständigen Skript.

import os
import arcpy
arcpy.env.overwriteOutput = True

# Create hexagons
out_gdb = arcpy.env.scratchGDB
hex_fc = os.path.join(out_gdb, 'out_fc_hex_2')

arcpy.management.GenerateTessellation(
    hex_fc, '-10823285.769168 4836611.80759869 -10781728.9441187 4856999.87422328', 
    'HEXAGON', '17269676,2624 Unknown', arcpy.SpatialReference(3857))

# Create 2 random points in each hexagon
count_pts = 2
pts_fc = arcpy.management.CreateRandomPoints(
    out_gdb, 'out_fc_crp_2', constraining_feature_class=hex_fc, 
    number_of_points_or_field=count_pts)[0]

# Join the point attributes based on points within the hexagons
result = arcpy.management.AddSpatialJoin(
    hex_fc, pts_fc, None, None, 'CID', 'COMPLETELY_CONTAINS')
)

Umgebungen

Standard-Ausgabe-Z-Wert, 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

Lizenzinformationen

• Basic: Ja
• Standard: Ja
• Advanced: Ja