Features verbinden (GeoAnalytics)

Zusammenfassung

Verbindet Attribute aus einem Layer mit denen eines anderen basierend auf räumlichen, zeitlichen oder Attributbeziehungen oder einer Kombination aus diesen.

Abbildung

Abbildung des Werkzeugs "Features verbinden"
In beiden Beispielen ist eine räumlich-zeitliche Verbindung unter Verwendung des Werkzeugs "Features verbinden" dargestellt.

Verwendung

  • Bei einer räumlichen Verbindung werden Features (Zeilen) aus den Eingabe-Features (die Werte der Parameter Ziel-Layer und Join-Layer) basierend auf ihren räumlichen Positionen zugeordnet. Bei einer zeitlichen Verbindung werden Features (Zeilen) aus den Eingabe-Features basierend auf ihren zeitlichen Beziehungen zugeordnet. Bei einer Attributverbindung werden Features basierend auf Feldwerten zugeordnet.

  • Features können basierend auf einer räumlichen Beziehung, einer zeitlichen Beziehung, einer Attributbeziehung oder einer Kombination aus diesen verbunden werden.

    OptionenBeschreibung

    Räumliche Beziehung

    Die räumliche Beziehung, anhand derer festgelegt wird, ob Features miteinander verbunden werden. Die verfügbaren Beziehungen hängen vom Geometrietyp (Punkt, Linie oder Fläche) der Layer ab, die verbunden werden. Die folgenden räumlichen Beziehungen sind verfügbar:

    • Schneidet
    • Gleich
    • Nahe (planar): Verwendet planare Entfernungen.
    • Nahe (geodätisch): Verwendet geodätische Entfernungen. Dies ist nur in ArcGIS Enterprise 10.7.1 und höher verfügbar.
    • Enthält
    • Innerhalb
    • Berührt
    • Kreuzt
    • Überlappt

    Weitere Informationen zu räumlichen Beziehungen in GeoAnalytics Server-Werkzeugen

    Zeitliche Beziehung

    Die zeitliche Beziehung, anhand derer festgelegt wird, ob Features miteinander verbunden werden. Die verfügbaren Beziehungen hängen vom Geometrietyp (Zeitpunkt oder Intervall) der Layer ab, die verbunden werden. Die folgenden zeitlichen Beziehungen sind verfügbar:

    • Entspricht
    • Erfüllt von
    • Überlappt
    • Überlappt von
    • Zwischen
    • Enthält
    • Gleich
    • Beendet
    • Beendet von
    • Startet
    • Gestartet von
    • Schneidet
    • Nahe
    • Nahe vor
    • Nahe nach

    Weitere Informationen zu zeitlichen Beziehungen in GeoAnalytics Server-Werkzeugen

    Attributbeziehung

    Die Attributbeziehung, mit der festgelegt wird, ob Features miteinander verbunden werden. Die Features werden zugeordnet, wenn die Feldwerte im Join-Layer den Feldwerten im Ziel-Layer entsprechen.

  • Wenn sich Ziel- und Verbindungs-Features in unterschiedlichen Koordinatensystemen befinden, wird das Koordinatensystem des Ziel-Features verwendet. Wenn ein Ausgabekoordinatensystem angegeben ist, werden beide Features in das Ausgabekoordinatensystem projiziert und anschließend verbunden.

  • Wenn der Wert des Parameters Räumliche Beziehung auf Nahe (planar) festgelegt ist, muss der Wert des Parameters Ziel-Layer projiziert oder das Ausgabekoordinatensystem auf ein projiziertes Koordinatensystem festgelegt werden.

  • Wenn mehrere Features mit dem gleichen Ziel-Feature übereinstimmen, können Sie wie folgt entscheiden, ob alle übereinstimmenden Features verbunden werden sollen (Wert Eins-zu-Viele-Verbindung für Verbindungsvorgang) oder ob alle übereinstimmenden Features zusammen verbunden werden (Wert Eins-zu-Eins-Verbindung für Verbindungsvorgang):

    • Eins-zu-Viele-Verbindung: Verbindet alle übereinstimmenden Features im Join-Layer mit dem Ziel-Layer. Der Ergebnis-Layer enthält mehrere Datensätze des Ziel-Features.
    • Eins-zu-Eins-Verbindung: Alle übereinstimmenden Verbindungs-Features werden mit jedem Feature im Ziel-Layer zusammengefasst. In die Zusammenfassung und Ausgabe werden nur Features mit einer Übereinstimmung einbezogen. Die Anzahl der verbundenen Features wird neben anderen Statistiken wie Summe, Minimum, Maximum, Bereich, Mittelwert, Varianz und Standardabweichung hinzugefügt. Standardmäßig werden nur Zieldatensätze mit den angegebenen Beziehungen in der Ausgabe-Feature-Class beibehalten (dies wird als "Inner Join" bezeichnet). Wenn Alle Ziel-Features beibehalten aktiviert ist, werden alle Eingabe-Ziel-Features in die Ausgabe-Feature-Class geschrieben (dies wird als "Left Outer Join" bezeichnet).
    Beispiele für die Verbindung von eins zu viele und eins zu eins
    Es werden Beispiele für eine Eins-zu-Viele- und eine Eins-zu-eins-Verbindung gezeigt. In diesem Beispiel beinhaltet die Eins-zu-eins-Verbindung nur die Anzahl. Weitere Statistiken können wie unten angegeben berechnet werden.

  • Sie können mit dem Parameter Verbindungsbedingung einen Ausdruck zum Verbinden von Features erstellen. Wenn Sie einen Ausdruck angeben, werden nur die Features verwendet, die die Bedingung erfüllen. Zum Beispiel können Sie mit dem Ausdruck $target["Magnitude"] > $join["Explosion"] Ziel-Features im Feld Magnitude nur dann verbinden, wenn sie größer als das Verbindungs-Feature mit dem Feld Explosion sind. Weitere Informationen finden Sie unter Ausdrücke für "Features verbinden".

  • Beim Ausführen einer Eins-zu-Viele-Verbindung sind die folgenden Felder in den Ausgabe-Features enthalten:

    • Alle Felder aus den Ziel-Layern
    • Alle Felder aus dem verbundenen Layer

    Falls im Ziel- und im Verbindungs-Dataset ein Feld mit dem gleichen Namen vorhanden ist, beginnt der Name des verbundenen Feldes mit dem Wort "join" (z. B. join_fieldname).

    FeldnameBeschreibung

    start_datetime

    Dieses Feld stellt die Startzeit dar. Es wird erstellt, wenn die Zeit für die Eingabe als Zeitpunkt oder als Intervall festgelegt ist.

    end_datetime

    Dieses Feld stellt die Endzeit dar. Es wird erstellt, wenn die Zeit für die Eingabe als Intervall festgelegt ist.

    Beim Ausführen einer Eins-zu-Eins-Verbindung sind neben allen Feldern aus dem Ziel-Layer die folgenden Felder in den Ausgabe-Features enthalten:

    FeldnameBeschreibung

    count

    Die Anzahl der verbundenen Features.

    statistic_fieldname

    Für jede der angegebenen Statistiken wird ein Attributfeld mit einem Namen im folgenden Format erstellt: Statistik_Feldname. So haben beispielsweise die maximale Abweichung und die Standardabweichung des Feldes id die Namen MAX_id und SD_id.

    start_datetime

    Dieses Feld stellt die Startzeit dar. Es wird erstellt, wenn die Zeit für die Eingabe als Zeitpunkt oder als Intervall festgelegt ist.

    end_datetime

    Dieses Feld stellt die Endzeit dar. Es wird erstellt, wenn die Zeit für die Eingabe als Intervall festgelegt ist.

  • Wenn der Parameter Entfernung einbeziehen aktiviert ist und der Parameter Verbindungsvorgang auf Eins-zu-Viele-Verbindung festgelegt ist, können die folgenden Felder in den Ausgabe-Features enthalten sein:

    FeldnameBeschreibung

    distance

    Die Entfernung zwischen Ziel- und Verbindungs-Features. Dieses Feld ist enthalten, wenn der Parameter Räumliche Beziehung auf Nahe (planar) oder Nahe (geodätisch) festgelegt ist.

    Eine Entfernung von 0 bedeutet, dass sich die Ziel- und Verbindungsgeometrien überschneiden. Ein NULL-Wert bedeutet, dass die Geometrien weiter voneinander entfernt sind, als mit dem Wert des Parameters Räumliche Near-Entfernung angegeben. Wenn der Wert des Parameters Räumliche Beziehung auf Nahe (planar) festgelegt ist, sind die Entfernungswerte planar. Wenn der Wert des Parameters auf Nahe (geodätisch) festgelegt ist, sind die Entfernungswerte geodätisch. Die Werte werden in den mit dem Parameter Entfernungseinheit angegebenen Einheiten angegeben. Die Standardentfernungseinheit ist "Meter".

    timegap

    Die zeitliche Differenz zwischen den Ziel- und Verbindungs-Features in Millisekunden. Dieses Feld ist enthalten, wenn der Parameter Zeitliche Beziehung auf Nahe, Nahe vor oder Nahe nach festgelegt ist.

    Eine Differenz von 0 bedeutet, dass sich die Ziel- und Verbindungs-Features zeitlich überschneiden. Positive Werte bedeuten, dass das Ziel-Feature vor dem Verbindungs-Feature auftritt, und negative Werte bedeuten, dass das Verbindungs-Feature vor dem Ziel-Feature auftritt. NULL-Werte bedeuten, dass die Features die Verbindungsbedingung nicht erfüllen. Es kann beispielsweise sein, dass die Features weiter voneinander entfernt sind als mit dem Wert des Parameters Zeitliche Near-Entfernung angegeben.

  • Wenn Sie einen oder mehrere der folgenden Schritte durchführen, können Sie die Performance des Werkzeugs Features verbinden verbessern:

    • Legen Sie die Ausdehnungsumgebung so fest, dass nur die gewünschten Daten analysiert werden.
    • Legen Sie die Verbindungsbedingungen so selektiv wie möglich fest. Die Performance ist beispielsweise besser, wenn Sie bei denselben Daten für die Near-Verbindung einen statt fünf Kilometer angeben.
    • Fügen Sie mehrere Verbindungsbedingungen hinzu. Durch zusätzliche Verbindungsbedingungen wird die Verbindung selektiver. Die Performance ist beispielsweise besser, wenn Sie bei denselben Daten für die Near-Verbindung einen Kilometer und eine Stunde und nicht nur einen Kilometer angeben.
    • Wenden Sie einen Verbindungsausdruck an.
    • Verwenden Sie lokale Daten an der Stelle, an der die Analyse ausgeführt wird.

  • Ähnliche Analysen können auch mit dem Werkzeug Räumliche Verbindung in der Toolbox "Analysis" durchgeführt werden.

  • Dieses Geoverarbeitungswerkzeug wird unterstützt durch ArcGIS GeoAnalytics Server. Die Analyse wird auf dem GeoAnalytics Server ausgeführt, und die Ergebnisse werden in den eigenen Inhalten in ArcGIS Enterprise gespeichert.

  • Bei der Ausführung von GeoAnalytics Server-Werkzeugen wird die Analyse auf dem GeoAnalytics Server abgeschlossen. Für eine optimale Performance sollten die Daten dem GeoAnalytics Server über Feature-Layer zur Verfügung stehen, die auf Ihrem ArcGIS Enterprise-Portal gehostet werden. Alternativ können Big-Data-Dateifreigaben verwendet werden. Daten, auf die der GeoAnalytics Server nicht lokal zugreifen kann, werden vor Analysebeginn auf den GeoAnalytics Server verschoben. Dadurch dauert die Ausführung eines Werkzeugs länger. Es kann zudem vorkommen, dass das Verschieben der Daten von ArcGIS Pro zum GeoAnalytics Server fehlschlägt. Die Wahrscheinlichkeit eines Fehlers hängt dabei von der Netzwerkgeschwindigkeit sowie der Größe und Komplexität der Daten ab. Es wird empfohlen, dass Sie Ihre Daten stets freigeben oder eine Big-Data-Dateifreigabe erstellen.

    Weitere Informationen zum Freigeben von Daten in Ihrem Portal

    Weitere Informationen zum Erstellen einer Big-Data-Dateifreigabe über Server Manager

