Routen anhängen (Location Referencing Tools)

Zusammenfassung

Hängt Routen aus einem Eingabe-Polylinien-Layer in einem LRS-Netzwerk an.

Hinweis:

Wenn es sich bei dem Ziel-Layer um einen Feature-Service-Layer handelt, werden die Validierungsergebnisse in eine Datei im ArcGIS-Serververzeichnis geschrieben. Diese Datei wird standardmäßig automatisch nach 10 Minuten bereinigt. Das ist möglicherweise nicht ausreichend, um alle Validierungen zu verarbeiten und in die Workstation mit ArcGIS Pro zu schreiben. Bei größeren Datenlasten empfiehlt es sich, das maximale Dateialter auf mindestens eine Stunde zu ändern. Sie können ein Serververzeichnis in ArcGIS Server Manager bearbeiten, um diese Einstellung anzupassen.

Verwendung

Zur Ausführung dieses Werkzeugs ist ein LRS-Dataset erforderlich.
- Weitere Informationen zum Erstellen eines LRS-Datasets in ArcGIS Pipeline Referencing
- Weitere Informationen zum Erstellen eines LRS-Datasets in ArcGIS Roads and Highways
Dieses Werkzeug unterstützt das Anhängen von Routen an vorhandene Mittelachsen, wenn der Parameter Vorhandene Mittelachsen berücksichtigen aktiviert ist.
- Wenn vorhandene Mittelachsen nicht berücksichtigt werden, erstellt dieses Werkzeug Mittelachsen im Ziel-LRS-Dataset und die Routen im Ziel-LRS-Netzwerk.
- Bei Berücksichtigung vorhandener Mittelachsen verknüpft dieses Werkzeug Routen mit vorhandenen Mittellachsen im Ziel-LRS-Dataset, deren Geometrie exakt mit der der Quellrouten übereinstimmt. Wenn die Mittelachse, an die Sie eine Route anhängen, keine Mittelachsen-ID aufweist, wird eine erstellt, und ein Datensatz für eine Mittelachsensequenz wird hinzugefügt. Wenn beim Anhängen einer Route eine Mittelachsen-ID bereits vorhanden ist, wird der vorhandene Datensatz für die Mittelachsensequenz mit der Routen-ID der angehängten Route aktualisiert.
Wenn der Parameter Vorhandene Mittelachsen berücksichtigen aktiviert ist, führen die folgenden Bedingungen zu einem Fehler und müssen korrigiert werden, damit die Quellrouten angehängt werden können:
- Zum Anhängen des Routen-Features muss die Mittelachse geteilt werden.
- Die X-, Y- und Z-Geometrien der Mittelachsen und Routen stimmen nicht überein.
- Eine Mittelachse ist eine Teilübereinstimmung, z. B. wenn sich ein Teil der Mittelachse außerhalb der X-, Y- und Z-Toleranz befindet.
- Eine angehängte Route weist mindestens eine Mittelachse auf, die mit der Geometrie übereinstimmt, aber es gibt Positionen ohne Mittelachsen.
- Es wurden überlappende Mittelachsen erkannt.
- Es sind keine Mittelachsen vorhanden, die mit einer angehängten Route übereinstimmen.
- Die Quellrouten oder vorhandenen Mittelachsen weisen eine Länge von null oder nahezu null auf, was aufgrund von Cluster-Bildung zu Lücken in der Geometrie führt. Bei der Cluster-Bildung werden zwei Punkte aneinander gefangen, wenn der Abstand zwischen ihnen kleiner oder gleich dem folgenden Wert ist:
  
  \(1.01 \space * \space sqrt(2) \space * \space (2 \space * \space tolerance \space + \space 2 \space * \space resolution)\)
  
  Weitere Informationen zur Cluster-Bildung finden Sie unter Grundlagen zu Feature-Classes.
