| Beschriftung | Erläuterung | Datentyp |
Eingabe-Punkt-Layer | Die Punkte, die Linien zugeordnet werden. Die Eingabe muss ein Punkt-Layer mit aktivierten Zeiteigenschaften sein, der einen Zeitpunkt darstellt, und sie muss mindestens ein Feld enthalten, das eindeutige Tracks identifiziert. | Feature Set |
Eingabe-Linien-Layer | Die Linien, denen die Punkte zugeordnet werden. Die Eingabe muss Felder mit Werten enthalten, die die Von- und Zu-Knoten der Linie kennzeichnen. | Feature Set |
Anzahl | Die Feature-Class, die die zugeordneten Punkte enthält. | Feature Class |
Track-Felder | Ein oder mehrere Felder, die zum Identifizieren eindeutiger Tracks verwendet werden. | Field |
Der gewichtete Mittelwert in jedem Feld wird berechnet, wobei die angewendete Gewichtung die Proportion des zusammengefassten Layers innerhalb der Polygone ist. | Die maximal zulässige Entfernung zwischen einem Punkt und einer Linie, die noch als Übereinstimmung angesehen wird. Es wird empfohlen, Werte kleiner oder gleich 75 Meter zu verwenden. Größere Entfernungen führen zu einer längeren Verarbeitungszeit und zu weniger genauen Ergebnissen. | Linear Unit |
Konnektivitätsfeldzuordnung | Die Linien-Layer-Felder, die verwendet werden, um die Konnektivität der Eingabe-Linien-Features zu definieren.
| Value Table |
Einzubeziehende Linienfelder (optional) | Mindestens ein Feld aus dem Eingabe-Linien-Layer, das in das Ausgabeergebnis einbezogen wird. | Field |
Entfernungsmethode (optional) | Gibt die Methode an, die zum Berechnen der Entfernung zwischen Punkten und Linien verwendet wird.
| String |
Richtungswertzuordnung (optional) | Das Linien-Layer-Feld und die Attributwerte, mit denen die Richtung der Eingabe-Linien-Features definiert wird. Ein Linien-Layer enthält z. B. das Feld direction mit den Werten T (rückwärts), F (vorwärts), B (beide) und "" (keine). Wenn kein Wert angegeben ist, wird eine bidirektionale Linie angenommen.
| Value Table |
Ausgabemodus (optional) | Gibt an, ob alle Eingabe-Features oder nur die Eingabe-Features, die einem Linien-Feature zugeordnet wurden, zurückgegeben werden.
| String |
Zusammenfassung
Fängt Eingabe-Track-Punkte an Linien. Die Punktdaten mit aktivierten Zeiteigenschaften müssen Features einbeziehen, die einen Zeitpunkt darstellen. Für die Analyse sind passierbare Linien mit Feldern erforderlich, die die Von- und Zum-Knoten angeben.
Abbildung
Verwendung
In der folgenden Tabelle wird die Terminologie aufgeführt, die im Werkzeug Tracks fangen verwendet wird:
Begriff Beschreibung Track
Eine Sequenz aus Features mit aktivierten Zeiteigenschaften vom Typ "Zeitpunkt". Ob sich Features in einer Sequenz befinden, wird durch ein Track-Kennungsfeld und deren zeitliche Reihenfolge bestimmt. Nehmen wir als Beispiel eine Stadt mit einer Flotte aus Schneepflügen, die alle 30 Sekunden ihre Position aufzeichnen. Die unterschiedlichen Tracks können jeweils durch die Fahrzeug-ID identifiziert werden.
Beobachtung
Ein Punkt in einem Track.
Knoten
Knoten sind die Endstützpunkte von Linien-Features, die zur Angabe der Linienrichtung dienen. Der Linienbeginn ist der Von-Knoten, und das Linienende ist der Zum-Knoten.
Richtung
Die Richtung einer Linie. Richtung bezieht sich darauf, wie einer Linie zwischen Von-Knoten und Zum-Knoten gefolgt werden kann.
Konnektivität
Konnektivität beschreibt, wie Linien verbunden sind, um ein passierbares Netzwerk darzustellen. Linien werden basierend auf deren Werten für "Von Knoten" und "Zum Knoten" verbunden. Linien, die basierend auf der Konnektivität von einem Punkt nicht erreichbar sind, werden nicht als Übereinstimmung angesehen.
Durchlässig
Linien sind passierbar, wenn sie durch gemeinsame Knoten verbunden sind. Wenn der Von-Knoten der Linie A beispielsweise mit dem Zum-Knoten der Linie B identisch ist, sind sie passierbar.
Für das Werkzeug sind die folgenden Parameter-Eingabe-Layer erforderlich:
- Eingabe-Punkt-Layer: Der Eingabe-Layer muss Beobachtungen mit aktivierten Zeiteigenschaften enthalten, die einen Zeitpunkt darstellen. Track-Beobachtungen ohne gültigen Zeitstempel werden aus der Analyse ausgeschlossen.
- Eingabe-Linien-Layer: Der Eingabe-Linien-Layer muss Felder mit den folgenden Konnektivitätsinformationen enthalten und im Parameter Konnektivitätsfeldzuordnung angegeben werden:
- Eindeutige ID: Die eindeutige Kennung der Linie
- Von Knoten: Der Knoten, von dem sich die Bewegung entlang einer Linie entfernt
- Zum Knoten: Der Knoten, zu dem die Bewegung entlang einer Linie erfolgt
Der Raumbezug des Parameterwertes Eingabe-Punkt-Layer muss mit dem Raumbezug des Parameterwertes Eingabe-Linien-Layer identisch sein. Wenn die Datasets unterschiedliche Raumbezüge aufweisen, geben Sie mithilfe der Umgebung Ausgabe-Koordinatensystem den Raumbezug für die Analyse an, oder projizieren Sie die Datasets vor der Analyse.
Sie können ein oder mehrere Felder zum Identifizieren von Tracks angeben. Tracks werden durch die eindeutige Kombination aus mindestens einem Track-Feld dargestellt. Wenn beispielsweise die Felder flightID und Destination als Track-IDs verwendet werden, befinden sich die Features ID007, Solden und ID007, Tokyo in zwei getrennten Tracks, da sie verschiedene Werte für das Feld Destination aufweisen.
Tracks müssen mehr als eine Beobachtung aufweisen, damit sie in Analysen verwendet werden können. Tracks mit nur einer Beobachtung werden nicht zugeordnet.
Für Zuordnungen zwischen Punkten und Linien gelten die folgenden Überlegungen:
- Die Beobachtung liegt innerhalb der Suchentfernung von einer Linie. Dies ist die Mindestanforderung. Beobachtungen werden nicht zugeordnet, wenn sie die Bedingung der Suchentfernung nicht erfüllen.
- Die Beobachtung kann die Linien basierend auf deren Konnektivität passieren.
- Die Beobachtung bewegt sich in einer von der Linie unterstützten Richtung. Dies ist eine optionale Bedingung, die gilt, wenn Sie Werte für den Parameter Richtungswertzuordnung angeben. Ergebnisse, die diese optionale Bedingung erfüllen, sind genauer.
Verwenden Sie den Parameter Suchentfernung, um die maximal zulässige Entfernung zwischen einer Beobachtung und einer Linie anzugeben. Wenn Sie beispielsweise wissen, dass die Genauigkeit der GPS-Punkte etwa 100 Meter beträgt, geben Sie als Suchentfernung 100 Meter an.
Der Parameter Entfernungsmethode bestimmt, wie Suchentfernungen berechnet werden. Zwei Entfernungsmethoden sind verfügbar:
- Geodätisch: Wenn der Raumbezug kontinuierlich über den Antimeridian geschwenkt werden kann, überqueren Tracks ggf. den Antimeridian. Wenn der Raumbezug nicht kontinuierlich geschwenkt werden kann, sind die Tracks auf die Ausdehnung des Koordinatensystems beschränkt und werden nicht umbrochen. Dies ist die Standardeinstellung.
- Planar: Tracks überqueren den Antimeridian nicht. Verwenden Sie diese Option, wenn die Eingabedaten ein projiziertes Koordinatensystem nutzen.
Um zusätzliche Linienattribute in die Ausgabeergebnisse aufzunehmen, geben Sie die Feldnamen mit dem Parameter Einzubeziehende Linienfelder an. Diese Felder werden nicht für Analysen genutzt und nur für Ihre eigene Verwendung aufgenommen. Sie können in das Ausgabeergebnis keine Geometriefelder aufnehmen.
Definieren Sie mit dem Parameter Richtungswertzuordnung die unterstützten Richtungen für jedes Linien-Feature. Ein Linien-Layer enthält z. B. das Feld direction mit den Werten T (rückwärts), F (vorwärts), B (beide) und "" (keine). Die Richtungszuordnung ist optional, wird aber für genaue Ergebnisse empfohlen. Wenn keine Richtungszuordnung angegeben ist, wird eine bidirektionale Linie angenommen.
Das Werkzeug gibt Punkte zurück, die an der nächstgelegenen Position entlang der zugeordneten Linie gefangen werden. Die Linien-Features werden nicht zurückgegeben. Die eindeutige Kennung des Linien-Datasets ist für zugeordnete Ergebnisse verfügbar. Das eindeutige Kennungsfeld wird mit dem Parameter Konnektivitätsfeldzuordnung angegeben. Sie können die zugeordneten Linien durch Referenzieren dieses Feldes identifizieren.
Neben den Feldern aus dem Parameterwert Eingabe-Punkt-Layer und den mit dem Parameter Einzubeziehende Linienfelder angegebenen Linienfeldern werden die folgenden Felder in die Ausgabe aufgenommen:
Feldname Beschreibung MatchStatus
Gibt an, ob die Beobachtung einer Linie zugeordnet wurde. Die Werte sind M für zugeordnete Features und U für nicht zugeordnete Features.
OrigX
Die Z-Koordinate der Eingabe-Beobachtung. Koordinaten werden in den Einheiten des Ausgabe-Raumbezugs gespeichert.
OrigY
Die Y-Koordinate der Eingabe-Beobachtung. Koordinaten werden in den Einheiten des Ausgabe-Raumbezugs gespeichert.
MatchX
Die X-Koordinate des zugeordneten Ergebnisses auf der Linie. Koordinaten werden in den Einheiten des Ausgabe-Raumbezugs gespeichert.
MatchY
Die Y-Koordinate des zugeordneten Ergebnisses auf der Linie. Koordinaten werden in den Einheiten des Ausgabe-Raumbezugs gespeichert.
MatchDist
Die Entfernung zwischen der ursprünglichen Position und der zugeordneten Position für eine Beobachtung. Entfernungen werden basierend auf der ausgewählten Entfernungsmethode (geodätisch oder planar) berechnet. Die Werte werden in Meter aufgezeichnet.
DATE
Der Zeitstempel der Beobachtung.
Wenn der Parameterwert Ausgabemodus als Alle Features angegeben ist, werden zugeordnete und nicht zugeordnete Punkte zurückgegeben. Für nicht zugeordnete Punkte werden die Ausgabe-Ergebnisfelder für numerische Felder als NULL-Werte und für Zeichenfolgefelder als leere Zeichenfolge angehängt. Die Felder, die mit NULL-Werten angehängt werden, sind Felder, die unter Verwendung des Parameters Einzubeziehende Linienfelder und der Felder MatchX, MatchY sowie MatchDist angegeben wurden.
Ähnliche Analysen können auch mit Folgendem durchgeführt werden:
- Rekonstruieren Sie Track-Punkte mit aktivierten Zeiteigenschaften in Linien, indem Sie das Werkzeug Tracks rekonstruieren verwenden.
- Fangen Sie Punkte, Multipoints, Linien oder Polygone mit dem Werkzeug Fangen an anderen Features. Mit diesem Werkzeug werden die Eingabedaten geändert.
Dieses Geoverarbeitungswerkzeug wird unterstützt durch Spark. Bei Analysen auf Ihrem Desktop-Computer werden mehrere Kerne parallel verwendet. Weitere Informationen über die Ausführung der Analyse finden Sie unter Überlegungen zu GeoAnalytics Desktop-Werkzeugen.
Bei der Ausführung von GeoAnalytics Desktop-Werkzeugen wird die Analyse auf Ihrem Desktop-Computer durchgeführt. Für eine optimale Performance sollten die Daten auf Ihrem Desktop verfügbar sein. Wenn Sie einen gehosteten Feature-Layer verwenden, wird empfohlen, ArcGIS GeoAnalytics Server zu verwenden. Wenn Ihre Daten nicht lokal verfügbar sind, dauert die Ausführung eines Werkzeugs bedeutend länger. Informationen zur Verwendung von ArcGIS GeoAnalytics Server für Analysen finden Sie unter GeoAnalytics Tools.
Hinweis:
Lizenzierte StreetMap Premium-Geodatabase-Feature-Layer werden als Eingabe für ArcGIS Pro 3.0 nicht unterstützt
Parameter
arcpy.gapro.SnapTracks(input_points, input_lines, out_feature_class, track_fields, search_distance, connectivity_field_matching, {line_fields_to_include}, {distance_method}, {direction_value_matching}, {output_mode})| Name | Erläuterung | Datentyp |
input_points | Die Punkte, die Linien zugeordnet werden. Die Eingabe muss ein Punkt-Layer mit aktivierten Zeiteigenschaften sein, der einen Zeitpunkt darstellt, und sie muss mindestens ein Feld enthalten, das eindeutige Tracks identifiziert. | Feature Set |
input_lines | Die Linien, denen die Punkte zugeordnet werden. Die Eingabe muss Felder mit Werten enthalten, die die Von- und Zu-Knoten der Linie kennzeichnen. | Feature Set |
out_feature_class | Die Feature-Class, die die zugeordneten Punkte enthält. | Feature Class |
track_fields [track_fields,...] | Ein oder mehrere Felder, die zum Identifizieren eindeutiger Tracks verwendet werden. | Field |
search_distance | Die maximal zulässige Entfernung zwischen einem Punkt und einer Linie, die noch als Übereinstimmung angesehen wird. Es wird empfohlen, Werte kleiner oder gleich 75 Meter zu verwenden. Größere Entfernungen führen zu einer längeren Verarbeitungszeit und zu weniger genauen Ergebnissen. | Linear Unit |
connectivity_field_matching [connectivity_field_matching,...] | Die Linien-Layer-Felder, die verwendet werden, um die Konnektivität der Eingabe-Linien-Features zu definieren.
| Value Table |
line_fields_to_include [line_fields_to_include,...] (optional) | Mindestens ein Feld aus dem Eingabe-Linien-Layer, das in das Ausgabeergebnis einbezogen wird. | Field |
distance_method (optional) | Gibt die Methode an, die zum Berechnen der Entfernung zwischen Punkten und Linien verwendet wird.
| String |
direction_value_matching [direction_value_matching,...] (optional) | Das Linien-Layer-Feld und die Attributwerte, mit denen die Richtung der Eingabe-Linien-Features definiert wird. Ein Linien-Layer enthält z. B. das Feld direction mit den Werten T (rückwärts), F (vorwärts), B (beide) und "" (keine). Wenn kein Wert angegeben ist, wird eine bidirektionale Linie angenommen.
| Value Table |
output_mode (optional) | Gibt an, ob alle Eingabe-Features oder nur die Eingabe-Features, die einem Linien-Feature zugeordnet wurden, zurückgegeben werden.
| String |
Codebeispiel
Das folgende eigenständige Skript veranschaulicht, wie die Funktion SnapTracks verwendet wird.
# Name: SnapTracks.py
# Description: Snap snowplow fleet tracks to roads to uncover areas that
# may need more resources for snow removal efforts
# Import system modules
import arcpy
# Enable time on the input features using a .lyrx file.
# To create the .lyrx file, add your layer to a map, open the layer properties
# and enable time. Then right-click the layer and select Share As Layer File.
inputLyrx = r'C:\data\Snowplow.lyrx'
# MakeFeatureLayer converts the .lyrx to features
snowplowsLayer = arcpy.MakeFeatureLayer_management(inputLyrx, "Snowplows Layer")
# ApplySymbologyFromLayer sets the time using the .lyrx file definition
arcpy.ApplySymbologyFromLayer_management(snowplowsLayer, inputLyrx)
# Set local variables
lineLayer = "c:/mydata/Roads.gdb/CityStreets"
trackIdentifier = "vehicle_id"
out = "c:/mydata/OutputDatasets.gdb/Snowplows_snapped_to_streets"
searchDistance = "10 Meters"
connectivityFieldMatching = "unique_ID from_node to_node"
directionValueMatching = "dir_travel F T B #"
# Run Snap Tracks
arcpy.gapro.SnapTracks(snowplowsLayer, lineLayer, out, trackIdentifier,
searchDistance, connectivityFieldMatching, None,
"GEODESIC", directionValueMatching, "MATCHED_FEATURES")Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Nein
- Advanced: Ja