Verfolgt Ereignisse, die räumlich (Position) und zeitlich nahe beieinander liegen. Die Punktdaten mit aktivierten Zeiteigenschaften müssen Features einbeziehen, die einen Zeitpunkt darstellen.
Abbildung
Es wird ein Beispiel für verfolgte Ereignisse (orangefarbene Kreise) und Tracks (rote Kreise) gezeigt.
Verwendung
Die folgenden Anwendungsbeispiele zeigen, wie das Werkzeug Ereignisse in der Nähe verfolgen verwendet wird:
Eine Organisation überwacht vom Unternehmen ausgegebene Geräte, die von den Mitarbeitern mitgeführt werden. Das Unternehmen möchte feststellen, welche Mitarbeiter sich in der Nähe einer Person befanden, von der bekannt ist, dass sie sich mit dem Coronavirus (COVID-19) infiziert hat. Mithilfe des Punkt-Layers, der die Gerätepositionen und Zeitangaben repräsentiert, kann es alle Geräte identifizieren, die sich mindestens fünf Minuten lang in einem Umkreis von sechs Metern von der ansteckenden Person und anderen möglicherweise ansteckenden Mitarbeitern befunden haben.
Eine NGO überwacht Lachsbestände per GPS und möchte die Ausbreitung von Lachsläusen bei entkommenen Zuchtlachsen und wild lebenden Populationen verfolgen. Einige mit GPS-Koordinaten gekennzeichnete Zuchtlachse werden verfolgt, um festzustellen, ob sie in unmittelbare Nähe von gekennzeichneten Wildpopulationen kommen, und wie diese Wildpopulationen die Krankheit möglicherweise weiterverbreiten. Diese Messungen beinhalten ebenfalls ein Feld für die Tiefe, mit dessen Hilfe die NGO Fische ermittelt, die in einer ähnlichen Tiefe vorkommen.
In Zusammenhang mit dem Werkzeug Ereignisse in der Nähe verfolgen wird folgende Terminologie verwendet:
Entität: Ein Objekt, dessen Position regelmäßig erfasst wird, zum Beispiel ein Tier, eine Person oder ein Fahrzeug. Eine Entität kann stationär oder beweglich sein.
Relevante Entitäten: Die jeweiligen Entitäten, für die eine Verfolgung durchgeführt wird, zum Beispiel eine Person, die mit COVID-19 infiziert ist.
Ereignis in der Nähe: Der Zeitraum, in dem sich zwei Entitäten nahe beieinander befinden. Zum Beispiel zwei Personen, die innerhalb eines Zeitfensters von 1 Minute höchstens 3 Meter voneinander entfernt sind.
Tiefe: Der Grad der Trennung zwischen einer relevanten Entität und einer Entität, die sich weiter unten in der Verfolgung befindet (flussabwärts). Bei einem Ereignis in der Nähe zwischen der relevanten Entität und einer anderen Person zum Beispiel, beträgt die Tiefe 1.
Verfolgtes Ereignis: Der erste Kontakt einer angegebenen Entität unterhalb (flussabwärts) der relevanten Entitäten.
Die folgenden Diagramme zeigen, wie die Daten mit dem Werkzeug Ereignisse in der Nähe verfolgen verarbeitet werden. In diesen Diagrammen wird die Zeit auf der X-Achse dargestellt.
Jedes Diagramm enthält vier Entitäten: A, B, C und D. Im hervorgehobenen Text werden die verfolgten Ereignisse, die zwischen zwei Entitäten (der Von- und Zu-Entität) auftreten, sowie die Tiefe des Ereignisses in der Nähe beschrieben. In diesem Beispiel ist Entität C die relevante Entität, die flussabwärts verfolgt wird.
In Diagramm 1 ist Entität C die ausgewählte relevante Entität. Die Tiefe ist 0.
In Diagramm 2 tritt ein Ereignis in der Nähe zwischen den Entitäten C und B auf. Die Tiefe der Verfolgung ist 1. Wenn mehrere Features aufeinanderfolgende Ereignisse in der Nähe darstellen, handelt es sich um ein anhaltendes Ereignis in der Nähe.
In Diagramm 3 tritt ein Ereignis in der Nähe zwischen den Entitäten B und A auf. Die Tiefe der Verfolgung ist 2.
In Diagramm 4 tritt ein Ereignis in der Nähe zwischen den Entitäten C und D auf. Die Tiefe der Verfolgung ist 1.
In der folgenden Abbildung ist Entität B die relevante Entität, die dreimal in die Nähe von Entität A kommt, was durch die blauen Kreise gekennzeichnet ist. Unter der Annahme, dass die Zeit auf der X-Achse dargestellt wird, handelt es sich bei dem ersten nahegelegenen Ereignis um 1, gefolgt von einer Pause ohne Kontakt; anschließend erfolgen die nahegelegenen Ereignissen 2 und 3. Das Werkzeug gibt Ereignis 1 als das verfolgte Ereignis zurück. Die nahegelegenen Ereignisse 2 und 3 werden im Parameter-Layer Ausgabe für Ereignisse in der Nähe nicht zurückgegeben. Sämtliche Features nach dem nahegelegenen Ereignis 1 werden mit dem Parameter Ausgabe-Tracks zurückgegeben.
Features müssen die beiden Parameter-Kriterien Räumliche Suchentfernung und Zeitliche Suchentfernung erfüllen, damit sie als nahe beieinander gelten.
Abbildung A: Die beiden Features befinden sich innerhalb einer räumlichen Suchentfernung voneinander.
Abbildung B: Die beiden Features befinden sich innerhalb einer zeitlichen Entfernung (zeitliche Suchentfernung) voneinander.
Bei Angabe einer größeren zeitlichen und räumlichen Suchentfernung werden mehr Ereignisse gefunden, und die Verarbeitung der Ergebnisse dauert länger. Geringere Entfernungen haben weniger Ereignisse und eine kürzere Verarbeitungszeit zur Folge.
Nutzen Sie Ihre domänenspezifischen Kenntnisse, um die Werte für die Parameter Räumliche Suchentfernung und Zeitliche Suchentfernung zu bestimmen. Berücksichtigen Sie bei der Festlegung der Entfernungen Faktoren wie die Genauigkeit des Geräts.
Der Parameter Relevante Entitäten definieren mit unterstützt die folgenden Optionen:
IDs relevanter Entitäten: Mit dieser Option wird der Parameter IDs relevanter Entitäten aktiviert, für den Entitäts-ID-Werte und optional auch Beginnend bei-Zeitwerte für den Start der Verfolgung angegeben werden müssen.
Ausgewählte Features in einem angegebenen Layer relevanter Entitäten: Mit dieser Option wird der Parameter Layer relevanter Entitäten aktiviert, der Ihnen die Möglichkeit bietet, einen Layer auszuwählen, der Entitäts-IDs und optional auch Zeiten für den Start der Verfolgung auszuwählen. Bei diesem Layer muss der Name des Entitäts-ID-Feldes mit dem Namen des Entitäts-ID-Feldes aus dem Eingabe-Layer übereinstimmen. Wenn für den Layer Zeiteigenschaften aktiviert wurden, wird die Zeit für diesen berücksichtigt.
Die entfernungsbasierte Verfolgung beginnt bei der relevanten Entität. Wenn Sie eine Startzeit angeben, beginnt die Verfolgung für die betreffende Entität zu dieser Uhrzeit. Wenn Sie keine Uhrzeit angeben, beginnt die Verfolgung für die betreffende Entität am 1. Januar 1970.
Sie können für ein Ereignis in der Nähe zusätzliche Anforderungen festlegen. Beispielsweise können Sie ausschließlich Personen in einem bestimmten Gebäude auf einem Campus verfolgen, oder Sie können die Verfolgung nur auf eine Ebene eines Gebäudes beschränken. Verwenden Sie den Parameter Kriterien für Attributabgleich, um einschränkende Attribute anzugeben. Um zum Beispiel die Entitäten auf ein Stockwerk zu beschränken, geben Sie das Feld Floor an.
Der Layer Ausgabe für Ereignisse in der Nähe enthält das erste nahegelegene Ereignis für die verfolgten Entitäten sowie die folgenden Felder:
from_id: Die ID der flussaufwärts liegenden Entität.
to_id: Die ID der flussabwärts liegenden Entität.
depth: Der Grad der Trennung zwischen der relevanten Entität und dem Feld to_id.
duration_minutes: Die Dauer des verfolgten Ereignisses in Minuten. Für dieses Feld wird die Differenz zwischen der Start- und Endzeit berechnet. 1,5 Minuten sind zum Beispiel 90 Sekunden. Ein Wert von 0 bedeutet, dass es ein einziges Ereignis in der Nähe gibt (dieselbe Start- und Endzeit).
instant_datetime: Datum und Uhrzeit des Ereignisses in der Nähe. Dieses Feld wird als die erste erfasste Zeit berechnet, die die Kriterien des Ereignisses in der Nähe erfüllt.
Sie können den optionalen Parameter Ausgabe-Tracks verwenden, um einen Layer zu erstellen, der das erste verfolgte Ereignis und alle nachfolgenden Features für die betreffende Entität enthält. Diese Ergebnisse sind hilfreich, um zu visualisieren, wohin Entitäten sich bewegt haben, und sie können mit dem Werkzeug Tracks rekonstruieren verwendet werden. Der Parameter Ausgabe-Tracks beinhaltet die folgenden Felder:
entity_id: Die Entitäts-ID.
depth: Der Grad der Trennung zwischen der relevanten Entität und dem Verfolgungs-Track. Die Tiefe wird bei einem einzelnen Track beibehalten.
date: Das Datum der einzelnen Features. Dieses Datum stimmt mit dem Datensatz aus den Eingabe-Features überein.
Eingabe-Punkte, die nicht über Zeitwerte, Geometriewerte oder ein Entitäts-ID-Feld verfügen, sind nicht in den Ergebnissen enthalten.
Wenn Sie die entfernungsbasierte Verfolgung nutzen, um die Übertragung (z. B. einer Krankheit) zu finden, achten Sie auf folgende Punkte:
Das Vorhandensein eines verfolgten Ereignisses garantiert nicht, dass eine Übertragung stattgefunden hat. Es handelt sich nur um eine potenzielle Begegnung.
Das Fehlen eines verfolgten Ereignisses bedeutet nicht, dass keine Übertragung stattgefunden hat. In Fällen wie z. B. einer Krankheit können andere Übertragungsmöglichkeiten nicht ausgeschlossen werden.
Verwenden Sie möglichst den Parameter Kriterien für Attributabgleich, um nahegelegene Ereignisse bei Bedarf einzuschränken. Verwenden Sie beispielsweise Attribute, um den Raum, die Etage oder die Höhe einzuschränken.
Wenn Sie sämtliche Ereignisse in der Nähe berechnen möchten und nicht an einer Verfolgung flussabwärts von einer relevanten Entität interessiert sind, verwenden Sie das Werkzeug Features verbinden.
Wenn Sie einen oder mehrere der folgenden Schritte durchführen, können Sie die Performance des Werkzeugs Ereignisse in der Nähe verfolgen verbessern:
Verwenden Sie für die Parameter Räumliche Suchentfernung und Zeitliche Suchentfernung kleinere Werte.
Schränken Sie die relevanten Entitäten mit dem Parameter Kriterien für Attributabgleich ein.
Geben Sie einen Wert für den Parameter Maximale Verfolgungstiefe an, um die Anzahl der Verfolgungen flussabwärts für eine bestimmte Entität und die relevante Entität zu begrenzen.
Legen Sie die Ausdehnungsumgebung so fest, dass nur die gewünschten Daten analysiert werden.
Verwenden Sie lokale Daten an der Stelle, an der die Analyse ausgeführt wird.
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.
Die Point-Feature-Class mit aktivierten Zeiteigenschaften, die für die Verfolgung von Ereignissen in der Nähe verwendet wird.
Feature Set
Entitäts-ID-Feld
Das Textfeld, in dem die eindeutige ID der einzelnen Entitäten angegeben wird.
Field
Ausgabename
Der Name des Ausgabe-Feature-Service.
String
Entfernungsmethode
Gibt den Entfernungstyp an, der für den Parameter Räumliche Suchentfernung verwendet wird.
Planar—Zwischen Features wird die planare Entfernung verwendet. Dies ist die Standardeinstellung.
Geodätisch—Zwischen den Features wird die geodätische Entfernung verwendet. Bei diesem Linientyp wird die Krümmung des Sphäroiden berücksichtigt und die Daten in der Nähe der Datumsgrenze und der Pole werden richtig verarbeitet.
String
Räumliche Suchentfernung
(optional)
Die maximale Entfernung zwischen zwei Punkten, die als in der Nähe betrachtet werden sollen. Features innerhalb der räumlichen und der zeitlichen Suchentfernung gelten als nahe beieinander.
Linear Unit
Zeitliche Suchentfernung
(optional)
Die maximale Dauer zwischen zwei Punkten, die als in der Nähe betrachtet werden sollen. Features innerhalb der zeitlichen Suchentfernung, die die Kriterien für die räumliche Suchentfernung erfüllen, gelten als nahe beieinander.
Time Unit
Relevante Entitäten definieren mit
Gibt die relevanten Entitäten an.
IDs relevanter Entitäten—Entitätsnamen und Zeiten werden als relevante Entitäten verwendet. Dies ist die Standardeinstellung.
Ausgewählte Features in einem angegebenen Layer relevanter Entitäten—Das ausgewählte Feature in einem angegebenen Layer relevanter Entitäten wird als relevante Entitäten verwendet.
String
IDs relevanter Entitäten
Die Entitätsnamen und Startzeiten für die relevanten Entitäten. Dieser Parameter wird nur unterstützt, wenn IDs relevanter Entitäten für den Parameter Relevante Entitäten definieren mit angegeben wird.
Entitäts-ID: Ein eindeutiger Entitätsname. Die Namen müssen Zeichenfolgen sein, und es muss die Groß-/Kleinschreibung beachtet werden.
Beginnend bei: Eine optionale Startzeit für die Verfolgung einer relevanten Entität. Ohne Angabe der Zeit wird der 1. Januar 1970 verwendet.
Value Table
Layer relevanter Entitäten
Der Layer oder die Tabelle mit den relevanten Entitäten. Dieser Parameter wird nur unterstützt, wenn Ausgewählte Features in einem angegebenen Layer relevanter Entitäten für den Parameter Relevante Entitäten definieren mit angegeben wird.
Record Set
Ausgabe-Tracks
(optional)
Gibt an, ob ein Ausgabe-Layer erstellt wird, der das erste verfolgte Ereignis und alle nachfolgenden Features für die betreffende Entität enthält.
Aktiviert: Es wird ein Ausgabe-Layer erstellt, der das erste verfolgte Ereignis und alle nachfolgenden Features enthält.
Nicht aktiviert: Es wird kein Ausgabe-Layer erstellt, der das erste verfolgte Ereignis und alle nachfolgenden Features enthält. Dies ist die Standardeinstellung.
Boolean
Maximale Verfolgungstiefe
Der maximale Grad der Trennung zwischen einer relevanten Entität und einer Entität, die sich weiter unten (flussabwärts) in der Verfolgung befindet.
Long
Kriterien für Attributabgleich
(optional)
Die Felder, mit denen das Ereignis in der Nähe eingeschränkt wird.
Field
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
Ausgabe für Ereignisse in der Nähe
Der Layer, der die Ereignisse in der Nähe enthält, die verfolgt werden.
Feature Set
Ausgabe-Tracks
Der optionale Layer, der das erste verfolgte Ereignis in den Tracks und alle nachfolgenden Features enthält.
Die Point-Feature-Class mit aktivierten Zeiteigenschaften, die für die Verfolgung von Ereignissen in der Nähe verwendet wird.
Feature Set
entity_id_field
Das Textfeld, in dem die eindeutige ID der einzelnen Entitäten angegeben wird.
Field
output_name
Der Name des Ausgabe-Feature-Service.
String
distance_method
Gibt den Entfernungstyp an, der für den Parameter Räumliche Suchentfernung verwendet wird.
PLANAR—Zwischen Features wird die planare Entfernung verwendet. Dies ist die Standardeinstellung.
GEODESIC—Zwischen den Features wird die geodätische Entfernung verwendet. Bei diesem Linientyp wird die Krümmung des Sphäroiden berücksichtigt und die Daten in der Nähe der Datumsgrenze und der Pole werden richtig verarbeitet.
String
spatial_search_distance
(optional)
Die maximale Entfernung zwischen zwei Punkten, die als in der Nähe betrachtet werden sollen. Features innerhalb der räumlichen und der zeitlichen Suchentfernung gelten als nahe beieinander.
Linear Unit
temporal_search_distance
(optional)
Die maximale Dauer zwischen zwei Punkten, die als in der Nähe betrachtet werden sollen. Features innerhalb der zeitlichen Suchentfernung, die die Kriterien für die räumliche Suchentfernung erfüllen, gelten als nahe beieinander.
Time Unit
entities_of_interest_input_type
Gibt die relevanten Entitäten an.
ID_START_TIME—Entitätsnamen und Zeiten werden als relevante Entitäten verwendet. Dies ist die Standardeinstellung.
SELECTED_FEATURE—Das ausgewählte Feature in einem angegebenen Layer relevanter Entitäten wird als relevante Entitäten verwendet.
String
entities_interest_ids
[entities_interest_ids,...]
Die Entitätsnamen und Startzeiten für die relevanten Entitäten. Dieser Parameter wird nur unterstützt, wenn ID_START_TIME für den Parameter entities_of_interest_input_type angegeben wird.
"Entitäts-ID": Ein eindeutiger Entitätsname. Bei den Namen wird die Groß-/Kleinschreibung beachtet.
"Beginnend bei": Eine optionale Startzeit für die Verfolgung einer relevanten Entität. Ohne Angabe der Zeit wird der 1. Januar 1970 verwendet.
Value Table
entities_interest_layer
Der Layer oder die Tabelle mit den relevanten Entitäten. Dieser Parameter wird nur unterstützt, wenn SELECTED_FEATURE für den Parameter entities_of_interest_input_type angegeben wird.
Record Set
include_tracks_layer
(optional)
Gibt an, ob ein Ausgabe-Layer erstellt wird, der das erste verfolgte Ereignis und alle nachfolgenden Features für die betreffende Entität enthält.
TRACKS—Es wird ein Ausgabe-Layer erstellt, der das erste verfolgte Ereignis und alle nachfolgenden Features enthält.
NO_TRACKS—Es wird kein Ausgabe-Layer erstellt, der das erste verfolgte Ereignis und alle nachfolgenden Features enthält.
Boolean
max_trace_depth
Der maximale Grad der Trennung zwischen einer relevanten Entität und einer Entität, die sich weiter unten (flussabwärts) in der Verfolgung befindet.
Long
attribute_match_criteria
[attribute_match_criteria,...]
(optional)
Die Felder, mit denen das Ereignis in der Nähe eingeschränkt wird.
Field
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
Der Layer, der die Ereignisse in der Nähe enthält, die verfolgt werden.
Feature Set
tracks_layer
Der optionale Layer, der das erste verfolgte Ereignis in den Tracks und alle nachfolgenden Features enthält.
Feature Set
Codebeispiel
TraceProximityEvents (eigenständiges Skript)
Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug TraceProximityEvents verwendet wird.
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.
