| Beschriftung | Erläuterung | Datentyp |
Eingabe-Routen-Features | Das Zielnetzwerk, auf dem die Objekt-Layer dynamisch segmentiert werden. | Feature Layer |
Objekt-Layer | Die Objekt-Layer, die zusammen auf einem Zielnetzwerk dynamisch segmentiert werden. Der Mittelachsen-Layer kann als Eingabe verwendet werden, um Objekte dynamisch zu segmentieren. | Feature Layer |
Ausgabe-Dataset | Die Tabelle oder Feature-Class, die die Ausgabe-Objektdatensätze enthält, die erstellt werden. | Table |
Geometrie einbeziehen (optional) | Gibt an, ob für das Ausgabe-Dataset eine Objektgeometrie erstellt wird.
| Boolean |
Netzwerkfelder (optional) | Die Felder aus dem Netzwerk-Layer, die in die Ausgabe einbezogen werden. | Field |
Teilungstyp für Adressenblock (optional) | Gibt an, wie Adressenbereiche für jedes Segment der Ausgabe aktualisiert werden. Dieser Parameter ist nur verfügbar, wenn ein konfigurierter Adressenbereich-Layer als Eingabe-Layer verwendet wird.
| String |
Mit der Location Referencing-Lizenz verfügbar.
Zusammenfassung
Überlagert mindestens einen Linien- und Punkt-Objekt-Layer auf einem Zielnetzwerk und gibt eine Feature-Class oder Tabelle aus, die die dynamische Segmentierung der Eingaben darstellt.
Abbildung
Verwendung
Die folgende Tabelle zeigt die Ausgabe für das oben abgebildete Werkzeug:
Ausgabe (Objekte überlagern)
Typ Von-Messwert Bis-Messwert Linienobjekt 1 Linienobjekt 2 Punktobjekt Linie
0
2
A
1
<NULL>
Punkt
2
2
A
1
PE1
Linie
2
3
A
1
<NULL>
Linie
3
4
B
1
<NULL>
Linie
4
5
B
2
<NULL>
Die Parameterwerte für Objekt-Layer können entweder nur Linienobjekte sein oder sowohl Punkt- als auch Linienobjekte enthalten.
Der Parameter Objekt-Layer kann nur Event-Feature-Classes enthalten, die in einem LRS-Netzwerk registriert sind.
Hinweis:
- Die Centerline-Feature-Class kann als Eingabe für den Parameter Objekt-Layer dienen, um Objekte dynamisch zu segmentieren, wenn Sie Teil einer Address Data Management-Konfiguration oder einer ArcGIS Utility Network-Konfiguration sind. Wenn die Centerline-Feature-Class Teil einer Address Data Management-Konfiguration ist, wird die Richtung der Mittelachse in der Ausgabe berücksichtigt.
- Verwenden Sie in einer Address Data Management-Konfiguration das Werkzeug Address-Feature-Classes konfigurieren, um die Centerline-Feature-Class für die Verwendung mit einem LRS zu konfigurieren.
- Verwenden Sie in einer Utility Network-Konfiguration das Werkzeug Utility Network-Feature-Class konfigurieren, um die Centerline-Feature-Class für die Verwendung mit einem LRS zu konfigurieren.
Wenn der Eingabe-Layer Adressenbereichsfelder aus einer Address Data Management-Konfiguration enthält und als eine Address-Range-Feature-Class in einem LRS konfiguriert ist, werden die Werte in den Adressenbereichsfeldern für jedes Segment in der Ausgabe proportional aktualisiert, wenn der Parameterwert Teilungstyp für Adressenblock auf Proportional festgelegt ist. Wenn der Parameterwert Nächster Adresspunkt lautet, werden die Adressenbereiche für jedes Segment in der Ausgabe auf Grundlage der nächsten flussaufwärts oder flussabwärts gelegenen Adresspunkte aktualisiert.
Weitere Informationen zu Analysefunktionen in einem kombinierten LRS- und Adressenmanagement-Dataset
Wenn die Eingabeobjekt-Layer unterschiedliche lineare Referenzierungsmethoden (LRM) verwenden, werden sie mit dem LRM des Zielnetzwerks übersetzt.
Dieses Werkzeug unterstützt Auswahlsätze und Definitionsabfragen für die Parameterwerte Eingaberouten-Features und Objekt-Layer.
Hinweis:
Um alle mit den Eingaberouten verknüpften Objektdatensätze einzubeziehen, deaktivieren Sie die Umschaltflächen Ausgewählte Datensätze verwenden oder Gefilterte Datensätze verwenden für jeden Eingabeobjekt-Layer.
Dieses Werkzeug unterstützt Eingabeobjekt-Layer, die so konfiguriert sind, dass sie Objekte enthalten, die sich über mehrere Routen erstrecken. Die Ausgabe wird trotzdem mit dem Parameterwert Netzwerkfelder dynamisch auf Routenebene des Zielnetzwerks segmentiert.
Dieses Werkzeug unterstützt eine zeitliche Segmentierung (Zeitintervalle). Dies erfolgt standardmäßig und kann außer Kraft gesetzt werden, indem eine zeitbasierte Definitionsabfrage erstellt oder ein Auswahlsatz auf die Eingaben angewendet wird.
Dieses Werkzeug unterstützt die Aufnahme von mindestens einem Feld aus der Network-Feature-Class in die Ausgabe unter Verwendung des Parameters Netzwerkfelder.
Die Ausgabe kann als Tabelle oder als Feature-Class gespeichert werden.
Wenn die Ausgabe als Tabelle oder Feature-Class gespeichert wird, enthält die Ausgabe die folgenden Indizes und Felder:
Index Feld route_id
- Route_ID
rid_dates_measures
- Route_ID
- From_Date
- To_Date
- From_Measure
- To_Measure
Wenn mehr als ein LRS-Netzwerk in einer Utility Network-Konfiguration vorhanden ist, entsprechen die Kennzahlen für die Eingabeobjekt-Layer den in der zweiten Spalte der folgenden Tabelle aufgeführten Kennzahlen:
Wenn das LRS mit der Utility Network-Konfiguration das folgende Element enthält Gehören die Kennzahlen in der Pipeline-Line-Feature-Class zu Liniennetzwerk, Nicht-Liniennetzwerk
Liniennetzwerk
Liniennetzwerk
Liniennetzwerk
Mehr als ein Liniennetzwerk
Liniennetzwerk mit dem abgeleiteten Netzwerk
Mehr als ein Liniennetzwerk ohne ein abgeleitetes Netzwerk
Liniennetzwerk mit der niedrigsten Nummer in der Domäne mit codierten Werten dLRSNetworks
Mehr als ein Liniennetzwerk mit abgeleiteten Netzwerken
Liniennetzwerk mit der niedrigsten Nummer in der Domäne mit codierten Werten dLRSNetworks
Ein Nicht-Liniennetzwerk
Nicht-Liniennetzwerk
Mehr als ein Nicht-Liniennetzwerk
Netzwerk mit der niedrigsten Nummer in der Domäne mit codierten Werten dLRSNetworks
Dieses Werkzeug unterstützt physisch lückenhafte Routen und Objekte als Eingaberouten bzw. Eingabeobjekte.
Nur ein Objekt pro Layer kann sich auf einem Routensegment befinden. Für einen Layer mit dem Namen "Geschwindigkeitsbegrenzung" kann sich beispielsweise nur ein Objektdatensatz in diesem Layer auf diesem Segment befinden. Ein Segment kann mehrere Objekte aufweisen, jedes in einem eigenen Objekt-Layer. Verwenden Sie die ArcGIS Data Reviewer-Prüfung Ungültige Objektmesswerte, um Probleme mit Objektdaten zu ermitteln und zu beheben.
Wenn beim Ausführen dieses Werkzeug mit Daten aus einem Feature-Service Fehler auftreten oder der Vorgang länger als erwartet dauert, erhöhen Sie auf Service-Ebene die Größe für den Heapspeicher.
Parameter
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields}, {address_block_split_type})| Name | Erläuterung | Datentyp |
in_route_features | Das Zielnetzwerk, auf dem die Objekt-Layer dynamisch segmentiert werden. | Feature Layer |
event_layers [event_layers,...] | Die Objekt-Layer, die zusammen auf einem Zielnetzwerk dynamisch segmentiert werden. Der Mittelachsen-Layer kann als Eingabe verwendet werden, um Objekte dynamisch zu segmentieren. | Feature Layer |
output_dataset | Die Tabelle oder Feature-Class, die die Ausgabe-Objektdatensätze enthält, die erstellt werden. | Table |
include_geometry (optional) | Gibt an, ob der Parameterwert output_dataset eine Objektgeometrie enthält.
| Boolean |
network_fields [network_fields,...] (optional) | Die Felder aus dem Netzwerk-Layer, die in die Ausgabe einbezogen werden. | Field |
address_block_split_type (optional) | Gibt an, wie Adressenbereiche für jedes Segment der Ausgabe aktualisiert werden.
Dieser Parameter ist nur verfügbar, wenn ein konfigurierter Adressenbereich-Layer als Eingabe-Layer verwendet wird. | String |
Codebeispiel
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion OverlayEvents verwenden.
# Name: OverlayEvents_ex1.py
# Description: Overlays linear event feature layers against a target network and output a feature class or table that represents the dynamic segmentation of those inputs.
# Requirements: ArcGIS Location Referencing
# tool variables
in_route_features = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
event_layers = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRS\LRSE_Functional_Class"]
output_dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
network_fields = ""
address_block_split_type = ""
# Set current workspace
arcpy.env.workspace = r"C:\Data\NY_Data.gdb"
# Execute the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, Geometry, network_fields, address_block_split_type)Das folgende eigenständige Skript veranschaulicht, wie die Funktion OverlayEvents verwendet wird.
# Name: OverlayEvents_ex2.py
# Description: Overlay linear event feature layers against a target network then output a feature class or table that represents the dynamic segmentation of those inputs.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
# Local variables:
Network = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
Events = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRSE_Functional_Class"]
Output_Dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
Address_Block_Split_Type = ""
# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)
# Check in license
arcpy.CheckInExtension('LocationReferencing')Das folgende eigenständige Skript veranschaulicht, wie die Funktion OverlayEvents mit Daten in einem Feature-Service verwendet wird.
# Name: OverlayEvents_Pro_Ex3.py
# Description: Overlay events using a feature service. It is recommended to work in a version and post to the default version.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
#Input LRS network and events are in feature service. Portal sign in is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')
# Map the input LRS network and events from the feature service. Here, 1 corresponds to the input LRS network, while 2 and 3 corresponds to the input events.
in_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"
event1 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/2"
event2 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"
in_events = [event1, event2]
# Set tool variables
Output_Dataset = r"C:\Data\LocationReferencing.gdb\output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
Address_Block_Split_Type = ""
# Process: Overlay Events.
arcpy.locref.OverlayEvents(in_network, in_events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)
# Check in license
arcpy.CheckInExtension('LocationReferencing')Umgebungen
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)