Routen anhängen (Location Referencing)

Mit der Location Referencing-Lizenz verfügbar.

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 Server-Verzeichnis 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 der ArcGIS Pro-Instanz zu schreiben. Bei größeren Datenlasten empfiehlt es sich, das maximale Dateialter auf mindestens eine Stunde zu ändern. Um diese Einstellung anzupassen, können Sie ein Serververzeichnis in ArcGIS Server Manager bearbeiten

Verwendung

• Zum Ausführen dieses Werkzeugs ist ein LRS-Dataset erforderlich.

  • Weitere Informationen zum Erstellen eines LRS-Dataset finden Sie unter ArcGIS Pipeline Referencing.
  • Weitere Informationen zum Erstellen eines LRS-Dataset finden Sie unter 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 sowie die Routen im Ziel-LRS-Netzwerk.
  • Wenn vorhandene Mittelachsen berücksichtigt werden, verknüpft dieses Werkzeug Routen mit vorhandenen Mittelachsen im Ziel-LRS-Dataset, deren Geometrie exakt mit den 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.
  • Überlappende Mittelachsen wurden gefunden.
  • Es gibt keine Mittelachsen, 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 * sqrt(2) * (2 * Toleranz + 2 * Auflösung)

    Weitere Informationen zur Cluster-Bildung finden Sie unter Grundlagen zu Feature-Classes.

• Die Ausgabe-Routen 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 abgerufen.
  • 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.

  Weitere Informationen zur Konfliktvermeidung in ArcGIS Pipeline Referencing oder Konfliktvermeidung in ArcGIS Roads and Highways

• Wenn die Eingabe-Polyline-Feature-Class Kurven enthält, werden die Kurven verdichtet.

  Weitere Informationen zu Kurven in ArcGIS Pipeline Referencing und zu 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 das Ziel-LRS-Netzwerk einen Routennamen konfiguriert hat, 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. Weisen die Routen-IDs dabei NULL-Werte auf, werden für die angehängten Routen automatisch Routen-IDs generiert.

• Das Werkzeug prüft, ob die Linienreihenfolgewerte größer 0 sind und in 100er-Schritten vorliegen und ob Verlauf und Richtung von Routen in einer Linie ausgerichtet sind. Falsche Werte für die Linienreihenfolge führen zu einem Werkzeugfehler. Falsche Linienreihenfolgewerte werden in der Ausgabetextdatei als Fehler aufgezeichnet. Wurden diese Fehler behoben, kann das Werkzeug erfolgreich ausgeführt werden.

• Das Werkzeug prüft auf ein Versorgungsnetz, das mit dem LRS-Netzwerk konfiguriert wurde, in das die Routen geladen werden. Wird ein Versorgungsnetz gefunden, berücksichtigt das Werkzeug vorhandene Mittelachsen beim Anhängen von Routen, und der Parameter Vorhandene Mittelachsen berücksichtigen im Bereich Geoverarbeitung ist ausgeblendet.

  Weitere Informationen zum Verwalten von Pipeline Referencing zusammen mit einem Versorgungsnetz

• 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 Mittellachsensequenzdatensätze ersetzt. Auf der Route befindliche Kalibrierungspunkte 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.

Parameter

Dialogfeld

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 "String" oder "GUID" lauten. Wenn es ein Zeichenfolgenfeld ist, 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 den Anfang der Zeit 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 dieses Feld nicht zugeordnet wird, wird für alle angehängten Routen ein NULL-Wert angegeben, der das Ende des Zeitraumes 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 Vereinigungsregeln für die einzelnen Ausgabefelder festlegen, sie werden aber vom Werkzeug ignoriert.	Field Mappings
Ladetyp (optional)	Gibt an, wie angehängte Routen mit Messwert- oder Zeitraumü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 bedeckt, wird der 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 zum 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 mit vorhandenen Mittelachsen angehängt werden. 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

Python

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 "String" oder "GUID" lauten. Wenn es ein Zeichenfolgenfeld ist, 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 den Anfang der Zeit darstellt.	Field
to_date_field (optional)	Das Datumsfeld in der Eingabe-Polyline-Feature-Class, das dem Enddatums-Feld des LRS-Netzwerks zugeordnet wird. Wenn dieses Feld nicht zugeordnet wird, wird für alle angehängten Routen ein NULL-Wert angegeben, der das Ende des Zeitraumes 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 aufweist (Felddefinitionen). Sie können zwar Vereinigungsregeln für die einzelnen Ausgabefelder festlegen, sie werden aber vom Werkzeug ignoriert. Zum Definieren dieses Parameters kann die ArcPy-Klasse FieldMappings verwendet werden.	Field Mappings
load_type (optional)	Gibt an, wie angehängte Routen mit Messwert- oder Zeitraumü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 bedeckt, wird der 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 zum 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 mit vorhandenen Mittelachsen angehängt werden. 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

# Check out license
arcpy.CheckOutExtension("LocationReferencing")


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

# Check in license
arcpy.CheckInExtension('LocationReferencing')

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

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

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


# Check in license
arcpy.CheckInExtension('LocationReferencing')

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

# Check out any necessary licenses.
arcpy.CheckOutExtension("LocationReferencing")

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

# Check in licenses
arcpy.CheckInExtension('LocationReferencing')

Umgebungen

Aktueller Workspace

Lizenzinformationen

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