Parameter

BeschriftungErläuterungDatentyp
Ziel-Layer

Enthält die Ziel-Features. Die Attribute aus den Ziel-Features und die Attribute aus den verbundenen Features werden in die Ausgabe übertragen.

Record Set
Join-Layer

Enthält die 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 zu den Auswirkungen des Typs des Verbindungsvorgangs auf die Aggregation der verbundenen Attribute.

Record Set
Ausgabename

Der Name des Ausgabe-Feature-Service.

String
Verbindungsvorgang

Gibt an, wie Verbindungen zwischen den Werten für Ziel-Layer und den Werten für Join-Layer in der Ausgabe behandelt werden, wenn mehrere Verbindungs-Features über die gleiche räumliche Beziehung zu einem einzelnen Ziel-Feature verfügen.

  • Eins-zu-Eins-VerbindungDie Attribute aus den vielen Verbindungs-Features werden aggregiert. Wenn in zwei separaten Polygon-Verbindungs-Features beispielsweise ein einzelnes Punkt-Ziel-Feature vorhanden ist, werden die Attribute aus den beiden Polygonen aggregiert, bevor sie in die Ausgabe-Point-Feature-Class übertragen werden. Verfügt ein Polygon über einen Attributwert von 3 und das andere über einen Wert von 7, lautet der zusammengefasste Wert in der Ausgabe-Feature-Class 10, wenn das Ergebnis der Summenstatistik angegeben wird. Dies ist der Standard, bei dem nur die Anzahlstatistik zurückgegeben wird.
  • Eins-zu-Viele-VerbindungDie Ausgabe-Feature-Class enthält mehrere Kopien (Einträge) des Ziel-Features. Wenn zum Beispiel ein einzelnes Punkt-Ziel-Feature in zwei separaten Polygon-Verbindungs-Features vorhanden ist, 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. Bei Verwendung dieser Option ist keine Summenstatistik verfügbar.
