Features entlang von Routen lokalisieren (Linear Referencing Tools)

Zusammenfassung

Berechnet die Schnittpunkte von Eingabe-Features (Point, Line oder Polygon) und Routen-Features und schreibt die Routen- und Messwertinformationen in eine neue Objekttabelle.

Weitere Informationen zu Objekttabellen

Verwendung

Wenn der Parameterwert für Eingabe-Features auf "Punkte" festgelegt ist, muss der Wert für Objekttyp auf Punkt festgelegt werden. Wenn der Parameterwert für Eingabe-Features auf "Linien" oder "Polygone" festgelegt ist, muss der Wert für Objekttyp auf Linie festgelegt werden.
Die besten Ergebnisse werden erzielt, wenn sich die Eingabe-Features und die Zielrouten eng überlagern.

Achtung:

Die Verwendung eines großen Suchradius oder einer großen Cluster-Toleranz, um Diskrepanzen zwischen den Eingabe-Features und Zielrouten zu vermeiden, kann zu unerwarteten Ergebnissen führen.
Um die Anzahl von Eingabe-Features zu reduzieren, die von diesem Werkzeug verarbeitet werden, können Sie Layer mit einer Auswahl eingeben.
Die Ausgabe-Tabelle kann mit dem Werkzeug Routenobjekt-Layer erstellen in einer Karte angezeigt werden.

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Features von Eingabepunkt, -linie oder -polygon.	Feature Layer
Eingabe-Routen-Features	Die Routen, mit denen der Parameterwert Eingabe-Features überschnitten wird.	Feature Layer
Routen-Kennungsfeld	Mit den in diesem Feld gespeicherten Werten werden die einzelnen Routen eindeutig gekennzeichnet. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein.	Field
Suchradius	Wenn als Parameterwert Eingabe-Features Punkte angegeben sind, ist der Suchradius ein Zahlenwert. Er definiert, in welchem Radius um die Punkte eine Suche durchgeführt wird, um eine Zielroute zu ermitteln. Wenn als Parameterwert Eingabe-Features Linien angegeben sind, ist die Suchtoleranz eine Cluster-Toleranz. Dies ist ein Zahlenwert, der für die maximal zulässige Entfernung zwischen den Eingabelinien und den Zielrouten steht. Wenn als Parameterwert Eingabe-Features Polygone angegeben sind, wird dieser Parameter ignoriert und kein Suchradius verwendet.	Linear Unit
Ausgabe-Objekttabelle	Die Tabelle, die erstellt wird. Die Ausgabetabelle kann eine dBASE-Datei (`.dbf`) oder eine Geodatabase-Tabelle sein.	Table
Eigenschaften der Ausgabe-Objekttabelle	Die Routenpositionsfelder und der in die Ausgabe-Objekttabelle zu schreibende Objekttyp. Routenkennungsfeld: Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Objekte befinden. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein. Objekttyp: Der in der Ausgabe-Objekttabelle enthaltene Objekttyp (Punkt oder Linie). Punkt: Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden. Linie: Linienobjekte definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. Von-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp Punkt oder Linie festgelegt wurde. Wenn als Wert für Objekttyp die Option Punkt festgelegt ist, ändert sich die Beschriftung für diesen Parameter in Messwertfeld. Bis-Messwert-Feld: Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp Linie festgelegt wurde.	Route Measure Event Properties
Nur die nächste Routenposition behalten (Optional)	Gibt an, ob die nächstgelegene Routenposition oder alle Routenpositionen innerhalb des Suchradius in den Parameterwert Ausgabe-Objekttabelle geschrieben werden. Beim Lokalisieren von Punkten entlang von Routen besteht die Möglichkeit, dass mehrere Routen innerhalb des zu einem beliebigen Punkt festgelegten Suchradius liegen. Dieser Parameter wird ignoriert, wenn Linien oder Polygone entlang von Routen lokalisiert werden. Aktiviert—Nur die nächstgelegene Routenposition wird in den Parameterwert Ausgabe-Objekttabelle geschrieben. Dies ist die Standardeinstellung. Deaktiviert—Alle Routenpositionen innerhalb des Suchradius werden in den Parameterwert Ausgabe-Objekttabelle geschrieben.	Boolean
Entfernungsfeld in Ausgabetabelle einbeziehen (Optional)	Gibt an, ob dem Parameterwert Ausgabe-Objekttabelle ein `DISTANCE`-Feld hinzugefügt wird. Die Werte in diesem Feld übernehmen die Einheiten des angegebenen Suchradius. Dieser Parameter wird ignoriert, wenn Linien oder Polygone entlang von Routen lokalisiert werden. Aktiviert—Ein Feld, das die Entfernung von Punkt zu Route enthält, wird zum Parameterwert Ausgabe-Objekttabelle hinzugefügt. Dies ist die Standardeinstellung. Deaktiviert—Ein Feld, das die Entfernung von Punkt zu Route enthält, wird nicht zum Parameterwert Ausgabe-Ereignistabelle hinzugefügt.	Boolean
Linienobjekte mit der Länge 0 beibehalten (Optional)	Gibt an, ob Linienobjekte mit der Länge 0 in die Ausgabe geschrieben werden. Bei der Lokalisierung von Polygonen entlang von Routen können Objekte erstellt werden, in denen der Von-Messwert dem Nach-Messwert entspricht. Dieser Parameter wird ignoriert, wenn Punkte oder Linien entlang von Routen lokalisiert werden. Aktiviert—Linienobjekte mit der Länge 0 werden in den Parameterwert Ausgabe-Objekttabelle geschrieben. Dies ist die Standardeinstellung. Deaktiviert—Linienobjekte mit der Länge 0 werden nicht in den Parameterwert Ausgabe-Objekttabelle geschrieben.	Boolean
Alle Felder der Eingabe einbeziehen (Optional)	Gibt an, ob der Parameterwert Ausgabe-Objekttabelle die Routenpositionsfelder sowie alle Attribute aus dem Parameterwert Eingabe-Features enthält. Aktiviert—Der Parameterwert Ausgabe-Objekttabelle enthält die Routenpositionsfelder sowie alle Attribute aus dem Parameterwert Eingabe-Features. Dies ist die Standardeinstellung. Deaktiviert—Der Parameterwert Ausgabe-Objekttabelle enthält nur die Routenpositionsfelder sowie das Feld `ObjectID` aus dem Parameterwert Eingabe-Features.	Boolean
Versatz in M-Richtung verwenden (Optional)	Gibt an, ob der berechnete Versatzabstand auf der M-Richtung oder der Digitalisierrichtung basieren soll. Entfernungen sind im Parameterwert Ausgabe-Objekttabelle enthalten, wenn der Parameter Entfernungsfeld in Ausgabetabelle einbeziehen aktiviert wird. Aktiviert—Die Entfernungswerte im Parameterwert Ausgabe-Objekttabelle werden auf Grundlage der M-Richtung der Route berechnet. Eingabe-Features links von der M-Richtung der Route wird ein positiver Versatz (+) zugewiesen. Features rechts von der M-Richtung wird ein negativer Versatz (-) zugewiesen. Dies ist die Standardeinstellung. Deaktiviert—Die Entfernungswerte im Parameterwert Ausgabe-Objekttabelle werden auf Grundlage der Digitalisierrichtung der Route berechnet. Eingabe-Features links von der Digitalisierrichtung der Route wird ein negativer Versatz (-) zugewiesen. Features rechts von der Digitalisierrichtung wird ein positiver Versatz (+) zugewiesen.	Boolean

