Räumliche Verbindung (Analyse)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

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

Anzeigen von graphischen Beispielen zur Erläuterung räumlicher Beziehungen

Verwendung

Syntax

SpatialJoin_analysis (target_features, join_features, out_feature_class, {join_operation}, {join_type}, {field_mapping}, {match_option}, {search_radius}, {distance_field_name})
ParameterErläuterungDatentyp
target_features

Die Attribute der Ziel-Features und die Attribute aus den verbundenen Features werden in die Ausgabe-Feature-Class übertragen. Eine Untermenge der zu übertragenden Attribute kann aber im Parameter "Feldzuordnung" definiert werden. Bei den Ziel-Features kann es sich um beliebige räumliche Datenquellen handeln, die von ArcGIS unterstützt 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 Verbindungsvorgang finden Sie Informationen darüber, inwiefern sich der Verbindungsvorgang auf die Zusammenfassung der verbundenen Attribute auswirkt.

Feature Layer
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" gesteuert werden.

Feature Class
join_operation
(optional)

Bestimmt die Behandlung von Verbindungen zwischen den Ziel-Features und den Verbindungs-Features in der Ausgabe-Feature-Class, wenn mehrere Verbindungs-Features gefunden werden, die über die gleiche räumliche Beziehung zu einem einzelnen Ziel-Feature verfügen.

  • JOIN_ONE_TO_ONEWenn 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. Die Option "JOIN_ONE_TO_ONE" ist die Standardeinstellung.
  • JOIN_ONE_TO_MANYFalls 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)

Ermittelt, 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_ALLAlle 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 die Zuordnungsoption "WITHIN" lautet, 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)

Steuert, welche Attributfelder in der Ausgabe-Feature-Class enthalten sind. Die ursprüngliche Liste enthält alle Felder aus den Ziel-Features und den Verbindungs-Features. Felder können hinzugefügt, gelöscht oder umbenannt und die Eigenschaften der Felder geändert werden. Die ausgewählten Felder aus den Ziel-Features werden ohne Veränderung übertragen, aber die ausgewählten Felder aus den Verbindungs-Features können durch eine Vereinigungsregel zusammengefasst werden. Weitere Informationen zur Feldzuordnung finden Sie unter Verwenden des Feldzuordnung-Steuerelements und Zuordnen von Eingabefeldern zu Ausgabefeldern. Es können mehrere Felder und Statistikkombinationen angegeben werden.

Field Mappings
match_option
(optional)

Definiert die Kriterien für den Abgleich von Zeilen. Es gibt die folgenden Zuordnungsoptionen:

  • INTERSECTDie Features in den Verbindungs-Features werden zugeordnet, wenn sie ein Ziel-Feature schneiden. Dies ist die Standardeinstellung.
  • 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.
  • 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 Suchradius eine Entfernung an.
  • 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 Suchradius eine 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 Punkte vollständig enthalten.
  • CONTAINS_CLEMENTINIDiese 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.
  • WITHINDie 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_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-Feature müssen vom gleichen Shape-Typ sein – Punkt-zu-Punkt, Linie-zu-Linie und Polygon-zu-Polygon.
  • BOUNDARY_TOUCHESDie Features in den Verbindungs-Features werden zugeordnet, wenn ihre Grenze ein Ziel-Feature berührt. Die Verbindungs- und Ziel-Features müssen über eine Linien- oder Polygonform verfügen. Darüber hinaus muss das Feature in den Verbindungs-Features entweder außerhalb oder vollständig innerhalb des Ziel-Polygons liegen.
  • 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. Dies gilt nicht für Linien, die ein Liniensegment gemeinsam haben.
  • 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.
  • CLOSESTDas Feature in den Verbindungs-Features wird zugeordnet, das sich im kleinsten Abstand zu einem Ziel-Feature befindet. Weitere Informationen finden Sie im Verwendungshinweis.
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 (Zuordnungsoption) "INTERSECT" oder "CLOSEST" angegeben wird. Die Verwendung eines Suchradius von 100 Metern mit der räumlichen Beziehung "INTERSECT" entspricht folgender Aussage: Wenn ein Verbindungs-Feature innerhalb von 100 Metern eines Ziel-Features liegt, soll das Verbindungs-Feature als Übereinstimmung betrachtet werden.

Linear unit
distance_field_name
(optional)

Der Name eines Feldes, das der Ausgabe-Feature-Class hinzugefügt werden soll und die Entfernung zwischen dem Ziel-Feature und dem nächstgelegenen Verbindungs-Feature enthält. Die Option ist nur gültig, wenn die räumliche Beziehung (Zuordnungsoption) "CLOSEST" angegeben wird. Der Wert dieses Feldes ist -1, wenn kein Feature innerhalb eines Suchradius gefunden wird. Falls kein Entfernungsfeldname angegeben ist, wird das Feld der Ausgabe-Feature-Class nicht hinzugefügt.

String

Codebeispiel

SpatialJoin – Beispiel 1 (Python-Fenster)

Das folgende Skript veranschaulicht, wie Sie die Funktion "SpatialJoin" in einem Python-Fenster verwenden.

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.SpatialJoin_analysis(target_features, join_features, out_feature_class)
SpatialJoin – Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie Sie das Werkzeug "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.
# Requirements: os module

# 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.SpatialJoin_analysis(targetFeatures, joinFeatures, outfc, "#", "#", fieldmappings)

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Ja
ArcGIS for Desktop Standard: Ja
ArcGIS for Desktop Advanced: Ja
9/11/2013