String
Räumliche Beziehung
(optional)

Gibt die Kriterien für die räumliche Verbindung von Features an.

  • SchneidetDie Features in den Verbindungs-Features werden zugeordnet, wenn sie sich mit einem Ziel-Feature überschneiden. Dies ist die Standardeinstellung.
  • GleichDie Features in den Verbindungs-Features werden zugeordnet, wenn sie über die gleiche Geometrie wie das Ziel-Feature verfügen.
  • Nahe (planar)Die Features in den Verbindungs-Features werden zugeordnet, wenn sie sich innerhalb einer bestimmten Entfernung zum Ziel-Feature befinden. Die Entfernung wird als planare Entfernung gemessen. Geben Sie im Parameter Räumliche Near-Entfernung eine Entfernung an.
  • Nahe (geodätisch)Die Features in den Verbindungs-Features werden zugeordnet, wenn sie sich innerhalb einer bestimmten Entfernung zum Ziel-Feature befinden. Die Entfernung wird als geodätische Entfernung gemessen. Geben Sie im Parameter Räumliche Near-Entfernung eine Entfernung an. Diese Option ist in ArcGIS Enterprise 10.7 oder höher verfügbar.
  • 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. Die Verbindungs-Features können nur dann Polygone sein, wenn die Ziel-Features auch Polygone sind. Ein Polygon kann jeden beliebigen Feature-Typ enthalten. Eine Polylinie kann nur Polylinien und Punkte enthalten. Ein Punkt kann kein Feature enthalten, nicht einmal einen Punkt. Wenn sich das Verbindungs-Feature vollständig auf der Grenze des Ziel-Features befindet (kein Teil liegt inner- oder außerhalb), wird das Feature nicht zugeordnet.
  • InnerhalbDie Features in den Verbindungs-Features werden zugeordnet, wenn sich ein Ziel-Feature innerhalb von ihnen befindet. Dies ist das Gegenteil der Beziehung "Enthält". Die Ziel-Features können nur dann Polygone sein, wenn die Verbindungs-Features auch Polygone sind. Ein Punkt kann nur dann ein Join-Feature sein, wenn er auch ein Ziel-Feature ist. Wenn das gesamte Feature in den Verbindungs-Features sich auf der Grenze des Ziel-Features befindet, wird das Feature nicht zugeordnet.
  • BerührtDie 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 kreuzen.
  • KreuztDie 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 kreuzen, werden zugeordnet. Dies gilt nicht für Linien, die ein Liniensegment gemeinsam haben.
  • ÜberlapptDie Features in den Verbindungs-Features werden zugeordnet, wenn sie sich mit einem Ziel-Feature überschneiden.