arcpy.lr.LocateFeaturesAlongRoutes(in_features, in_routes, route_id_field, radius_or_tolerance, out_table, out_event_properties, {route_locations}, {distance_field}, {zero_length_events}, {in_fields}, {m_direction_offsetting})

Name	Erläuterung	Datentyp
in_features	Die Features von Eingabepunkt, -linie oder -polygon.	Feature Layer
in_routes	Die Routen, mit denen der Parameterwert `in_features` überschnitten wird.	Feature Layer
route_id_field	Mit den in diesem Feld gespeicherten Werten werden die einzelnen Routen eindeutig gekennzeichnet. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein.	Field
radius_or_tolerance	Wenn als Parameterwert `in_features` Punkte angegeben sind, ist der Suchradius ein Zahlenwert. Er definiert, in welchem Radius um die Punkte eine Suche durchgeführt wird, um eine Zielroute zu ermitteln. Wenn als Parameterwert `in_features` Linien angegeben sind, ist die Suchtoleranz eine Cluster-Toleranz. Dies ist ein Zahlenwert, der für die maximal zulässige Entfernung zwischen den Eingabelinien und den Zielrouten steht. Wenn als Parameterwert `in_features` Polygone angegeben sind, wird dieser Parameter ignoriert und kein Suchradius verwendet.	Linear Unit
out_table	Die Tabelle, die erstellt wird. Die Ausgabetabelle kann eine dBASE-Datei (`.dbf`) oder eine Geodatabase-Tabelle sein.	Table
out_event_properties	Die Routenpositionsfelder und der in die Ausgabe-Objekttabelle zu schreibende Objekttyp. Route identifier field—Mit den Werten in diesem Feld wird angegeben, entlang welcher Route sich die einzelnen Objekte befinden. Das Feld kann ein numerisches Feld, ein Textfeld oder ein GUID-Feld sein. Event type—Der in der Ausgabe-Objekttabelle enthaltene Objekttyp (`POINT` oder `LINE`). `POINT`—Punktobjekte stellen eine exakte Position entlang einer Route dar. Es muss lediglich ein einzelnes Messwertfeld angegeben werden. `LINE`—Linienobjekte definieren einen Abschnitt einer Route. Die Von- und Bis-Messwert-Felder müssen angegeben werden. From-measure field—Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp `POINT` oder `LINE` festgelegt wurde. To-measure field—Ein Feld mit Messwerten. Dieses Feld ist erforderlich, wenn als Objekttyp `LINE` festgelegt wurde.	Route Measure Event Properties
route_locations (Optional)	Gibt an, ob die nächstgelegene Routenposition oder alle Routenpositionen innerhalb des Suchradius in den Parameterwert `out_table` geschrieben werden. Beim Lokalisieren von Punkten entlang von Routen besteht die Möglichkeit, dass mehrere Routen innerhalb des zu einem beliebigen Punkt festgelegten Suchradius liegen. Dieser Parameter wird ignoriert, wenn Linien oder Polygone entlang von Routen lokalisiert werden. `FIRST`—Nur die nächstgelegene Routenposition wird in den Parameterwert `out_table` geschrieben. Dies ist die Standardeinstellung. `ALL`—Alle Routenpositionen innerhalb des Suchradius werden in den Parameterwert `out_table` geschrieben.	Boolean
distance_field (Optional)	Gibt an, ob ein `DISTANCE`-Feld zum Parameterwert `out_table` hinzugefügt wird. Die Werte in diesem Feld übernehmen die Einheiten des angegebenen Suchradius. Dieser Parameter wird ignoriert, wenn Linien oder Polygone entlang von Routen lokalisiert werden. `DISTANCE`—Ein Feld, das die Entfernung von Punkt zu Route enthält, wird zum Parameterwert `out_table` hinzugefügt. Dies ist die Standardeinstellung. `NO_DISTANCE`—Ein Feld, das die Entfernung von Punkt zu Route enthält, wird nicht zum Parameterwert `out_table` hinzugefügt.	Boolean
zero_length_events (Optional)	Gibt an, ob Linienobjekte mit der Länge 0 in die Ausgabe geschrieben werden. Bei der Lokalisierung von Polygonen entlang von Routen können Objekte erstellt werden, in denen der Von-Messwert dem Nach-Messwert entspricht. Dieser Parameter wird ignoriert, wenn Punkte oder Linien entlang von Routen lokalisiert werden. `ZERO`—Linienobjekte mit der Länge 0 werden in den Parameterwert `out_table` geschrieben. Dies ist die Standardeinstellung. `NO_ZERO`—Linienobjekte mit der Länge 0 werden nicht in den Parameterwert `out_table` geschrieben.	Boolean
in_fields (Optional)	Gibt an, ob der Parameterwert `out_table` die Routenpositionsfelder sowie alle Attribute aus dem Parameterwert `in_features` enthält. `FIELDS`—Der Parameterwert `out_table` enthält die Routenpositionsfelder sowie alle Attribute aus dem Parameterwert `in_features`. Dies ist die Standardeinstellung. `NO_FIELDS`—Der Parameterwert `out_table` enthält nur die Routenpositionsfelder sowie das Feld `ObjectID` aus dem Parameterwert `in_features`.	Boolean
m_direction_offsetting (Optional)	Gibt an, ob der berechnete Versatzabstand auf der M-Richtung oder der Digitalisierrichtung basieren soll. Entfernungen sind im Parameterwert `out_table` enthalten, wenn der Parameter `distance_field` auf `DISTANCE` festgelegt wird. `M_DIRECTON`—Die Entfernungswerte im Parameterwert `out_table` werden auf Grundlage der M-Richtung der Route berechnet. Eingabe-Features links von der M-Richtung der Route wird ein positiver Versatz (+) zugewiesen. Features rechts von der M-Richtung wird ein negativer Versatz (-) zugewiesen. Dies ist die Standardeinstellung. `NO_M_DIRECTION`—Die Entfernungswerte im Parameterwert `out_table` werden auf Grundlage der Digitalisierrichtung der Route berechnet. Eingabe-Features links von der Digitalisierrichtung der Route wird ein negativer Versatz (-) zugewiesen. Features rechts von der Digitalisierrichtung wird ein positiver Versatz (+) zugewiesen.	Boolean

