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.

Weitere Informationen finden Sie unter Grafische Beispiele für lagebezogene Auswahl.

Verwendung

  • Die verbundenen Attribute werden aggregiert und als separate Kopie gespeichert. Die Änderungen an den verbundenen Daten werden nicht übernommen, da sie statisch sind. Um die Daten zu aktualisieren, entfernen Sie die Verbindung, und führen Sie das Werkzeug erneut aus.

  • Das Werkzeug erstellt die folgenden Felder:

    • 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 der Verbindungs-Features mit den Attributen der Ziel-Features verbunden. Mithilfe des Parameters Feldzuordnung können Sie festlegen, welche Attribute in der verbundenen Ausgabe enthalten sein sollen.

  • 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.
    • Als Datentyp der Ausgabefelder wird der Datentyp des zuerst gefundenen Eingabefeldes (dieses Namens) übernommen. Sie können den Datentyp in einen anderen gültigen Datentyp ändern.
    • Verwenden Sie eine Aktion, um festzulegen, wie 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 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 mit 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 der Parameter Felder dauerhaft verbinden aktiviert ist, werden alle Datensätze im Ziel-Dataset beibehalten, auch wenn der Parameter Alle Ziel-Features beibehalten nicht aktiviert ist.

  • 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

BeschriftungErläuterungDatentyp
Ziel-Features

Die Attribute aus den Ziel-Features und die Attribute aus den Verbindungs-Features werden mit dem Ziel-Feature-Layer verbunden. Eine Untermenge der zu übertragenden 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 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 eine Eins-zu-Viele-Verbindung zu erhalten, wenn die Ausgabe in einer Ausgabe-Feature-Class erstellt wird, müssen Sie das Werkzeug Räumliche Verbindung verwenden.

String
Alle Ziel-Features beibehalten
(optional)

Gibt an, ob nur Ziel-Features mit einer räumlichen Beziehung mit einem Verbindungs-Feature (als Inner Join bezeichnet) oder alle Ziel-Features auch ohne räumliche Beziehung mit den Verbindungs-Features (als Outer Join bezeichnet) beibehalten werden.

  • Aktiviert: Alle Features im Ziel-Feature-Layer werden beibehalten. Dies ist die Standardeinstellung.
  • Deaktiviert: Nur Features im Ziel-Feature-Layer mit einer räumlichen Beziehung mit einem Verbindungs-Feature werden beibehalten.
Boolean
Feldzuordnung
(optional)

Die Felder, die vorübergehend mit ihren jeweiligen Eigenschaften und Quellfeldern mit dem Ziel-Dataset verbunden werden sollen. Alle Felder vom Verbindungs-Dataset werden standardmäßig einbezogen.

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.

  • ÜberschneidenDie Features in den Verbindungs-Features werden zugeordnet, wenn sie ein Ziel-Feature schneiden. Dies ist die Standardeinstellung. Geben Sie im Parameter Suchradius die Entfernung an.
  • Überschneiden 3DDie 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 EntfernungDie 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 EntfernungDiese 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ältDie 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ändigDie 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 ClementiniDiese 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.
  • InnerhalbDie 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 Verbindungs-Features sein, wenn sie das Ziel sind.
  • Vollständig innerhalb vonDie 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 ClementiniDie 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 zuDie 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ührungenDie 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.
  • Ein Liniensegment gemeinsam haben mitDie 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 vonDie 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 inDie 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 ÜberlappungDie 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 Verbindung hinzugefügt. 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. Falls kein Feldname angegeben ist, wird das Feld der Verbindung nicht hinzugefügt.

String
Felder dauerhaft verbinden
(optional)

Gibt an, ob die Felder aus der Join-Feature-Class dem Layer temporär hinzugefügt oder dauerhaft in die Ziel-Feature-Class aufgenommen werden.

  • Deaktiviert: Die Felder aus der Verbindungs-Feature-Class werden dem Layer temporär per Inner Join hinzugefügt. Dies ist die Standardeinstellung.
  • Aktiviert: Die Felder aus der Verbindungs-Feature-Class werden der Ziel-Feature-Class dauerhaft hinzugefügt.
Boolean
Felder für Abgleich
(optional)

Feldpaare aus den Verbindungs-Features und den 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 Verknüpfung.