String
Räumliche Near-Entfernung
(optional)

Die Entfernung von einem Ziel-Feature, innerhalb derer Verbindungs-Features für die räumliche Verbindung berücksichtigt werden. Ein Suchradius ist nur gültig, wenn der Wert des Parameters Räumliche Beziehung auf Nahe (planar) oder Nahe (geodätisch) festgelegt ist.

Linear Unit
Zeitliche Beziehung
(optional)

Gibt die zeitlichen Kriterien für die Zuordnung von Features an.

  • EntsprichtWenn ein Zielzeit-Intervallende gleich dem Verbindungszeit-Intervallstart ist, entspricht die Zielzeit der Verbindungszeit.
  • Erfüllt vonWenn ein Zielzeit-Intervallstart gleich dem Verbindungszeit-Intervallende ist, wird die Zielzeit von der Verbindungszeit erfüllt.
  • ÜberlapptWenn ein Zielzeitintervall vor dem Start und Ende eines Verbindungszeitintervalls beginnt und endet, überlappt die Zielzeit die Verbindungszeit.
  • Überlappt vonWenn ein Zielzeitintervall nach der Start- und Endzeit eines Verbindungszeitintervalls beginnt und endet, wird die Zielzeit von der Verbindungszeit überlappt.
  • ZwischenWenn eine Zielzeit zwischen dem Start und dem Ende eines Verbindungszeitintervalls auftritt, liegt die Zielzeit während der Verbindungszeit.
  • EnthältWenn eine Verbindungs-Feature-Zeit zwischen dem Start und dem Ende eines Zielzeitintervalls auftritt, enthält die Zielzeit die Verbindungszeit.
  • GleichZwei Zeiten sind gleich, wenn ihre Zeitpunkte oder Intervalle identisch sind.
  • BeendetWenn eine Zielzeit zeitgleich mit einer Verbindungszeit endet und die Zielzeit nach der Verbindungszeit begonnen hat, beendet die Zielzeit die Verbindungszeit.
  • Beendet vonWenn eine Verbindungszeit zeitgleich mit einer Zielzeit endet und die Verbindungszeit nach der Zielzeit begonnen hat, wird die Zielzeit von der Verbindungszeit beendet.
  • StartetWenn eine Zielzeit zeitgleich mit einem Verbindungszeitintervall beginnt und vor dem Intervallende der Verbindungszeit endet, dann startet die Zielzeit die Verbindungszeit.
  • Gestartet vonWenn eine Zielintervallzeit zeitgleich mit einer Verbindungszeit beginnt und nach der Verbindungszeit endet, dann wird die Zielzeit von der Verbindungszeit gestartet.
  • SchneidetWenn ein Teil der Zielzeit zeitgleich mit der Verbindungszeit auftritt, dann schneidet die Zielzeit die Verbindungszeit.
  • NaheWenn eine Zielzeit innerhalb eines angegebenen Bereichs der Verbindungszeit auftritt, dann ist die Zielzeit nahe der Verbindungszeit.
  • Nahe vorWenn eine Zielzeit vor der Verbindungszeit liegt, aber innerhalb eines angegebenen Bereichs ausgehend von der Verbindungszeit auftritt, dann ist die Zielzeit nahe vor der Verbindungszeit. Diese Option ist in ArcGIS Enterprise 10.6 oder höher verfügbar.
  • Nahe nachWenn eine Zielzeit nach der Verbindungszeit liegt, aber innerhalb eines angegebenen Bereichs ausgehend von der Verbindungszeit auftritt, dann ist die Zielzeit nahe nach der Verbindungszeit. Diese Option ist in ArcGIS Enterprise 10.6 oder höher verfügbar.
String
Zeitliche Near-Entfernung
(optional)

Die zeitliche Entfernung von einem Ziel-Feature, innerhalb derer Verbindungs-Features für die räumliche Verbindung berücksichtigt werden. Eine Zeit ist nur gültig, wenn der Wert des Parameters Zeitliche Beziehung auf Nahe, Nahe vor oder Nahe nach festgelegt ist und für beide Features Zeiteigenschaften aktiviert sind.

Time Unit
Attributbeziehung
(optional)

Verbindet Features basierend auf Werten innerhalb eines Attributfeldes. Geben Sie das Attributfeld aus dem Ziel-Layer an, das einem Attributfeld aus dem Join-Layer entspricht.

  • Zielfeld: ein Attributfeld aus dem Ziel-Layer mit zuzuordnenden Werten.
  • Join-Feld: ein Attributfeld aus dem Join-Layer mit zuzuordnenden Werten.

