Routen anhängen (Location Referencing)

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Hängt Routen aus einer Eingabe-Polylinie in einem LRS-Netzwerk an.

Hinweis:

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

Weitere Informationen zum Anpassen dieser Einstellung für das Serververzeichnis in Manager

Verwendung

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

  Weitere Informationen zum Erstellen eines LRS-Datasets in ArcGIS Pipeline Referencing und 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 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. Falls die Mittelachse, an die Sie eine Route anhängen, keinen CenterlineID-Wert aufweist, wird einer erstellt, und ein Datensatz für eine Mittelachsensequenz wird hinzugefügt. Ist beim Anhängen einer Route ein CenterlineID-Wert vorhanden, wird der vorhandene Datensatz für die Mittelachsensequenz mit dem RouteID-Wert 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 das Ausführen 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 XYZ-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 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.

• Ein Textprotokoll 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 abgerufen.
  • Für andere Ladetypen, z. B. Nach Routen-ID stilllegen und Nach Routen-ID ersetzen, werden Sperren automatisch angefordert, 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 erfolgreichem Abschluss des Werkzeugs automatisch aufgehoben.
  • Beim Arbeiten in einer Child-Version behalten die abgerufenen Sperren nach Abschluss des Werkzeugs den Status "ON POST" bei. Schreiben Sie die Version zurück, oder löschen Sie sie, um die Sperren aufzuheben.
  • Wenn beim Arbeiten in einer Child-Version der Werkzeug-Prozess durch eine Unterbrechung abgebrochen wird, werden die Sperren abgerufen und behalten den aufhebbaren Status als "Ja" bei. Der Besitzer der Sperre kann die Sperre 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-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 neue Routen für den Parameter Ladetyp mit dem Wert Hinzufügen angehängt werden und das Ziel-LRS-Netzwerk einen konfigurierten Routennamen aufweist, können Routen über den Routennamen 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 RouteName- und RouteID-Werte wie die Zielroute aufweist.

• Wenn der Wert Nach Routen-ID ersetzen für den Parameter Ladetyp angegeben wird, werden die Routen- und Mittelachsensequenz-Datensätze von ersetzten Routen ersetzt. Auf der Route befindliche Kalibrierungspunkte werden gelöscht und müssen neu erstellt oder neu geladen werden.

• Wenn das LRS mit Adressverwaltung 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 der LRS-Netzwerk-Routen-ID 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 als LRS-Netzwerk-Routenname 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)	Ein Datumsfeld in der Eingabe-Polyline-Feature-Class, das als Wert für Feld für Von-Datum im LRS-Netzwerk 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)	Ein Datumsfeld in der Eingabe-Polyline-Feature-Class, das als Wert für Feld für Bis-Datum im LRS-Netzwerk 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 als LRS-Netzwerk-Linien-ID zugeordnet wird. Dieser Parameter wird nur verwendet, wenn das Ziel-LRS-Netzwerk ein LRS-Liniennetzwerk ist. Feldtyp und Feldlänge müssen mit dem Typ und der Länge des Feldes RouteID in der Mittelachsensequenztabelle übereinstimmen.	Field
Feld für Linienname (optional)	Ein Zeichenfolgenfeld in der Eingabe-Polyline-Feature-Class, das als LRS-Netzwerk-Linienname 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 als LRS-Netzwerk-Linienreihenfolge 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 dem gleichen Zeitraum 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 Zeitraumü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 mit dem Feld RouteID geladen. Dies ist die Standardeinstellung. Routenname—Die Routen werden mit dem Feld RouteName geladen. Diese Option ist nur für Netzwerke verfügbar, für die "RouteName" 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 mit vorhandenen Mittelachsen angehängt, 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 der LRS-Netzwerk-Routen-ID 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 als LRS-Netzwerk-Routenname 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)	Ein Datumsfeld in der Eingabe-Polyline-Feature-Class, das als Wert für from_date_field im LRS-Netzwerk 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)	Ein Datumsfeld in der Eingabe-Polyline-Feature-Class, das als Wert für to_date_field im LRS-Netzwerk 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 als LRS-Netzwerk-Linien-ID zugeordnet wird. Dieser Parameter wird nur verwendet, wenn das Ziel-LRS-Netzwerk ein LRS-Liniennetzwerk ist. Feldtyp und Feldlänge müssen mit dem Typ und der Länge des Feldes RouteID in der Mittelachsensequenztabelle übereinstimmen.	Field
line_name_field (optional)	Ein Zeichenfolgenfeld in der Eingabe-Polyline-Feature-Class, das als LRS-Netzwerk-Linienname 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 als LRS-Netzwerk-Linienreihenfolge 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 dem gleichen Zeitraum 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 Zeitraumü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 mit dem Feld RouteID geladen. Dies ist die Standardeinstellung. ROUTE_NAME—Die Routen werden mit dem Feld RouteName geladen. Diese Option ist nur für Netzwerke verfügbar, für die "RouteName" 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 mit vorhandenen Mittelachsen angehängt, 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)

Im Folgenden wird 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"

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

Im Folgenden wird veranschaulicht, wie die Funktion AppendRoutes als eigenständiges Python-Skript unter Berücksichtigung vorhandener Mittelachsen verwendet wird.

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

Im Folgenden wird veranschaulicht, wie die Funktion AppendRoutes als eigenständiges Python-Skript für ein benutzergeneriertes 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)

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

Im Folgenden wird 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"

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