Die Ausgaberouten weisen X-, Y- und Z-Werte aus den Stützpunkten der Eingabe-Polylinie auf, es werden jedoch keine M-Werte angehängt.
Erstellen Sie neue Felder, die für die Feldzuordnung in der zugrunde liegenden LRS-Network-Feature-Class verwendet werden, bevor Sie Routen anhängen.
Raumbezug, XY-Auflösung und XY-Toleranz der Eingabe-Polyline-Feature-Class und des Ziel-LRS-Netzwerks müssen übereinstimmen.
Eine Textdatei wird lokal geschrieben und gibt an, dass das Werkzeug ausgeführt wurde. Zudem enthält es Informationen zu Routen, deren Validierung fehlgeschlagen ist. Die Werkzeugmeldungen geben den Speicherort des Textprotokolls an. Dabei handelt es sich um das temporäre Verzeichnis.
Wenn der Parameter Teilweises Laden von Routen zulassen aktiviert ist, wird Folgendes unterstützt:
- Gültige Quellrouten werden weiterhin an das Ziel-LRS-Netzwerk angehängt, auch dann, wenn bei bestimmten Quellrouten die Validierung fehlschlägt.
- Das Werkzeug stellt eine Feature-Class bereit, die Quellrouten enthält, deren Validierung fehlschlägt. Mithilfe der Informationen in der Textdatei können Sie die problematischen Quellrouten korrigieren.
  
  Hinweis:
  
  Die erstellte Feature-Class ist eine temporäre Feature-Class, die beim Schließen von ArcGIS Pro gelöscht wird. Zum Erstellen einer Kopie der Feature-Class klicken Sie im Bereich Inhalt mit der rechten Maustaste auf den Layer, und klicken Sie auf Daten > Features exportieren, oder verwenden Sie das Werkzeug Features exportieren.
Die Ausgabe dieses Werkzeugs ist ein geändertes LRS-Netzwerk, in dem Routen angehängt und Mittelachsen-Features erstellt wurden.
Wenn die Konfliktvermeidung aktiviert ist, wird Folgendes unterstützt:
- Wenn die anzuhängenden Routen neu sind, werden für diese Routen keine Sperren angefordert.
- Für andere Ladetypen, z. B. Nach Routen-ID stilllegen und Nach Routen-ID ersetzen, werden Sperren automatisch abgerufen, sofern verfügbar.
- Wenn die Sperren nicht abgerufen werden können, wird das Werkzeug nicht ausgeführt und stellt eine Textdatei mit den problematischen Sperren bereit.
- Beim Arbeiten in der Default-Version werden die abgerufenen Sperren nach erfolgreicher Ausführung des Werkzeugs automatisch aufgehoben.
- Beim Arbeiten in einer benannten Version behalten die abgerufenen Sperren nach Abschluss des Werkzeugs den aufhebbaren Status "On Post" bei. Schreiben Sie die Version zurück, oder löschen Sie sie, um die Sperren aufzuheben.
- Wenn beim Arbeiten in einer benannten Version der Werkzeugprozess durch eine Unterbrechung abgebrochen wird, behalten die abgerufenen Sperren den aufhebbaren Status "Ja" bei. Der Besitzer der Sperre kann die Sperren aufheben.
Erfahren Sie mehr über das Aufheben von Sperren in ArcGIS Pipeline Referencing oder das Aufheben von Sperren in ArcGIS Roads and Highways.

Erfahren Sie mehr über die Konfliktvermeidung in ArcGIS Pipeline Referencing oder die Konfliktvermeidung in ArcGIS Roads and Highways.
Wenn die Eingabe-Polyline-Feature-Class Kurven enthält, werden die Kurven verdichtet.

Erfahren Sie mehr über Kurven in ArcGIS Pipeline Referencing oder Kurven in ArcGIS Roads and Highways.
Wenn das Ziel-LRS-Netzwerk als Liniennetzwerk mit Unterstützung für eine Mehrfeld-Routen-ID konfiguriert wurde, sind die folgenden Parameter zum Anhängen von Routen nicht erforderlich:
- Feld für Routenname
- Feld für Linienname
Wenn für das Ziel-LRS-Netzwerk ein Routenname konfiguriert ist, können beim Anhängen neuer Routen unter Verwendung des Parameterwertes Hinzufügen für den Parameter Ladetyp Routen unter Verwendung des Routennamens angehängt werden. Wenn die Routen-IDs NULL sind, werden automatisch Routen-IDs für die angehängten Routen generiert.
Das Werkzeug prüft, ob die Werte für die Reihenfolge der Linien größer als Null sind und 100er-Schritte mit Fluss und Richtung der Routen in einer Linie aufweisen. Falsche Werte für die Linienreihenfolge führen zu einem Werkzeugfehler. In der Ausgabetextdatei werden die falschen Werte für die Linienreihenfolge als Fehler protokolliert. Das Werkzeug wird erfolgreich ausgeführt, sobald diese Fehler behoben sind.
Das Werkzeug prüft auf ein Versorgungsnetz, das mit dem LRS-Netzwerk konfiguriert wurde, in das die Routen geladen werden. Wenn ein Versorgungsnetz gefunden wird, berücksichtigt das Werkzeug beim Anhängen von Routen vorhandene Mittelachsen, und der Parameter Vorhandene Mittelachsen berücksichtigen wird im Bereich Geoverarbeitung ausgeblendet.

Weitere Informationen über das gemeinsame Verwalten von Pipeline Referencing und Versorgungsnetzen
Dieses Werkzeug schlägt fehl, wenn der Parameter Ladetyp auf Nach Routen-ID ersetzen oder Nach Routen-ID stilllegen festgelegt ist und die Quellroute nicht die gleichen Werte für Routenname und Routen-ID wie die Zielroute aufweist.
Wenn für den Parameter Ladetyp der Parameterwert Nach Routen-ID ersetzen angegeben ist, werden bei allen Routen, die ersetzt werden, die Routen- und Mittelachsensequenz-Datensätze ersetzt. Kalibrierungspunkte auf der Route werden gelöscht und müssen neu erstellt oder neu geladen werden.
Wenn das LRS mit der Lösung "Address Data Management" konfiguriert ist, ist der Parameter Vorhandene Mittelachsen berücksichtigen standardmäßig aktiviert.

Beschriftung	Erläuterung	Datentyp
Quellrouten	Die Eingabe, aus der die Routen abgeleitet werden. Die Eingabe kann eine Polyline-Feature-Class, ein Shapefile, ein Feature-Service oder eine LRS-Network-Feature-Class sein.	Feature Layer
LRS-Netzwerk	Das Ziel-LRS-Netzwerk, in das die Routen geladen werden.	Feature Layer
Routen-ID-Feld	Das Feld in der Eingabe-Polyline-Feature-Class, das dem Routen-ID-Feld des LRS-Netzwerks zugeordnet wird. Der Feldtyp muss mit dem `RouteID`-Feldtyp des Ziel-LRS-Netzwerks übereinstimmen und einem Zeichenfolgen- oder GUID-Feldtyp entsprechen. Wenn es sich um ein Zeichenfolgenfeld handelt, muss die Feldlänge kürzer oder gleich der Länge des `RouteID`-Zielfeldes sein.	Field
Feld für Routenname	Das Feld in der Eingabe-Polyline-Feature-Class, das dem Routennamen-Feld des LRS-Netzwerks zugeordnet wird. Das Feld muss ein Zeichenfolgenfeld sein, und die Feldlänge muss kürzer oder gleich der Länge des Namensfeldes der Zielroute sein.	Field
Feld für Von-Datum (Optional)	Das Datumsfeld in der Eingabe-Polyline-Feature-Class, das dem Startdatums-Feld des LRS-Netzwerks zugeordnet wird. Wenn das Feld nicht zugeordnet wird, wird für alle angehängten Routen ein NULL-Wert angegeben, der die Anfangszeit darstellt.	Field
Feld für Bis-Datum (Optional)	Das Datumsfeld in der Eingabe-Polyline-Feature-Class, das dem Enddatums-Feld des LRS-Netzwerks zugeordnet wird. Wenn das Feld nicht zugeordnet wird, wird für alle angehängten Routen ein NULL-Wert angegeben, der die Endzeit darstellt.	Field
Linien-ID-Feld (Optional)	Das Feld in der Eingabe-Polyline-Feature-Class, das dem Linien-ID-Feld des LRS-Netzwerks zugeordnet wird. Dieser Parameter wird nur verwendet, wenn das Ziel-LRS-Netzwerk ein LRS-Liniennetzwerk ist. Der Feldtyp und die Feldlänge müssen mit den Angaben im Routen-ID-Feld der Mittelachsensequenztabelle übereinstimmen.	Field
Feld für Linienname (Optional)	Das Zeichenfolgenfeld in der Eingabe-Polyline-Feature-Class, das dem Liniennamen-Feld des LRS-Netzwerks zugeordnet wird. Dieser Parameter wird nur verwendet, wenn das Ziel-LRS-Netzwerk ein LRS-Liniennetzwerk ist.	Field
Feld für Linienreihenfolge (Optional)	Das Feld vom Typ "Long Integer" in der Eingabe-Polyline-Feature-Class, das dem Linienreihenfolge-Feld des LRS-Netzwerks zugeordnet wird. Dieser Parameter wird nur verwendet, wenn das Ziel-LRS-Netzwerk ein LRS-Liniennetzwerk ist. Erfahren Sie mehr über Liniennetzwerke und die Linienreihenfolge in Pipeline Referencing oder über Liniennetzwerke und die Linienreihenfolge in Roads and Highways.	Field
Feldzuordnung (Optional)	Steuert, wie Attributinformationen in den Quellroutenfeldern in das Eingabe-LRS-Netzwerk übertragen werden. Felder können nicht zum Ziel-LRS-Netzwerk hinzugefügt oder daraus entfernt werden, da die Daten der Quellrouten an ein vorhandenes LRS-Netzwerk angehängt werden, das ein vordefiniertes Schema aufweist. Sie können zwar Regeln zum Zusammenführen für die einzelnen Ausgabefelder festlegen, die Regeln werden jedoch vom Werkzeug ignoriert.	Field Mappings
Ladetyp (Optional)	Gibt an, wie angehängte Routen mit Kennwert- oder Temporalitätsüberlappungen mit identischen Routen-IDs in die Network-Feature-Class geladen werden. Hinzufügen—Die angehängten Routen werden in das Ziel-LRS-Netzwerk geladen. Wenn eine Routen-ID in den Quellrouten im Ziel-LRS-Netzwerk mit der gleichen Temporalität bereits vorhanden ist, wird sie als doppelte Route in das Ausgabeprotokoll geschrieben und muss vor Abschluss des Ladevorgangs korrigiert oder herausgefiltert werden. Dies ist die Standardeinstellung. Nach Routen-ID stilllegen—Die angehängten Routen werden in das Ziel-LRS-Netzwerk geladen, und Routen im Ziel-LRS-Netzwerk mit der gleichen Routen-ID- und Temporalitätsüberlappung wie die angehängten Routen werden stillgelegt. Wenn die angehängte Route eine Zielroute mit der gleichen Routen-ID übersteigt, wird die Zielroute gelöscht. Nach Routen-ID ersetzen—Die angehängten Routen werden in das Ziel-LRS-Netzwerk geladen, und Routen im Ziel-LRS-Netzwerk mit der gleichen Routen-ID wie die angehängten Routen werden gelöscht.	String
Ladefeld (Optional)	Gibt das Feld an, das für das Laden von Routen verwendet wird. Routen-ID—Die Routen werden über das Routen-ID-Feld geladen. Dies ist die Standardeinstellung. Routenname—Die Routen werden über das Routennamen-Feld geladen. Diese Option ist nur für Netzwerke verfügbar, deren Routenname im LRS-Netzwerk konfiguriert wurde, wenn der Parameter Ladetyp auf Hinzufügen festgelegt wurde.	String
Vorhandene Mittelachsen berücksichtigen (Optional)	Gibt an, ob Routen unter Verwendung vorhandener Mittelachsen angehängt werden sollen. Aktiviert—Routen werden unter Verwendung vorhandener Mittelachsen angefügt, und es werden keine neuen Mittelachsen erstellt. Deaktiviert—Für die angehängten Routen werden neue Mittelachsen erstellt. Dies ist die Standardeinstellung.	Boolean
Teilweises Laden von Routen zulassen (Optional)	Gibt an, ob gültige Routen auch dann angehängt werden, wenn bei bestimmten Routen die Validierung fehlschlägt. Aktiviert—Gültige Routen werden angehängt, auch wenn bei bestimmten Routen die Validierung fehlschlägt. Deaktiviert—Wenn bei bestimmten Routen die Validierung fehlschlägt, werden keine Routen angehängt. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
LRS-Netzwerk	Der aktualisierte LRS-Netzwerk-Feature-Layer.	Feature Layer
Ausgabe-Ergebnisdatei	Die Textdatei, die Details zu den vom Werkzeug vorgenommenen Änderungen enthält.	Text File
Übersprungene Routen	Die Feature-Class, die Quellrouten enthält, deren Validierung fehlschlägt.	Feature Class

