Tracks fangen (GeoAnalytics)

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

Es werden Track-Punkte mit aktivierten Zeiteigenschaften dargestellt, die Linien zugeordnet wurden.

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

Hinweis:

Lizenzierte StreetMap Premium-Geodatabase-Feature-Layer werden als Eingabe für ArcGIS Pro 3.0 nicht unterstützt

• 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 Eingabe-Punkt-Layer und den angegebenen Feldern werden die folgenden Felder zur Ausgabe hinzugefügt:

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

• Wenn Sie einen oder mehrere der folgenden Schritte durchführen, können Sie die Performance des Werkzeugs Tracks fangen verbessern:

  • Verwenden Sie einen kleineren Wert für den Parameter Suchentfernung, damit weniger Punkt- und Linienpaare für den Abgleich berücksichtigt werden. Es wird empfohlen, einen Wert kleiner oder gleich 75 Meter zu verwenden.
  • Verwenden Sie den Parameter Richtungswertzuordnung, damit Linien nur Punkten zugeordnet werden, die sich in der von der Linie unterstützten Richtung bewegen.
  • Verwenden Sie eine Auswahl relevanter Tracks statt des vollständigen Track-Datasets.
  • Geben Sie weniger Felder für den Parameter Einzubeziehende Linienfelder an.
  • Legen Sie die Umgebung Ausdehnung so fest, dass nur Daten von Interesse analysiert werden.
  • Verwenden Sie anstelle der Methode "Geodätisch" die Entfernungsmethode "Planar".
  • Verwenden Sie lokale Daten an der Stelle, an der die Analyse ausgeführt wird.

• Ä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 ArcGIS GeoAnalytics Server. Die Analyse wird auf dem GeoAnalytics Server ausgeführt, und die Ergebnisse werden in den eigenen Inhalten in ArcGIS Enterprise gespeichert.

• Bei der Ausführung von GeoAnalytics Server-Werkzeugen wird die Analyse auf dem GeoAnalytics Server abgeschlossen. Für eine optimale Performance sollten die Daten dem GeoAnalytics Server über Feature-Layer zur Verfügung stehen, die auf Ihrem ArcGIS Enterprise-Portal gehostet werden. Alternativ können Big-Data-Dateifreigaben verwendet werden. Daten, auf die der GeoAnalytics Server nicht lokal zugreifen kann, werden vor Analysebeginn auf den GeoAnalytics Server verschoben. Dadurch dauert die Ausführung eines Werkzeugs länger. Es kann zudem vorkommen, dass das Verschieben der Daten von ArcGIS Pro zum GeoAnalytics Server fehlschlägt. Die Wahrscheinlichkeit eines Fehlers hängt dabei von der Netzwerkgeschwindigkeit sowie der Größe und Komplexität der Daten ab. Es wird empfohlen, dass Sie Ihre Daten stets freigeben oder eine Big-Data-Dateifreigabe erstellen.

  Weitere Informationen zum Freigeben von Daten in Ihrem Portal

  Weitere Informationen zum Erstellen einer Big-Data-Dateifreigabe über Server Manager

Parameter

Dialogfeld

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
Ausgabename	Der Name des Ausgabe-Feature-Service.	String
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. Eindeutige ID: Das Linien-Layer-Feld, das den eindeutigen ID-Wert für jedes Linien-Feature enthält. Von Knoten: Das Linien-Layer-Feld, das die Werte für "Von Knoten" enthält. Zum Knoten: Das Linien-Layer-Feld, das die Werte für "Zum Knoten" enthält.	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. Geodätisch—Geodätische Entfernungen werden berechnet. Dies ist die Standardeinstellung. Planar—Planare Entfernungen werden berechnet.	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. Richtungsfeld: Das Feld des Linien-Layers, das die Richtung der Bewegung beschreibt. Wert "Vorwärts": Der Wert aus dem Richtungsfeld, der angibt, das die unterstützte Bewegungsrichtung vorwärts entlang einer Linie ist. Wert "Rückwärts": Der Wert aus dem Richtungsfeld, der angibt, das die unterstützte Bewegungsrichtung rückwärts entlang einer Linie ist. Wert "Beide": Der Wert aus dem Richtungsfeld, der angibt, das die Bewegungsrichtungen vorwärts und rückwärts entlang einer Linie unterstützt werden. Wert "Keine": Der Wert aus dem Richtungsfeld, der angibt, das es keine unterstützten Bewegungsrichtungen entlang einer Linie gibt.	Value Table
Ausgabemodus (optional)	Gibt an, ob alle Eingabe-Features oder nur die Eingabe-Features, die einem Linien-Feature zugeordnet wurden, zurückgegeben werden. Alle Features—Alle Eingabe-Punkt-Features werden unabhängig davon zurückgegeben, ob sie einem Linien-Feature zugeordnet wurden. Dies ist die Standardeinstellung. Zugeordnete Features—Nur Eingabe-Punkt-Features, die einem Linien-Feature zugeordnet wurden, werden zurückgegeben.	String
Data Store (optional)	Gibt den ArcGIS Data Store für das Speichern der Ausgabe an. Die Standardvorgabe ist der Big Data Store vom Typ "spatiotemporal". Alle in einem Big Data Store vom Typ "spatiotemporal" gespeicherten Ergebnisse werden im WGS84 gespeichert. Ergebnisse, die in einem Data Store vom Typ "relational" gespeichert werden, behalten ihr Koordinatensystem bei. Big Data Store vom Typ "spatiotemporal"—Die Ausgabe wird in einem Big Data Store vom Typ "spatiotemporal" gespeichert. Dies ist die Standardeinstellung. Data Store vom Typ "relational"—Die Ausgabe wird in einem Data Store vom Typ "relational" gespeichert.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Anzahl	Die Ausgabepunkte.	Feature Set