Codebeispiel

LocateFeaturesAlongRoutes: Beispiel 1 (Python-Fenster)

Mit dem folgenden Python-Skript wird veranschaulicht, wie die Funktion LocateFeaturesAlongRoutes im Python-Fenster verwendet wird.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.LocateFeaturesAlongRoutes("rail_segments.shp", "rail_routes.shp",
                                   "rkey", "0.5 Feet", "locate_lines",
                                   "rkey LINE fmp tmp")

LocateFeaturesAlongRoutes: Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion LocateFeaturesAlongRoutes in einem eigenständigen Python-Skript verwendet wird.

# Name: LocateFeaturesAlongRoutes_Example2.py
# Description: Locate shapefile lines along shapefile routes.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
feats = "rail_segments.shp"
rts = "rail_routes.shp"
rid = "rkey"
tol = "0.5 Feet"
tbl = "locate_lines"
props = "rkey LINE fmp tmp"

# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, tol, tbl, props)

LocateFeaturesAlongRoutes: Beispiel 3 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion LocateFeaturesAlongRoutes in einem eigenständigen Python-Skript mit File-Geodatabase-Daten verwendet wird.

# Name: LocateFeaturesAlongRoutes_Example3.py
# Description: Locate file geodatabase points along file geodatabase routes.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"

# Set local variables
feats = "rail/crossings"  # Crossings is in the rail feature dataset
rts = "rail/routes"  # Routes is in the rail feature dataset
rid = "rkey"
rad = "10 Feet"
tbl = "locate_points"
props = "rkey POINT mp"

# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, rad, tbl, props)

LocateFeaturesAlongRoutes: Beispiel 4 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion LocateFeaturesAlongRoutes in einem eigenständigen Python-Skript mit Enterprise-Geodatabase-Daten verwendet wird.

# Name: LocateFeaturesAlongRoutes_Example4.py
# Description: Locate enterprise geodatabase polygons along enterprise geodatabase routes.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
feats = arcpy.ValidateTableName("counties", wkspc)  # Stand-alone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc)  # Stand-alone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp"

# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, "#", tbl, props, "#", "#",
                                   "NO_ZERO", "M_DIRECTON")

Umgebungen

Aktueller Workspace, Ausgabe-CONFIG-Schlüsselwort, Ausdehnung, Scratch-Workspace

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja