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 auf die Workstation zu schreiben, auf der ArcGIS Pro ausgeführt wird. 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-Dataset in ArcGIS Pipeline Referencing.
  • Weitere Informationen zum Erstellen eines LRS-Dataset 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, der behoben werden muss, bevor die Ausführung des Werkzeugs abgeschlossen werden kann:

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

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

  Weitere Informationen zum Aufheben von Sperren in ArcGIS Pipeline Referencing oder zum Aufheben von Sperren in ArcGIS Roads and Highways

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

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

  Weitere Informationen finden Sie unter 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 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. 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 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. 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.

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 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. Weitere Informationen ü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 die Netzwerke verfügbar, deren Routenname im LRS-Netzwerk konfiguriert ist, wenn der Parameter Ladetyp auf Hinzufügen festgelegt ist.	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

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

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

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. Weitere Informationen ü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 FieldMappings-Klasse von ArcPy 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 die Netzwerke verfügbar, deren Routenname im LRS-Netzwerk konfiguriert ist, wenn der Parameter load_type auf ADD festgelegt ist.	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

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

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"

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

AppendRoutes: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion AppendRoutes als eigenständiges Python-Skript verwendet wird und 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"


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

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

AppendRoutes: Beispiel 3 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion AppendRoutes als eigenständiges Python-Skript 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"

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


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

AppendRoutes: Beispiel 4 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion AppendRoutes als eigenständiges Python-Skript 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 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"

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

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