Python

arcpy.geoanalytics.SnapTracks(input_points, input_lines, output_name, track_fields, search_distance, connectivity_field_matching, {line_fields_to_include}, {distance_method}, {direction_value_matching}, {output_mode}, {data_store})

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
output_name	Der Name des Ausgabe-Feature-Service.	String
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. Eindeutige ID: Das Linien-Layer-Feld, das den eindeutigen ID-Wert für jedes Linien-Feature enthält. Von Knoten: Das Linien-Layer-Feld, das die Werte für "Von Knoten" enthält. Zum Knoten: Das Linien-Layer-Feld, das die Werte für "Zum Knoten" enthält.	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. GEODESIC—Geodätische Entfernungen werden berechnet. PLANAR—Planare Entfernungen werden berechnet.	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. Richtungsfeld: Das Feld des Linien-Layers, das die Richtung der Bewegung beschreibt. Wert "Vorwärts": Der Wert aus dem Richtungsfeld, der angibt, das die unterstützte Bewegungsrichtung vorwärts entlang einer Linie ist. Wert "Rückwärts": Der Wert aus dem Richtungsfeld, der angibt, das die unterstützte Bewegungsrichtung rückwärts entlang einer Linie ist. Wert "Beide": Der Wert aus dem Richtungsfeld, der angibt, das die Bewegungsrichtungen vorwärts und rückwärts entlang einer Linie unterstützt werden. Wert "Keine": Der Wert aus dem Richtungsfeld, der angibt, das es keine unterstützten Bewegungsrichtungen entlang einer Linie gibt.	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. ALL_FEATURES—Alle Eingabe-Punkt-Features werden unabhängig davon zurückgegeben, ob sie einem Linien-Feature zugeordnet wurden. Dies ist die Standardeinstellung. MATCHED_FEATURES—Nur Eingabe-Punkt-Features, die einem Linien-Feature zugeordnet wurden, werden zurückgegeben.	String
data_store (optional)	Gibt den ArcGIS Data Store für das Speichern der Ausgabe an. Die Standardeinstellung ist SPATIOTEMPORAL_DATA_STORE. Alle in einem Big Data Store vom Typ "spatiotemporal" gespeicherten Ergebnisse werden im WGS84 gespeichert. Ergebnisse, die in einem Data Store vom Typ "relational" gespeichert werden, behalten ihr Koordinatensystem bei. SPATIOTEMPORAL_DATA_STORE—Die Ausgabe wird in einem Big Data Store vom Typ "spatiotemporal" gespeichert. Dies ist die Standardeinstellung. RELATIONAL_DATA_STORE—Die Ausgabe wird in einem Data Store vom Typ "relational" gespeichert.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
output	Die Ausgabepunkte.	Feature Set

Codebeispiel

Tracks fangen – Beispiel 1 (eigenständiges Skript)

Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion SnapTracks verwenden.

# Name: SnapTracks.py
# Description: Snap delivery vehicle GPS crumbs to a street dataset.

# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
tracksLayer = "https://sampleserver.arcgisonline.com/arcgis/rest/services/DeliveryTrucks/MapServer/0"
lineLayer = "https://sampleserver.arcgisonline.com/arcgis/rest/services/CityStreets/MapServer/0"
trackIdentifier = "vehicle_id"
out = "trucks_snapped_to_streets"
searchDistance = "30 Feet"
connectivityFieldMatching = "unique_ID from_node to_node"
directionValueMatching = "dir_travel F T B #"

# Run Snap Tracks
arcpy.geoanalytics.SnapTracks(tracksLayer, lineLayer, out, trackIdentifier, 
                       searchDistance, connectivityFieldMatching, None,
																							"GEODESIC", directionValueMatching, "MATCHED_FEATURES", 
                       "SPATIOTEMPORAL_DATA_STORE")

Umgebungen

Ausgabe-Koordinatensystem, Ausdehnung, Aktueller Workspace

Sonderfälle

Ausgabe-Koordinatensystem

Das Koordinatensystem, das für die Analyse verwendet wird. Die Analyse wird im Eingabe-Koordinatensystem ausgeführt, sofern nicht anders durch diesen Parameter angegeben. Für GeoAnalytics Tools werden die Endergebnisse im Data Store vom Typ "spatiotemporal" in WGS84 gespeichert.

Lizenzinformationen

• Basic: Erfordert ArcGIS GeoAnalytics Server
• Standard: Erfordert ArcGIS GeoAnalytics Server
• Advanced: Erfordert ArcGIS GeoAnalytics Server