| Name | Erläuterung | Datentyp |
in_trace_network | Das Verfolgungsnetz, das die neue benannte Verfolgungskonfiguration enthält. | Trace Network; Trace Network Layer |
trace_config_name | Der Name für die benannte Verfolgungskonfiguration. | String |
trace_type | Gibt den Typ der zu konfigurierenden Verfolgung an. - CONNECTED—Eine Verbindungsverfolgung beginnt an mindestens einem Startpunkt und erstreckt sich entlang der verbundenen Features nach außen.
- UPSTREAM—Es wird eine flussaufwärts durchgeführte Verfolgung verwendet, die Features ermittelt, die sich flussaufwärts von einer Position im Netzwerk befinden. Für diesen Verfolgungstyp wird die Fließrichtung verwendet.
- DOWNSTREAM—Es wird eine flussabwärts durchgeführte Verfolgung verwendet, die Features ermittelt, die sich flussabwärts von einer Position im Netzwerk befinden. Für diesen Verfolgungstyp wird die Fließrichtung verwendet.
- SHORTEST_PATH—Eine Verfolgung der kürzesten Verbindung, die unabhängig von der Fließrichtung die kürzeste Verbindung zwischen zwei Startpunkten im Netzwerk findet, wird verwendet. Die Kosten, die beim Passieren des Pfades entstehen, werden anhand des Netzwerkattributs ermittelt, das für den Parameter shortest_path_network_attribute_name festgelegt wurde.
| String |
description (optional) | Die Beschreibung der benannten Verfolgungskonfiguration. | String |
tags [tags,...] (optional) | Verschiedene Tags, die zur Kennzeichnung der benannten Verfolgungskonfiguration verwendet werden. Die Tags können bei Suchvorgängen und zum Indizieren verwendet werden. | String |
path_direction (optional) | Gibt die Richtung des Verfolgungspfades an. Die Kosten, die beim Passieren des Pfades entstehen, werden mit dem Parameterwert shortest_path_network_attribute_name ermittelt. Dieser Parameter wird nur bei der Ausführung einer Verfolgung vom Typ SHORTEST_PATH berücksichtigt. - NO_DIRECTION—Der Pfad zwischen den beiden Startpunkten wird unabhängig von der Fließrichtung verwendet. Dies ist die Standardeinstellung.
- PATH_UPSTREAM—Der Pfad flussaufwärts zwischen den beiden Startpunkten wird verwendet.
- PATH_DOWNSTREAM—Der Pfad flussabwärts zwischen den beiden Startpunkten wird verwendet.
| String |
shortest_path_network_attribute_name (optional) | Der Name des Netzwerkattributs, das zum Berechnen des Pfades verwendet wird. Bei der Ausführung einer Verfolgung vom Typ "Kürzester Pfad" wird der kürzeste Pfad mithilfe eines numerischen Netzwerkattributs wie etwa Shape-Länge berechnet. Es können sowohl kosten- als auch entfernungsbasierte Pfade ermittelt werden. Dieser Parameter ist für die Ausführung einer Verfolgung vom Typ "Kürzester Pfad" erforderlich. | String |
include_barriers (optional) | Gibt an, ob Barrieren-Features für die Durchlassfähigkeit in die Verfolgungsergebnisse einbezogen werden. - INCLUDE_BARRIERS—Barrieren-Features für die Durchlassfähigkeit werden in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.
- EXCLUDE_BARRIERS—Barrieren-Features für die Durchlassfähigkeit werden nicht in die Verfolgungsergebnisse einbezogen.
| Boolean |
validate_consistency (optional) | Gibt an, ob ein Fehler ausgegeben wird, wenn in einem der zurückgegebenen Features Dirty Areas gefunden werden. Dies ist die einzige Möglichkeit sicherzustellen, dass eine Verfolgung Features mit einem konsistenten Status im Netzwerk weitergibt. Um Dirty Areas zu entfernen, überprüfen Sie die Netzwerk-Topologie. - VALIDATE_CONSISTENCY—Bei der Verfolgung wird ein Fehler ausgegeben, wenn in einem der zurückgegebenen Features Dirty Areas gefunden werden.
- DO_NOT_VALIDATE_CONSISTENCY—Die Verfolgungsergebnisse werden ausgegeben, auch wenn in einem der zurückgegebenen Features Dirty Areas gefunden werden. Dies ist die Standardeinstellung.
| Boolean |
ignore_barriers_at_starting_points (optional) | Gibt an, ob Barrieren in der Verfolgungskonfiguration für Startpunkte ignoriert werden. - IGNORE_BARRIERS_AT_STARTING_POINTS—Barrieren bei Startpunkten werden in der Verfolgung ignoriert.
- DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS—Barrieren bei Startpunkten werden in der Verfolgung nicht ignoriert. Dies ist die Standardeinstellung.
| Boolean |
allow_indeterminate_flow (optional) | Gibt an, ob Features mit einer unbestimmbaren oder nicht initialisierten Fließrichtung verfolgt werden. Dieser Parameter wird nur bei der Ausführung einer Verfolgung flussaufwärts oder flussabwärts berücksichtigt. - TRACE_INDETERMINATE_FLOW—Features mit unbestimmbaren oder nicht initialisierten Fließrichtungen werden verfolgt.
- IGNORE_INDETERMINATE_FLOW—Features mit unbestimmbaren oder nicht initialisierten Fließrichtungen werden nicht verfolgt. Dies ist die Standardeinstellung.
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (optional) | Legt für Features basierend auf einem Vergleich mit einem Netzwerkattribut eine Bedingungsbarriere für Durchlässigkeit fest. Eine Bedingungsbarriere verwendet ein Netzwerkattribut, einen Operator und einen Typ sowie einen Attributwert. Halten Sie eine Verfolgung beispielsweise an, wenn das Attribut Code dem spezifischen Wert ArtificialPath entspricht. Wenn ein Feature diese Bedingung erfüllt, wird die Verfolgung angehalten. Bei Verwendung mehrerer Attribute können Sie mit der Komponente Combine Using eine And- oder eine Or-Bedingung definieren. Die Komponenten der Bedingungsbarrieren sind folgende: - Name: Filtern Sie nach einem beliebigen im System definierten Netzwerkattribut.
- Operator: Hier können Sie unter mehreren Operatoren wählen.
- Type: Wählen Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der in der Komponente Name angegeben ist, aus.
- Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
- Combine Using: Legen Sie diesen Wert fest, wenn Sie mehrere Attribute hinzufügen möchten. Sie können sie mit einer And- oder einer Or-Bedingung verbinden.
Die Komponenten für Operator lauten wie folgt: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
Die Komponenten für Type lauten wie folgt: - SPECIFIC_VALUE—Nach einem bestimmten Wert filtern.
- NETWORK_ATTRIBUTE—Nach einem Netzwerkattribut filtern.
Die Komponenten für Combine Using lauten wie folgt: - AND—Die Bedingungsbarrieren kombinieren.
- OR—Verwenden, wenn eine der Bedingungsbarrieren erfüllt ist.
| Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (optional) | Legt für Features eine Durchlässigkeitsbarriere basierend auf einer Funktion fest. Funktionsbarrieren können beispielsweise verwendet werden, um die Entfernung der Verfolgung vom Startpunkt einzuschränken oder einen Maximalwert zum Anhalten einer Verfolgung festzulegen. Die Länge der jeweils zurückgelegten Linie wird beispielsweise der bisher zurückgelegten Gesamtentfernung hinzugefügt. Wenn die zurückgelegte Gesamtlänge den angegebenen Wert erreicht hat, wird die Verfolgung angehalten. Die Komponenten der Funktionsbarrieren sind folgende: - Function: Hier können Sie unter mehreren Berechnungsfunktionen wählen.
- Attribute: Hier können Sie nach einem beliebigen Netzwerkattribut, das im System definiert ist, filtern.
- Operator: Hier können Sie unter mehreren Operatoren wählen.
- Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der zur Beendigung führt, wenn er ermittelt wird.
- Use Local Values: Berechnet Werte in jeder Richtung im Gegensatz zu einem globalen Gesamtwert. Beispiel: Eine Funktionsbarriere berechnet die Summe der Shape-Länge, wobei die Verfolgung beendet wird, wenn der Wert größer als oder gleich 4 ist. Wenn Sie im globalen Fall zwei Kanten mit dem Wert 2 durchlaufen haben, wird die Verfolgung beendet, da Sie bereits die Shape-Länge 4 erreicht haben. Wenn lokale Werte verwendet werden, dann läuft die Verfolgung weiter, da sich die lokalen Werte auf jedem Pfad ändern.
Die Komponenten für Function lauten wie folgt: - AVERAGE—Der Durchschnitt der Eingabewerte.
- COUNT—Die Anzahl der Features.
- MAX—Das Maximum der Eingabewerte.
- MIN—Das Minimum der Eingabewerte.
- ADD—Die Summe der Werte.
- SUBTRACT—Die Differenz der Werte.
Die Komponenten für Operator lauten wie folgt: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
Die Komponenten für Use Local Values lauten wie folgt: - TRUE—Lokale Werte werden verwendet.
- FALSE—Globale Werte werden verwendet. Dies ist die Standardeinstellung.
| Value Table |
traversability_scope (optional) | Gibt an, ob Durchlassfähigkeit auf Knoten, Kanten oder beides angewendet wird. Wenn beispielsweise in einem Wanderwegenetz als Bedingungsbarriere definiert ist, dass die Verfolgung beendet wird, wenn der Pfadtyp "Kies" und der Umfang der Durchlassfähigkeit nur für Knoten festgelegt ist, endet die Verfolgung bei einem Kiespfad nicht, da der Pfadtyp nur für Kanten gilt. Anders gesagt wird mit diesem Parameter für die Verfolgung angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen. - BOTH_JUNCTIONS_AND_EDGES—Die Durchlassfähigkeit wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung.
- JUNCTIONS_ONLY—Die Durchlassfähigkeit wird nur auf Knoten angewendet.
- EDGES_ONLY—Die Durchlassfähigkeit wird nur auf Kanten angewendet.
| String |
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (optional) | Die Berechnungsfunktion, die auf die Verfolgungsergebnisse angewendet wird.
Folgende Funktionskomponenten stehen zur Verfügung: - Function: Hier können Sie unter mehreren Berechnungsfunktionen wählen.
- Attribute: Hier können Sie nach einem beliebigen Netzwerkattribut, das im System definiert ist, filtern.
- Filter Name: Filtern Sie die Funktionsergebnisse nach Attributname.
- Filter Operator: Hier können Sie unter mehreren Operatoren wählen.
- Filter Type: Wählen Sie aus verschiedenen Filtertypen aus.
- Filter Value: Geben Sie einen Wert für das Eingabefilterattribut an.
Die Komponentenoptionen für Function lauten wie folgt: - AVERAGE—Der Durchschnitt der Eingabewerte.
- COUNT—Die Anzahl der Features.
- MAX—Das Maximum der Eingabewerte.
- MIN—Das Minimum der Eingabewerte.
- ADD—Die Summe der Werte.
- SUBTRACT—Die Differenz der Werte.
Beispiel: Ein Startpunkt-Feature weist den Wert 20 auf. Das nächste Feature hat den Wert 30. Wenn Sie die Funktion MIN verwenden, lautet das Ergebnis 20, bei MAX lautet es 30, bei ADD 50, bei AVERAGE 25, bei COUNT 2 und bei SUBTRACT -10. Die Komponentenoptionen für Filter Operator lauten wie folgt: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
Die Komponentenoptionen für Filter Type lauten wie folgt: - SPECIFIC_VALUE—Nach einem bestimmten Wert filtern.
- NETWORK_ATTRIBUTE—Nach einem Netzwerkattribut filtern.
| Value Table |
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (optional) | Die Typen der Features, die basierend auf einem Netzwerkattribut zurückgegeben werden sollen. Bei einer Verfolgung, die beispielsweise zum Herausfiltern aller Features außer Abzweigungs-Features konfiguriert wurde, sind in den Ergebnissen keine verfolgten Features enthalten, denen nicht das Attribut "Abzweigung" zugewiesen wurde. Verfolgte Features, denen die Kategorie "Abzweigung" zugewiesen wurde, werden im Ergebnisauswahlsatz zurückgegeben. Bei Verwendung mehrerer Attribute können Sie mit der Option Combine Using eine And- oder eine Or-Bedingung definieren.
Die Komponenten der Ausgabebedingungen sind folgende: - Name: Filtern Sie nach einem beliebigen im System definierten Netzwerkattribut.
- Operator: Hier können Sie unter mehreren Operatoren wählen.
- Type: Wählen Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der in der Komponente Name angegeben ist, aus.
- Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
- Combine Using: Legen Sie diesen Wert fest, wenn Sie mehrere Attribute hinzufügen möchten. Sie können sie mit einer And- oder einer Or-Bedingung verbinden.
Die Komponentenoptionen für Operator lauten wie folgt: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
Die Komponentenoptionen für Type lauten wie folgt: - SPECIFIC_VALUE—Nach einem bestimmten Wert filtern.
- NETWORK_ATTRIBUTE—Nach einem Netzwerkattribut filtern.
Die Komponentenoptionen für Combine Using lauten wie folgt: - AND—Kombiniert die Bedingungen.
- OR—Wird verwendet, wenn eine der Bedingungen erfüllt ist.
| Value Table |
result_types [result_types,...] (optional) | Gibt den Typ der Ergebnisse an, die von der Verfolgung zurückgegeben werden. - SELECTION—Die Verfolgungsergebnisse werden als Auswahlsatz der entsprechenden Netzwerk-Features zurückgegeben. Dies ist die Standardeinstellung.
- AGGREGATED_GEOMETRY—Die Ergebnisse der Verfolgung werden nach Geometrietyp aggregiert und in Feature-Classes gespeichert, die in Layern auf der aktiven Karte angezeigt werden.
| String |