Value Table
Zusammenfassungsfelder
(optional)

Die Statistiken, die für bestimmte Felder berechnet werden.

Value Table
Verbindungsbedingung
(optional)

Wendet eine Bedingung auf angegebene Felder an. Nur Features mit Feldern, die diese Bedingungen erfüllen, werden verbunden.

Ein Beispiel: Sie können eine Verbindungsbedingung auf Features anwenden, bei denen das Attribut "HealthSpending" (Gesundheitskosten) im Join-Layer mehr als 20 Prozent des Attributs "Income" (Einkommen) im Ziel-Layer ausmacht. In ArcGIS Enterprise 10.5 und 10.5.1 lautet die Verbindungsbedingung für die Anwendung dieses Ausdrucks join["HealthSpending"] > target["Income"] * .2. Verwenden Sie in ArcGIS Enterprise 10.6 oder höher einen Arcade-Ausdruck wie zum Beispiel $join["HealthSpending"] > $target["Income"] * .2.

Wenn der Layer der Karte hinzugefügt wird, können die Filter Felder und Helper zum Erstellen eines Ausdrucks verwendet werden.

Weitere Informationen zu Ausdrücken für "Features verbinden" in Version 10.6

String
Data Store
(optional)

Gibt den ArcGIS Data Store für das Speichern der Ausgabe an. Die Standardvorgabe ist der Big Data Store vom Typ "spatiotemporal". Alle in einem Big Data Store vom Typ "spatiotemporal" gespeicherten Ergebnisse werden im WGS84 gespeichert. Ergebnisse, die in einem Data Store vom Typ "relational" gespeichert werden, behalten ihr Koordinatensystem bei.

  • Big Data Store vom Typ "spatiotemporal"Die Ausgabe wird in einem Big Data Store vom Typ "spatiotemporal" gespeichert. Dies ist die Standardeinstellung.
  • Data Store vom Typ "relational"Die Ausgabe wird in einem Data Store vom Typ "relational" gespeichert.
String
Alle Ziel-Features beibehalten
(optional)

Gibt an, ob in der Ausgabe-Feature-Class alle Ziel-Features beibehalten werden (Left Outer Join) oder nur jene, die über die angegebenen Beziehungen zu den Verbindungs-Features verfügen (Inner Join).

  • Aktiviert: Alle Ziel-Features werden in der Ausgabe beibehalten.
  • Deaktiviert: Nur die Ziel-Features, die über die angegebenen Beziehungen verfügen, werden in der Ausgabe-Feature-Class beibehalten. Alle Punkt-Features, die sich nicht innerhalb der Polygon-Features befinden, werden von der Ausgabe ausgeschlossen. Dies ist die Standardeinstellung.

Boolean
Entfernung einbeziehen
(optional)

Gibt an, ob die räumliche Beziehung oder die zeitliche Differenz in das Ergebnis einbezogen wird.

Dieser Parameter ist aktiv, wenn der Wert des Parameters Verbindungsvorgang auf Eins-zu-Viele-Verbindung festgelegt ist und eine der folgenden Bedingungen erfüllt ist:

  • Der Wert des Parameters Räumliche Beziehung ist auf Nahe (planar) oder Nahe (geodätisch) festgelegt.
  • Der Wert des Parameters Zeitliche Beziehung ist auf Nahe, Nahe vor oder Nahe nach festgelegt.
.
  • Aktiviert: Die räumliche Beziehung oder die zeitliche Differenz wird in das Ergebnis einbezogen.
  • Deaktiviert: Weder die räumliche Beziehung noch die zeitliche Differenz wird in das Ergebnis einbezogen. Dies ist die Standardeinstellung.

Boolean
Entfernungseinheit
(optional)

Gibt die Maßeinheit an, die für Entfernungswerte in der Ausgabe-Feature-Class verwendet wird.

  • MeterAls Maßeinheit werden Meter verwendet. Dies ist die Standardeinstellung.
  • KilometerAls Maßeinheit werden Kilometer verwendet.
  • Meilen (US Survey)Als Maßeinheit werden Meilen (US Survey) verwendet.
  • Seemeilen (US Survey)Als Maßeinheit werden Seemeilen (US Survey) verwendet.
  • Yards (US Survey)Als Maßeinheit werden Yards (US Survey) verwendet.
  • Fuß (US Survey)Als Maßeinheit werden Fuß (US Survey) verwendet.
  • Meilen (Britisch)Als Maßeinheit werden Meilen (Britisch) verwendet.
  • Seemeilen (International)Als Maßeinheit werden Seemeilen (International) verwendet.
  • Yards (International)Als Maßeinheit werden Yards (International) verwendet.
  • Fuß (International)Ales Maßeinheit werden Fuß (International) verwendet.
String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Output_Feature_Class

Die verbundene Ausgabe.

Record Set

arcpy.geoanalytics.JoinFeatures(target_layer, join_layer, output_name, join_operation, {spatial_relationship}, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship}, {summary_fields}, {join_condition}, {data_store}, {keep_all_target_features}, {include_distance}, {distance_unit})
NameErläuterungDatentyp
target_layer

Enthält die Ziel-Features. Die Attribute aus den Ziel-Features und die Attribute aus den verbundenen Features werden in die Ausgabe übertragen.

Record Set
join_layer