arcpy.locref.AppendRoutes(source_routes, in_lrs_network, route_id_field, route_name_field, {from_date_field}, {to_date_field}, {line_id_field}, {line_name_field}, {line_order_field}, {field_map}, {load_type}, {load_field}, {consider_existing_centerlines}, {allow_partial_loading})

Name	Erläuterung	Datentyp
source_routes	Die Eingabe, aus der die Routen abgeleitet werden. Die Eingabe kann eine Polyline-Feature-Class, ein Shapefile, ein Feature-Service oder eine LRS-Network-Feature-Class sein.	Feature Layer
in_lrs_network	Das Ziel-LRS-Netzwerk, in das die Routen geladen werden.	Feature Layer
route_id_field	Das Feld in der Eingabe-Polyline-Feature-Class, das dem Routen-ID-Feld des LRS-Netzwerks zugeordnet wird. Der Feldtyp muss mit dem `RouteID`-Feldtyp des Ziel-LRS-Netzwerks übereinstimmen und einem Zeichenfolgen- oder GUID-Feldtyp entsprechen. Wenn es sich um ein Zeichenfolgenfeld handelt, muss die Feldlänge kürzer oder gleich der Länge des `RouteID`-Zielfeldes sein.	Field
route_name_field	Das Feld in der Eingabe-Polyline-Feature-Class, das dem Routennamen-Feld des LRS-Netzwerks zugeordnet wird. Das Feld muss ein Zeichenfolgenfeld sein, und die Feldlänge muss kürzer oder gleich der Länge des Namensfeldes der Zielroute sein.	Field
from_date_field (Optional)	Das Datumsfeld in der Eingabe-Polyline-Feature-Class, das dem Startdatums-Feld des LRS-Netzwerks zugeordnet wird. Wenn das Feld nicht zugeordnet wird, wird für alle angehängten Routen ein NULL-Wert angegeben, der die Anfangszeit darstellt.	Field
to_date_field (Optional)	Das Datumsfeld in der Eingabe-Polyline-Feature-Class, das dem Enddatums-Feld des LRS-Netzwerks zugeordnet wird. Wenn das Feld nicht zugeordnet wird, wird für alle angehängten Routen ein NULL-Wert angegeben, der die Endzeit darstellt.	Field
line_id_field (Optional)	Das Feld in der Eingabe-Polyline-Feature-Class, das dem Linien-ID-Feld des LRS-Netzwerks zugeordnet wird. Dieser Parameter wird nur verwendet, wenn das Ziel-LRS-Netzwerk ein LRS-Liniennetzwerk ist. Der Feldtyp und die Feldlänge müssen mit den Angaben im Routen-ID-Feld der Mittelachsensequenztabelle übereinstimmen.	Field
line_name_field (Optional)	Das Zeichenfolgenfeld in der Eingabe-Polyline-Feature-Class, das dem Liniennamen-Feld des LRS-Netzwerks zugeordnet wird. Dieser Parameter wird nur verwendet, wenn das Ziel-LRS-Netzwerk ein LRS-Liniennetzwerk ist.	Field
line_order_field (Optional)	Das Feld vom Typ "Long Integer" in der Eingabe-Polyline-Feature-Class, das dem Linienreihenfolge-Feld des LRS-Netzwerks zugeordnet wird. Dieser Parameter wird nur verwendet, wenn das Ziel-LRS-Netzwerk ein LRS-Liniennetzwerk ist. Erfahren Sie mehr über Liniennetzwerke und die Linienreihenfolge in Pipeline Referencing oder über Liniennetzwerke und die Linienreihenfolge in Roads and Highways.	Field
field_map (Optional)	Steuert, wie Attributinformationen in den Quellroutenfeldern in das Eingabe-LRS-Netzwerk übertragen werden. Felder können nicht zum Ziel-LRS-Netzwerk hinzugefügt oder daraus entfernt werden, da die Daten der Quellrouten an ein vorhandenes LRS-Netzwerk angehängt werden, das ein vordefiniertes Schema (Felddefinitionen) aufweist. Sie können zwar Regeln zum Zusammenführen für die einzelnen Ausgabefelder festlegen, die Regeln werden jedoch vom Werkzeug ignoriert. Dieser Parameter kann mit der ArcPy-Klasse `FieldMappings` definiert werden.	Field Mappings
load_type (Optional)	Gibt an, wie angehängte Routen mit Kennwert- oder Temporalitätsüberlappungen mit identischen Routen-IDs in die Network-Feature-Class geladen werden. `ADD`—Die angehängten Routen werden in das Ziel-LRS-Netzwerk geladen. Wenn eine Routen-ID in den Quellrouten im Ziel-LRS-Netzwerk mit der gleichen Temporalität bereits vorhanden ist, wird sie als doppelte Route in das Ausgabeprotokoll geschrieben und muss vor Abschluss des Ladevorgangs korrigiert oder herausgefiltert werden. Dies ist die Standardeinstellung. `RETIRE_BY_ROUTE_ID`—Die angehängten Routen werden in das Ziel-LRS-Netzwerk geladen, und Routen im Ziel-LRS-Netzwerk mit der gleichen Routen-ID- und Temporalitätsüberlappung wie die angehängten Routen werden stillgelegt. Wenn die angehängte Route eine Zielroute mit der gleichen Routen-ID übersteigt, wird die Zielroute gelöscht. `REPLACE_BY_ROUTE_ID`—Die angehängten Routen werden in das Ziel-LRS-Netzwerk geladen, und Routen im Ziel-LRS-Netzwerk mit der gleichen Routen-ID wie die angehängten Routen werden gelöscht.	String
load_field (Optional)	Gibt das Feld an, das für das Laden von Routen verwendet wird. `ROUTE_ID`—Die Routen werden über das Routen-ID-Feld geladen. Dies ist die Standardeinstellung. `ROUTE_NAME`—Die Routen werden über das Routennamen-Feld geladen. Diese Option ist nur für Netzwerke verfügbar, deren Routenname im LRS-Netzwerk konfiguriert wurde, wenn der Parameter `load_type` auf `ADD` festgelegt wurde.	String
consider_existing_centerlines (Optional)	Gibt an, ob Routen unter Verwendung vorhandener Mittelachsen angehängt werden sollen. `CONSIDER`—Routen werden unter Verwendung vorhandener Mittelachsen angefügt, und es werden keine neuen Mittelachsen erstellt. `DO_NOT_CONSIDER`—Für die angehängten Routen werden neue Mittelachsen erstellt. Dies ist die Standardeinstellung.	Boolean
allow_partial_loading (Optional)	Gibt an, ob gültige Routen auch dann angehängt werden, wenn bei bestimmten Routen die Validierung fehlschlägt. `ALLOW`—Gültige Routen werden angehängt, auch wenn bei bestimmten Routen die Validierung fehlschlägt. `DO_NOT_ALLOW`—Wenn bei bestimmten Routen die Validierung fehlschlägt, werden keine Routen angehängt. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_lrs_network	Der aktualisierte LRS-Netzwerk-Feature-Layer.	Feature Layer
out_details_file	Die Textdatei, die Details zu den vom Werkzeug vorgenommenen Änderungen enthält.	Text File
out_skipped_routes	Die Feature-Class, die Quellrouten enthält, deren Validierung fehlschlägt.	Feature Class