Value Table

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierte Ziel-Features

Das aktualisierte Eingabe-Dataset.

Feature Layer

arcpy.management.AddSpatialJoin(target_features, join_features, {join_operation}, {join_type}, {field_mapping}, {match_option}, {search_radius}, {distance_field_name}, {permanent_join}, {match_fields})
NameErläuterungDatentyp
target_features

Die Attribute aus den Ziel-Features und die Attribute aus den Verbindungs-Features werden mit dem Ziel-Feature-Layer verbunden. Eine Teilmenge von Attributen kann jedoch mithilfe des Parameters 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 eine Eins-zu-Viele-Verbindung zu erhalten, wenn die Ausgabe in einer Ausgabe-Feature-Class erstellt wird, müssen Sie das Werkzeug Räumliche Verbindung verwenden.

String
join_type
(optional)

Gibt an, ob nur Ziel-Features mit einer räumlichen Beziehung mit einem Verbindungs-Feature (als Inner Join bezeichnet) oder alle Ziel-Features auch ohne räumliche Beziehung mit den Verbindungs-Features (als Outer Join bezeichnet) beibehalten werden.

  • KEEP_ALLAlle Features im Ziel-Feature-Layer werden beibehalten. Dies wird als "Outer Join" bezeichnet. Dies ist die Standardeinstellung.
  • KEEP_COMMONNur Features im Ziel-Feature-Layer mit einer räumlichen Beziehung mit einem Verbindungs-Feature werden beibehalten. Dies wird als "Inner Join" bezeichnet.
Boolean
field_mapping
(optional)

Die Felder, die vorübergehend mit ihren jeweiligen Eigenschaften und Quellfeldern mit dem Ziel-Dataset verbunden werden sollen. Alle Felder vom Verbindungs-Dataset werden standardmäßig einbezogen.

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.

In Python verwenden Sie die FieldMappings-Klasse zum Definieren dieses Parameters.

Field Mappings
match_option
(optional)

Gibt die Kriterien für die Zuordnung von Zeilen an.

  • INTERSECTDie Features in den Verbindungs-Features werden zugeordnet, wenn sie ein Ziel-Feature schneiden. Dies ist die Standardeinstellung. Geben Sie im Parameter search_radius die Entfernung an.
  • INTERSECT_3DDie 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_DISTANCEDie 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_GEODESICDiese 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_3DDie 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.
  • CONTAINSDie 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_CONTAINSDie 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_CLEMENTINIDiese 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.
  • WITHINDie 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 Verbindungs-Features sein, wenn sie das Ziel sind.
  • COMPLETELY_WITHINDie Features in den Verbindungs-Features werden zugeordnet, wenn ein Ziel-Feature vollständig darin enthalten ist. Dies ist das Gegenteil von COMPLETELY_CONTAINS.
  • WITHIN_CLEMENTINIDie 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_TODie 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_TOUCHESDie 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_WITHDie 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_OFDie 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_INDie 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.
  • CLOSESTDas 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_GEODESICDiese 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_OVERLAPDie 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 Verbindung hinzugefügt. 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. Falls kein Feldname angegeben ist, wird das Feld der Verbindung nicht hinzugefügt.

String
permanent_join
(optional)

Gibt an, ob die Felder aus der Join-Feature-Class dem Layer temporär hinzugefügt oder dauerhaft in die Ziel-Feature-Class aufgenommen werden.

  • NO_PERMANENT_FIELDSDie Felder aus der Verbindungs-Feature-Class werden dem Layer temporär per Inner Join hinzugefügt. Dies ist die Standardeinstellung.
  • PERMANENT_FIELDSDie Felder aus der Verbindungs-Feature-Class werden der Ziel-Feature-Class dauerhaft hinzugefügt.
Boolean
match_fields
[[join_field, target_field],...]
(optional)

Feldpaare aus den Verbindungs-Features und den 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 Verknüpfung.

Value Table

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_feature_class

Das aktualisierte Eingabe-Dataset.

Feature Layer

Codebeispiel

AddSpatialJoin: Beispiel 1 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion AddSpatialJoin in einem eigenständigen Skript verwendet wird.

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')

Lizenzinformationen

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

Verwandte Themen