Enthält die 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 zu den Auswirkungen des Typs des Verbindungsvorgangs auf die Aggregation der verbundenen Attribute.

Record Set
output_name

Der Name des Ausgabe-Feature-Service.

String
join_operation

Gibt an, wie Verbindungen zwischen den Werten für target_layer und den Werten für join_layer im Ausgabe-Feature behandelt werden, wenn mehrere Verbindungs-Features über die gleiche räumliche Beziehung zu einem einzelnen Ziel-Feature verfügen.

  • JOIN_ONE_TO_ONEDie Attribute aus den vielen Verbindungs-Features werden aggregiert. Wenn in zwei separaten Polygon-Verbindungs-Features beispielsweise ein einzelnes Punkt-Ziel-Feature vorhanden ist, werden die Attribute aus den beiden Polygonen aggregiert, bevor sie in die Ausgabe-Point-Feature-Class übertragen werden. Verfügt ein Polygon über einen Attributwert von 3 und das andere über einen Wert von 7, lautet der zusammengefasste Wert in der Ausgabe-Feature-Class 10, wenn das Ergebnis der Summenstatistik angegeben wird. Dies ist der Standard, bei dem nur die Anzahlstatistik zurückgegeben wird.
  • JOIN_ONE_TO_MANYDie Ausgabe-Feature-Class enthält mehrere Kopien (Einträge) des Ziel-Features. Wenn zum Beispiel ein einzelnes Punkt-Ziel-Feature in zwei separaten Polygon-Verbindungs-Features vorhanden ist, 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. Bei Verwendung dieser Option ist keine Summenstatistik verfügbar.
String
spatial_relationship
(optional)

Gibt die Kriterien für die räumliche Verbindung von Features an.

  • INTERSECTSDie Features in den Verbindungs-Features werden zugeordnet, wenn sie sich mit einem Ziel-Feature überschneiden. Dies ist die Standardeinstellung.
  • EQUALSDie Features in den Verbindungs-Features werden zugeordnet, wenn sie über die gleiche Geometrie wie das Ziel-Feature verfügen.
  • NEARDie Features in den Verbindungs-Features werden zugeordnet, wenn sie sich innerhalb einer bestimmten Entfernung zum Ziel-Feature befinden. Die Entfernung wird als planare Entfernung gemessen. Geben Sie im Parameter spatial_near_distance eine Entfernung an.
  • NEAR_GEODESICDie Features in den Verbindungs-Features werden zugeordnet, wenn sie sich innerhalb einer bestimmten Entfernung zum Ziel-Feature befinden. Die Entfernung wird als geodätische Entfernung gemessen. Geben Sie im Parameter spatial_near_distance eine Entfernung an. Diese Option ist in ArcGIS Enterprise 10.7 oder höher verfügbar.
  • 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. Die Verbindungs-Features können nur dann Polygone sein, wenn die Ziel-Features auch Polygone sind. Ein Polygon kann jeden beliebigen Feature-Typ enthalten. Eine Polylinie kann nur Polylinien und Punkte enthalten. Ein Punkt kann kein Feature enthalten, nicht einmal einen Punkt. Wenn sich das Verbindungs-Feature vollständig auf der Grenze des Ziel-Features befindet (kein Teil liegt inner- oder außerhalb), wird das Feature nicht zugeordnet.
  • WITHINDie Features in den Verbindungs-Features werden zugeordnet, wenn sich ein Ziel-Feature innerhalb von ihnen befindet. Dies ist das Gegenteil der Beziehung "Enthält". Die Ziel-Features können nur dann Polygone sein, wenn die Verbindungs-Features auch Polygone sind. Ein Punkt kann nur dann ein Join-Feature sein, wenn er auch ein Ziel-Feature ist. Wenn das gesamte Feature in den Verbindungs-Features sich auf der Grenze des Ziel-Features befindet, wird das Feature nicht zugeordnet.
  • 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 kreuzen.
  • CROSSESDie 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 kreuzen, werden zugeordnet. Dies gilt nicht für Linien, die ein Liniensegment gemeinsam haben.
  • OVERLAPSDie Features in den Verbindungs-Features werden zugeordnet, wenn sie sich mit einem Ziel-Feature überschneiden.
String
spatial_near_distance
(optional)

Die Entfernung von einem Ziel-Feature, innerhalb derer Verbindungs-Features für die räumliche Verbindung berücksichtigt werden. Ein Suchradius ist nur gültig, wenn der Wert des Parameters spatial_relationship auf NEAR oder NEAR_GEODESIC festgelegt ist.

Linear Unit
temporal_relationship
(optional)