Codebeispiel

AppendRoutes: Beispiel 1 (Python-Fenster)

Das folgende Skript veranschaulicht, wie die Funktion AppendRoutes im Python-Fenster verwendet wird, um Routen in einem vorhandenen LRS-Netzwerk anzuhängen und dabei Routen mit Überlappungen zu ersetzen.

# Name: AppendRoutes_ex1.py
# Description: Append routes into an existing LRS Network, replacing routes where an overlap occurs.
# Requires: ArcGIS Location Referencing

# Set current workspace
arcpy.env.workspace= r"C:\DOT.gdb"

# Set tool variables
source_routes = r"C:\Data\Input.gdb\RoutestoAppend"
in_lrs_network = r"C:\Data\DOT.gdb\LRS\StateRoutes"
route_id_field = "RouteId"
route_name_field = None
from_date_field = "FromDate"
to_date_field = "ToDate"
line_id_field = None
line_name_field = None
line_order_field = None
field_map = None
load_type = "REPLACE_BY_ROUTE_ID"
load_field = None
consider_existing_centerlines = "DO_NOT_CONSIDER"
allow_partial_loading = "DO_NOT_ALLOW"

# Run the tool
arcpy.locref.AppendRoutes(source_routes, in_lrs_network, route_id_field, route_name_field, from_date_field,
                          to_date_field, line_id_field, line_name_field, line_order_field, field_map, load_type,
                          load_field, consider_existing_centerlines, allow_partial_loading)