Gibt die zeitlichen Kriterien für die Zuordnung von Features an.

  • MEETSWenn ein Zielzeit-Intervallende gleich dem Verbindungszeit-Intervallstart ist, entspricht die Zielzeit der Verbindungszeit.
  • MET_BYWenn ein Zielzeit-Intervallstart gleich dem Verbindungszeit-Intervallende ist, wird die Zielzeit von der Verbindungszeit erfüllt.
  • OVERLAPSWenn ein Zielzeitintervall vor dem Start und Ende eines Verbindungszeitintervalls beginnt und endet, überlappt die Zielzeit die Verbindungszeit.
  • OVERLAPPED_BYWenn ein Zielzeitintervall nach der Start- und Endzeit eines Verbindungszeitintervalls beginnt und endet, wird die Zielzeit von der Verbindungszeit überlappt.
  • DURINGWenn eine Zielzeit zwischen dem Start und dem Ende eines Verbindungszeitintervalls auftritt, liegt die Zielzeit während der Verbindungszeit.
  • CONTAINSWenn eine Verbindungs-Feature-Zeit zwischen dem Start und dem Ende eines Zielzeitintervalls auftritt, enthält die Zielzeit die Verbindungszeit.
  • EQUALSZwei Zeiten sind gleich, wenn ihre Zeitpunkte oder Intervalle identisch sind.
  • FINISHESWenn eine Zielzeit zeitgleich mit einer Verbindungszeit endet und die Zielzeit nach der Verbindungszeit begonnen hat, beendet die Zielzeit die Verbindungszeit.
  • FINISHED_BYWenn eine Verbindungszeit zeitgleich mit einer Zielzeit endet und die Verbindungszeit nach der Zielzeit begonnen hat, wird die Zielzeit von der Verbindungszeit beendet.
  • STARTSWenn eine Zielzeit zeitgleich mit einem Verbindungszeitintervall beginnt und vor dem Intervallende der Verbindungszeit endet, dann startet die Zielzeit die Verbindungszeit.
  • STARTED_BYWenn eine Zielintervallzeit zeitgleich mit einer Verbindungszeit beginnt und nach der Verbindungszeit endet, dann wird die Zielzeit von der Verbindungszeit gestartet.
  • INTERSECTSWenn ein Teil der Zielzeit zeitgleich mit der Verbindungszeit auftritt, dann schneidet die Zielzeit die Verbindungszeit.
  • NEARWenn eine Zielzeit innerhalb eines angegebenen Bereichs der Verbindungszeit auftritt, dann ist die Zielzeit nahe der Verbindungszeit.
  • NEAR_BEFOREWenn eine Zielzeit vor der Verbindungszeit liegt, aber innerhalb eines angegebenen Bereichs ausgehend von der Verbindungszeit auftritt, dann ist die Zielzeit nahe vor der Verbindungszeit. Diese Option ist in ArcGIS Enterprise 10.6 oder höher verfügbar.
  • NEAR_AFTERWenn eine Zielzeit nach der Verbindungszeit liegt, aber innerhalb eines angegebenen Bereichs ausgehend von der Verbindungszeit auftritt, dann ist die Zielzeit nahe nach der Verbindungszeit. Diese Option ist in ArcGIS Enterprise 10.6 oder höher verfügbar.
String
temporal_near_distance
(optional)

Die zeitliche Entfernung von einem Ziel-Feature, innerhalb derer Verbindungs-Features für die räumliche Verbindung berücksichtigt werden. Eine Zeit ist nur gültig, wenn der Wert des Parameters temporal_relationship auf NEAR, NEAR_BEFORE oder NEAR_AFTER festgelegt ist und für beide Features Zeiteigenschaften aktiviert sind.

Time Unit
attribute_relationship
[attribute_relationship,...]
(optional)

Verbindet Features basierend auf Werten innerhalb eines Attributfeldes. Geben Sie das Attributfeld aus dem Ziel-Layer an, das einem Attributfeld aus dem Join-Layer entspricht.

  • Zielfeld: ein Attributfeld aus dem Ziel-Layer mit zuzuordnenden Werten.
  • Join-Feld: ein Attributfeld aus dem Join-Layer mit zuzuordnenden Werten.

Value Table
summary_fields
[summary_fields,...]
(optional)

Die Statistiken, die für bestimmte Felder berechnet werden.

  • COUNT: Die Anzahl der Nicht-NULL-Werte. Es kann für numerische Felder oder Zeichenfolgen verwendet werden. Die Anzahl von [null, 0, 2] ist 2.
  • SUM: Die Summe der numerischen Werte in einem Feld. Die Summe von [null, null, 3] ist 3.
  • MEAN: Der Mittelwert der numerischen Werte. Der Mittelwert von [0,2, null] ist 1.
  • MIN: Der Minimalwert eines numerischen Feldes. Das Minimum von [0, 2, null] ist 0.
  • MAX: Der Maximalwert eines numerischen Feldes. Der Maximalwert von [0, 2, null] ist 2.
  • STDDEV: Die Standardabweichung eines numerischen Feldes. Die Standardabweichung von [1] ist null. Die Standardabweichung von [null, 1,1,1] ist null.
  • VAR: Die Varianz eines numerischen Feldes in einem Track. Die Varianz von [1] ist null. Die Varianz von [null, 1,1,1] ist null.
  • RANGE: Der Bereich eines numerischen Feldes. Dieser wird durch die Subtraktion der Minimalwerte vom Maximalwert berechnet. Der Bereich von [0, null, 1] ist 1. Der Bereich von [null, 4] ist 0.
  • ANY: Dies ist eine Beispielzeichenfolge aus einem Feld vom Typ "Zeichenfolge".

Value Table
join_condition
(optional)

Wendet eine Bedingung auf angegebene Felder an. Nur Features mit Feldern, die diese Bedingungen erfüllen, werden verbunden.

Ein Beispiel: Sie können eine Verbindungsbedingung auf Features anwenden, bei denen das Attribut "HealthSpending" (Gesundheitskosten) im Join-Layer mehr als 20 Prozent des Attributs "Income" (Einkommen) im Ziel-Layer ausmacht. In ArcGIS Enterprise 10.5 und 10.5.1 lautet die Verbindungsbedingung für die Anwendung dieses Ausdrucks join["HealthSpending"] > target["Income"] * .2. Verwenden Sie in ArcGIS Enterprise 10.6 oder höher einen Arcade-Ausdruck wie zum Beispiel $join["HealthSpending"] > $target["Income"] * .2.