AppendRoutes: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion AppendRoutes verwendet wird, wenn vorhandene Mittelachsen berücksichtigt werden.

# Name: AppendRoutes_ex2.py
# Description: Appending new routes into an existing LRS network using Route Name in python stand alone script. Existing centerlines are considered.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Set tool variables:
source_routes = r"C:\Data\Input.gdb\RoutestoAppend"
in_lrs_network = r"C:\Data\pipelinereferencing.gdb\LRS\EngineeringNetwork"
route_id_field = "RouteId"
route_name_field = "RouteName"
from_date_field = "FromDate"
to_date_field = "ToDate"
line_id_field = "LineId"
line_name_field = "LineName"
line_order_field = "LineOrder"
field_map = None
load_type = "ADD"
load_field = "RouteName"
consider_existing_centerlines = "CONSIDER"
allow_partial_loading = "DO_NOT_ALLOW"

# Process: Append Routes
arcpy.locref.AppendRoutes(source_routes, in_lrs_network, route_id_field, route_name_field, from_date_field, to_date_field, line_id_field, line_name_field,
                          line_order_field, field_map, load_type, load_field, consider_existing_centerlines, allow_partial_loading)

AppendRoutes: Beispiel 3 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion AppendRoutes für ein vom Benutzer erstelltes Routen-ID-Netzwerk verwendet wird.

# Name: AppendRoutes_ex3.py
# Description: Append records into an existing usergenerated routeId network feature class in a stand-alone script.
# Source fields: RS and RN, Target fields: RouteSystem and RouteNumber
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Local variables:
source_routes = r"C:\Data\DOT.gdb\LRS\RoutestoAppend"
in_lrs_network = r"C:\Data\DOT.gdb\LRS\StateRoutes"
route_id_field = "RouteId"
route_name_field = None
from_date_field = "FromDate"
to_date_field = "ToDate"
line_id_field = None
line_name_field = None
line_order_field = None
load_type = "ADD"
load_field = None
consider_existing_centerlines = "DO_NOT_CONSIDER"
allow_partial_loading = "DO_NOT_ALLOW"