String
data_store
(optional)

Gibt den ArcGIS Data Store für das Speichern der Ausgabe an. Die Standardeinstellung ist SPATIOTEMPORAL_DATA_STORE. Alle in einem Big Data Store vom Typ "spatiotemporal" gespeicherten Ergebnisse werden im WGS84 gespeichert. Ergebnisse, die in einem Data Store vom Typ "relational" gespeichert werden, behalten ihr Koordinatensystem bei.

  • SPATIOTEMPORAL_DATA_STOREDie Ausgabe wird in einem Big Data Store vom Typ "spatiotemporal" gespeichert. Dies ist die Standardeinstellung.
  • RELATIONAL_DATA_STOREDie Ausgabe wird in einem Data Store vom Typ "relational" gespeichert.
String
keep_all_target_features
(optional)

Gibt an, ob in der Ausgabe-Feature-Class alle Ziel-Features beibehalten werden (Left Outer Join) oder nur jene, die über die angegebenen Beziehungen zu den Verbindungs-Features verfügen (Inner Join).

  • KEEP_ALLAlle Ziel-Features werden in der Ausgabe beibehalten.
  • KEEP_COMMONNur die Ziel-Features, die über die angegebenen Beziehungen verfügen, werden in der Ausgabe-Feature-Class beibehalten. Dies ist die Standardeinstellung.
Boolean
include_distance
(optional)

Gibt an, ob die räumliche Beziehung oder die zeitliche Differenz in das Ergebnis einbezogen wird.

Dieser Parameter ist aktiv, wenn der Wert des Parameters join_operation auf JOIN_ONE_TO_MANY festgelegt ist und eine der folgenden Bedingungen erfüllt ist:

  • Der Wert des Parameters spatial_relationship entspricht NEAR oder NEAR_GEODESIC.
  • Der Wert des Parameters temporal_relationship entspricht NEAR, NEAR_BEFORE oder NEAR_AFTER.

  • INCLUDE_DISTANCEDie räumliche Beziehung oder die zeitliche Differenz wird in das Ergebnis einbezogen.
  • NO_INCLUDE_DISTANCEWeder die räumliche Beziehung noch die zeitliche Differenz wird in das Ergebnis einbezogen. Dies ist die Standardeinstellung.
Boolean
distance_unit
(optional)

Gibt die Maßeinheit an, die für Entfernungswerte in der Ausgabe-Feature-Class verwendet wird.

  • METERSAls Maßeinheit werden Meter verwendet. Dies ist die Standardeinstellung.
  • KILOMETERSAls Maßeinheit werden Kilometer verwendet.
  • MILESAls Maßeinheit werden Meilen (US Survey) verwendet.
  • NAUTICAL_MILESAls Maßeinheit werden Seemeilen (US Survey) verwendet.
  • YARDSAls Maßeinheit werden Yards (US Survey) verwendet.
  • FEETAls Maßeinheit werden Fuß (US Survey) verwendet.
  • MILES_INTAls Maßeinheit werden Meilen (Britisch) verwendet.
  • NAUTICAL_MILES_INTAls Maßeinheit werden Seemeilen (International) verwendet.
  • YARDS_INTAls Maßeinheit werden Yards (International) verwendet.
  • FEET_INTAles Maßeinheit werden Fuß (International) verwendet.
String

Abgeleitete Ausgabe

NameErläuterungDatentyp
output

Die verbundene Ausgabe.

Record Set

Codebeispiel

JoinFeatures: Beispiel (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion JoinFeatures verwendet wird.

# Name: JoinFeatures.py
# Description: Join crime events that are close together in time and space, and 
#              return the count of nearby crimes. This example is a self join 
#              (joining the same layer to itself).
# Requirements: ArcGIS GeoAnalytics Server 

# Import system modules 
import arcpy 

# Set local variables 
inFeatures = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Crimes/BigDataCatalogServer/Chicago"
spatialOperation = "NEAR" 
nearDistance = "1 Kilometers" 
temporalOperation = "NEAR" 
nearTime = "3 Hours" 
outFS = "CloseCrimes" 
dataStore = "SPATIOTEMPORAL_DATA_STORE" 

# Run Join Features
arcpy.geoanalytics.JoinFeatures(inFeatures, inFeatures, outFS, "JOIN_ONE_TO_ONE", 
                                spatialOperation, nearDistance, temporalOperation, 
                                nearTime, None, None, None, dataStore)

Umgebungen

Sonderfälle

Ausgabe-Koordinatensystem

Das Koordinatensystem, das für die Analyse verwendet wird. Die Analyse wird im Eingabe-Koordinatensystem ausgeführt, sofern nicht anders durch diesen Parameter angegeben. Für GeoAnalytics Tools werden die Endergebnisse im Data Store vom Typ "spatiotemporal" in WGS84 gespeichert.

Lizenzinformationen

  • Basic: Erfordert ArcGIS GeoAnalytics Server
  • Standard: Erfordert ArcGIS GeoAnalytics Server
  • Advanced: Erfordert ArcGIS GeoAnalytics Server

Verwandte Themen