# Define field mappings object
fieldMappings = arcpy.FieldMappings()

# Add input fields
fldmap1 = arcpy.FieldMap()
fldmap1.addInputField(source_routes, "RS")

fldmap2 = arcpy.FieldMap()
fldmap2.addInputField(source_routes, "RN")

# Set output fields
fld1 = fldmap1.outputField
fld1.name = "RouteSystem"
fld1.aliasName = "RouteSystem"
fldmap1.outputField = fld1

fld2 = fldmap2.outputField
fld2.name = "RouteNumber"
fld2.aliasName = "RouteNumber"
fldmap2.outputField = fld2

# Add output fields to field mappings object
fieldMappings.addFieldMap(fldmap1)
fieldMappings.addFieldMap(fldmap2)

# Run Append Routes
arcpy.locref.AppendRoutes(source_routes, in_lrs_network, route_id_field, route_name_field, from_date_field, to_date_field,
                          line_id_field, line_name_field, line_order_field, fieldMappings, load_type, load_field,
                          consider_existing_centerlines, allow_partial_loading)

AppendRoutes: Beispiel 4 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion AppendRoutes in einem Feature-Service verwendet wird.

# Name: AppendRoutes_Pro_Ex4.py
# Description: Append routes using a feature service in a stand-alone script. It is recommended to work in a named version and post it into the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

# Set tool variables.
source_routes = r"C:\LocationReferencing\LR.gdb\LRS\routes"
route_id_field = "ROUTEID"
route_name_field = "ROUTENAME"
from_date_field = "FROMDATE"
to_date_field = "TODATE"
line_id_field = "LINEID"
line_name_field = "LINENAME"
line_order_field = "ORDERID"
field_mapping = r'CREATIONUSER "Creation User" true true false 50 Text 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\routes,CREATIONUSER,0,50;DATECREATED "Date Created" true true false 8 Date 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\routes,DATECREATED,-1,-1;DATEMODIFIED "Date Modified" true true false 8 Date 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\routes,DATEMODIFIED,-1,-1;LASTUSER "Last User" true true false 50 Text 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\routes,LASTUSER,0,50;EVENTSOURCE "Event Source" true true false 50 Text 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\routes,EVENTSOURCE,0,50;LEGACYID "Legacy ID" true true false 38 Text 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\routes,LEGACYID,0,38;ENGFROMM "ENGFROMM" true true false 0 Double 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\routes,ENGFROMM,-1,-1;ENGTOM "ENGTOM" true true false 0 Double 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\routes,ENGTOM,-1,-1;OBJECTSTATUS "Object Status" true true false 20 Text 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\routes,OBJECTSTATUS,0,20;CONTINFROMM "Continuous from Measure" true true false 0 Double 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\routes,CONTINFROMM,-1,-1;CONTINTOM "Continuous to Measure" true true false 0 Double 0 0,First,#,C:\LocationReferencing\LR.gdb\LRS\routes,CONTINTOM,-1,-1'
load_type = "REPLACE_BY_ROUTE_ID"
load_field = None
consider_existing_centerlines = "DO_NOT_CONSIDER"
allow_partial_loading = "DO_NOT_ALLOW"

## Target Route is in feature service. Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

## Map the target route network from the feature service.Here, 18 corresponds to the target route network.
in_lrs_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"

# Run Append Routes
arcpy.locref.AppendRoutes(source_routes, in_lrs_network, route_id_field, route_name_field, from_date_field, to_date_field, line_id_field, line_name_field,
                          line_order_field, field_mapping, load_type, load_field, consider_existing_centerlines, allow_partial_loading)

Umgebungen

Aktueller Workspace

Lizenzierungsinformationen

Basic: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)
Standard: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)
Advanced: Erfordert ArcGIS Location Referencing (ArcGIS Pipeline Referencing oder ArcGIS Roads and Highways)

Routen anhängen (Location Referencing Tools)

Zusammenfassung

Hinweis:

Verwendung

Hinweis:

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen