Capturer des traces (GeoAnalytics)

Synthèse

Capture des points de suivi en entrée sur des lignes. Les données ponctuelles à dimension temporelle doivent inclure des entités qui représentent un instant T dans le temps. Des lignes traversables avec des champs indiquant les nœuds de début et de fin sont requis pour l’analyse.

Illustration

Illustration de l’outil Capturer des traces
Les points de trace temporels ayant été appariés aux lignes sont affichés.

Utilisation

  • Le tableau suivant répertorie la terminologie employée dans l’outil Capturer des traces :

    TermeDescription

    Parcours

    Séquence d’entités temporelles de type instant. Les entités sont identifiées comme faisant partie de l’une séquence par un champ d’identificateur de trace et elles obéissent à un classement temporel. Par exemple, une ville peut disposer d’une flotte de chasse-neige qui enregistrent leur position toutes les 30 secondes. L’ID de véhicule peut représenter les traces distinctes.

    Observation

    Point d’une piste

    Nœud

    Les nœuds sont les sommets d’extrémité des entités linéaires utilisées pour indiquer la direction de la ligne. Le début de la ligne est le nœud de début et la fin de la ligne est le nœud de fin.

    Direction

    Direction d’une ligne. La direction indique le déplacement pouvant être effectué sur une ligne entre le nœud de début et le nœud de fin.

    Connectivité

    La connectivité décrit la manière dont les lignes sont connectées pour représenter un réseau traversable. Les lignes sont connectées en fonction des valeurs du nœud de début et du nœud de fin. Les lignes qui, en fonction de la connectivité, ne peuvent pas être atteintes par un point ne sont pas considérées comme appariées.

    Traversable

    Les lignes sont traversables si elles sont connectées par des nœuds communs. Par exemple, si le nœud de début de la ligne A est le même que le nœud de fin de la ligne B, ces deux lignes sont traversables.

  • L’outil requiert les couches en entrée de paramètre suivantes :

    • Couche de points en entrée : la couche de points en entrée doit être constituées d’observations temporelles qui représentent un instant dans le temps. Les observations de trace qui n’ont pas d’horodatage valide sont exclues de l’analyse.
    • Couche linéaire en entrée : la couche linéaire en entrée doit contenir des champs comportant les informations de connectivité suivantes et doit être spécifiée dans le paramètre Appariement de champs de connectivité :
      • ID unique : identifiant unique de la ligne
      • Depuis le nœud : nœud d’origine du déplacement le long d’une ligne
      • Vers le nœud : nœud vers lequel le déplacement le long d’une ligne a lieu

  • Remarque :

    Les couches d’entités de géodatabase StreetMap Premium sous licence ne sont pas prises en charge en entrée pour ArcGIS Pro 3.0.

  • La référence spatiale de la valeur du paramètre Couche de points en entrée doit être la même que la référence spatiale de la valeur du paramètre Couche linéaire en entrée. Si les jeux de données ont des références spatiales différentes, utilisez l’environnement Système de coordonnées en sortie pour spécifier la référence spatiale à utiliser dans l’analyse ou projetez les jeux de données avant l’analyse.

  • Vous pouvez spécifier un ou plusieurs champs pour identifier des pistes. Les pistes sont représentées par un ou plusieurs champs de piste. Si, par exemple, les champs flightID et Destination sont utilisés comme identifiants de piste, les entités ID007, Solden et ID007, Tokyo figurent dans deux pistes distinctes étant donné que leur champ Destination contient des valeurs différentes.

  • Les traces doivent avoir plusieurs observations pour pouvoir être utilisées dans une analyse. Les traces ne possédant qu’une seule observation ne sont pas appariées.

  • Les appariements de points sur la ligne sont réalisés dans les conditions suivantes :

    • L’observation se trouve à la distance de recherche à partir d’une ligne. Il s’agit de l’exigence minimale. Les observations ne sont pas appariées si elles ne remplissent pas la condition liée à la distance de recherche.
    • L’observation peut traverser les lignes en fonction de leur connectivité.
    • L’observation se déplace dans une direction prise en charge par la ligne. Il s’agit d’une condition facultative qui est prise en compte si vous spécifiez des valeurs pour le paramètre Appariement des valeurs de direction. Les résultats qui répondent à cette condition facultative sont plus précis.

  • Utilisez le paramètre Distance de recherche pour spécifier la distance maximale autorisée entre une observation et une ligne. Par exemple, si vous savez que la précision des points GPS est d’environ 100 mètres, indiquez 100 mètres pour la distance de recherche.

  • Le paramètre Méthode de calcul de distance détermine la manière dont les distances de recherche sont calculées. Deux méthodes de calcul de distance sont disponibles :

    • Géodésique : si la référence spatiale peut être déplacée en continu en croisant l’antiméridien, les traces traversent l’antiméridien lorsque cela est approprié. Si la référence spatiale ne peut pas être déplacée en continu, les traces sont limitées à l’étendue du système de coordonnées et ne sont pas renvoyées à la ligne. Il s’agit de l’option par défaut.
    • Planaire : les traces ne croisent pas l’antiméridien. Utilisez cette option si les données en entrée utilisent un système de coordonnées projetées.

  • Pour inclure des attributs de ligne supplémentaires dans les résultats en sortie, spécifiez les noms de champ avec le paramètre Champs de ligne à inclure. Ces champs ne sont pas utilisés à des fins d’analyse et sont inclus pour votre propre usage. Vous ne pouvez pas inclure de champs de géométrie dans le résultat en sortie.

  • Utilisez le paramètre Appariement des valeurs de direction afin de définir les directions prises en charge pour chaque entité linéaire. Par exemple, une couche linéaire possédant un champ nommé direction avec les valeurs T (arrière), F (avant), B (les deux) et "" (aucune). L’appariement de la direction est facultatif mais il reste recommandé si vous souhaitez obtenir des résultats plus précis. Si aucun appariement de direction n’est spécifié, la ligne est considérée comme bidirectionnelle.

  • L’outil renvoie les points capturés sur la localisation la plus proche le long de la ligne avec laquelle elle est appariée. Les entités linéaires ne sont pas renvoyées. L’identifiant unique du jeu de données linéaires est disponible pour les résultats appariés. Le champ de l’identifiant unique est spécifié avec le paramètre Appariement de champs de connectivité. Vous pouvez identifier les lignes appariées en référençant ce champ.

  • Outre les champs issus de la couche de points en entrée et les champs de ligne spécifiés, les champs suivants sont ajoutés à la sortie :

    Nom du champDescription

    MatchStatus

    Indique si l’observation a été appariée à une ligne. Les valeurs sont M pour les entités appariées et U pour les entités non appariées.

    OrigX

    Coordonnée x de l’observation en entrée. Les coordonnées sont stockées dans les unités de la référence spatiale en sortie.

    OrigY

    Coordonnée y de l’observation en entrée. Les coordonnées sont stockées dans les unités de la référence spatiale en sortie.

    MatchX

    Coordonnée x du résultat apparié sur la ligne. Les coordonnées sont stockées dans les unités de la référence spatiale en sortie.

    MatchY

    Coordonnée y du résultat apparié sur la ligne. Les coordonnées sont stockées dans les unités de la référence spatiale en sortie.

    MatchDist

    Distance entre la localisation d’origine et la localisation appariée d’une observation. Les distances sont calculées selon la méthode de calcul de distances sélectionnée (géodésique ou planaire). Les valeurs sont enregistrées en mètres.

    INSTANT_DATETIME

    Horodatage de l’observation.

    Si la valeur du paramètre Mode en sortie spécifiée est Toutes les entités, les points appariés et non appariés sont renvoyés. Dans le cas des points non appariés, des valeurs nulles représentant les champs numériques et des chaînes vides représentant les champs de type chaîne sont ajoutées aux champs de résultat en sortie. Les champs dans lesquels des valeurs nulles sont ajoutées sont des champs de ligne spécifiés avec le paramètre Champs de ligne à inclure (champ MatchX, champ MatchY et champ MatchDist).

  • Vous pouvez améliorer les performances de l’outil Capturer des traces en suivant les conseils ci-après :

    • Utilisez une valeur plus petite pour le paramètre Distance de recherche pour faire en sorte qu’un nombre inférieur de paires point-ligne soient prises en compte dans le processus d’appariement. Il est recommandé d’utiliser une valeur inférieure à 75 mètres.
    • Utilisez le paramètre Appariement des valeurs de direction pour faire en sorte que les lignes soient uniquement appariées à des points se déplaçant dans une direction prise en charge par la ligne.
    • Utilisez une sélection de traces d’intérêt au lieu du jeu de données de traces entier.
    • Spécifiez moins de champs pour le paramètre Champs de ligne à inclure.
    • Définissez l’environnement Étendue de sorte que seules les données d’intérêt soient analysées.
    • Utilisez la méthode planaire au lieu de la méthode géodésique pour le calcul de la distance.
    • Utilisez les données locales de l’environnement de l’analyse.

  • Vous pouvez effectuer une analyse semblable en utilisant :

    • Utilisez l’outil Reconstruire les traces pour reconstruire les points de traces temporels en lignes.
    • Utilisez l’outil Capturer pour capturer des points, des multi-points, des lignes ou des polygones sur d’autres entités. Cet outil modifie les données en entrée.

  • Cet outil de géotraitement est optimisé par ArcGIS GeoAnalytics Server. L’analyse est réalisée sur GeoAnalytics Server et les résultats sont stockés dans votre contenu dans ArcGIS Enterprise.

  • Lors de l’exécution des outils GeoAnalytics Server, l’analyse est réalisée sur GeoAnalytics Server. Pour des performances optimales, GeoAnalytics Server doit pouvoir accéder aux données via les couches d’entités hébergées sur votre portail ArcGIS Enterprise ou les partages de fichiers Big Data. Les données qui ne sont pas locales pour GeoAnalytics Server sont transférées sur GeoAnalytics Server avant le début de l’analyse. Autrement dit, l’exécution d’un outil prend plus de temps et, dans certains cas, le transfert des données depuis ArcGIS Pro vers GeoAnalytics Server peut échouer. Le seuil d’échec dépend aussi bien des débits du réseau que de la taille et de la complexité des données. Il est recommandé de toujours partager les données ou de créer un partage de fichiers Big Data.

    Pour en savoir plus sur le partage des données dans votre portail.

    En savoir pus sur la création d’un partage de fichiers Big Data via ArcGIS Server Manager

Paramètres

ÉtiquetteExplicationType de données
Couche ponctuelle en entrée

Points qui seront appariés aux lignes. L’entrée doit être une couche de points temporelle représentant un instant donné dans le temps et doit contenir au moins un champ qui identifie des traces uniques.

Feature Set
Couche linéaire en entrée

Lignes auxquelles les points seront appariés. L’entrée doit contenir des champs dont les valeurs indiquent les nœuds de début et de fin de la ligne.

Feature Set
Nom en sortie

Nom du service d’entités en sortie.

String
Champs de trace

Un ou plusieurs champs utilisés pour identifier des pistes uniques.

Field
Distance de recherche

Distance maximale autorisée entre un point et n’importe quelle ligne considérée comme appariée. Il est recommandé d’utiliser des valeurs inférieures ou égales à 75 mètres. Des distances supérieures entraînent des temps de traitement plus longs et génèrent des résultats moins précis.

Linear Unit
Appariement de champs de connectivité

Champs de la couche linéaire utilisés pour définir la connectivité des entités linéaires en entrée.

  • ID unique : champ de la couche linéaire contenant la valeur de l’ID unique de chaque entité linéaire.
  • Depuis le nœud : champ de la couche linéaire contenant les valeurs de nœud de début
  • Vers le nœud : champ de la couche linéaire contenant les valeurs de nœud de fin
Value Table
Champs de ligne à inclure
(Facultatif)

Un ou plusieurs champs de la couche linéaire en entrée à inclure dans le résultat en sortie.

Field
Méthode de distance
(Facultatif)

Indique la méthode utilisée pour le calcul des distances entre les points et les lignes.

  • GéodésiqueDes distances géodésiques sont calculées. Il s’agit de l’option par défaut.
  • PlanaireDes distances planaires sont calculées.
String
Appariement des valeurs de direction
(Facultatif)

Champ de la couche linéaire et valeurs attributaires utilisées pour définir la direction des entités linéaires en entrée. Par exemple, une couche linéaire possédant un champ nommé direction avec les valeurs T (arrière), F (avant), B (les deux) et "" (aucune). Si aucune valeur n’est indiquée, la ligne est considérée comme bidirectionnelle.

  • Champ de direction : champ de la couche linéaire qui décrit la direction du déplacement.
  • Valeur Avant : valeur du Champ de direction indiquant que la direction de déplacement prise en charge est vers l’avant le long d’une ligne.
  • Valeur Arrière : valeur du Champ de direction indiquant que la direction de déplacement prise en charge est vers l’arrière le long d’une ligne.
  • Valeur Les deux : valeur du Champ de direction indiquant que les deux directions, vers l’avant et vers l’arrière, sont prises en charge le long d’une ligne.
  • Valeur Aucune : valeur du Champ de direction indiquant qu’il n’existe aucune direction de déplacement prise en charge le long d’une ligne.

Value Table
Mode en sortie
(Facultatif)

Indique si toutes les entités en entrée ou uniquement les entités en entrée appariées à une entité linéaire sont renvoyées.

  • Toutes les entitésToutes les entités ponctuelles en entrée sont renvoyées qu’elles soient appariées ou non à une entité linéaire. Il s’agit de l’option par défaut.
  • Entités appariéesSeules les entités ponctuelles en entrée appariées à une entité linéaire sont renvoyées.
String
Data store
(Facultatif)

Indique l’instance ArcGIS Data Store dans laquelle la sortie est enregistrée. La valeur par défaut est Stockage de Big Data spatio-temporelles. Tous les résultats stockés dans un répertoire de données Big Data spatio-temporelles seront stockés en WGS84. Les résultats stockés dans un répertoire de données relationnelles conservent leur système de coordonnées.

  • Stockage de Big Data spatio-temporellesLa sortie sera stockée dans un stockage de Big Data spatio-temporelles. Il s’agit de l’option par défaut.
  • Stockage des données relationnellesLa sortie sera stockée dans un data store relationnel.
String

Sortie obtenue

ÉtiquetteExplicationType de données
Classe d’entités en sortie

Points en sortie.

Feature Set

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})
NomExplicationType de données
input_points

Points qui seront appariés aux lignes. L’entrée doit être une couche de points temporelle représentant un instant donné dans le temps et doit contenir au moins un champ qui identifie des traces uniques.

Feature Set
input_lines

Lignes auxquelles les points seront appariés. L’entrée doit contenir des champs dont les valeurs indiquent les nœuds de début et de fin de la ligne.

Feature Set
output_name

Nom du service d’entités en sortie.

String
track_fields
[track_fields,...]

Un ou plusieurs champs utilisés pour identifier des pistes uniques.

Field
search_distance

Distance maximale autorisée entre un point et n’importe quelle ligne considérée comme appariée. Il est recommandé d’utiliser des valeurs inférieures ou égales à 75 mètres. Des distances supérieures entraînent des temps de traitement plus longs et génèrent des résultats moins précis.

Linear Unit
connectivity_field_matching
[connectivity_field_matching,...]

Champs de la couche linéaire utilisés pour définir la connectivité des entités linéaires en entrée.

  • ID unique : champ de la couche linéaire contenant la valeur de l’ID unique de chaque entité linéaire.
  • Depuis le nœud : champ de la couche linéaire contenant les valeurs de nœud de début
  • Vers le nœud : champ de la couche linéaire contenant les valeurs de nœud de fin
Value Table
line_fields_to_include
[line_fields_to_include,...]
(Facultatif)

Un ou plusieurs champs de la couche linéaire en entrée à inclure dans le résultat en sortie.

Field
distance_method
(Facultatif)

Indique la méthode utilisée pour le calcul des distances entre les points et les lignes.

  • GEODESICDes distances géodésiques sont calculées.
  • PLANARDes distances planaires sont calculées.
String
direction_value_matching
[direction_value_matching,...]
(Facultatif)

Champ de la couche linéaire et valeurs attributaires utilisées pour définir la direction des entités linéaires en entrée. Par exemple, une couche linéaire possédant un champ nommé direction avec les valeurs T (arrière), F (avant), B (les deux) et "" (aucune). Si aucune valeur n’est indiquée, la ligne est considérée comme bidirectionnelle.

  • Champ de direction : champ de la couche linéaire qui décrit la direction du déplacement.
  • Valeur Avant : valeur du Champ de direction indiquant que la direction de déplacement prise en charge est vers l’avant le long d’une ligne.
  • Valeur Arrière : valeur du Champ de direction indiquant que la direction de déplacement prise en charge est vers l’arrière le long d’une ligne.
  • Valeur Les deux : valeur du Champ de direction indiquant que les deux directions, vers l’avant et vers l’arrière, sont prises en charge le long d’une ligne.
  • Valeur Aucune : valeur du Champ de direction indiquant qu’il n’existe aucune direction de déplacement prise en charge le long d’une ligne.

Value Table
output_mode
(Facultatif)

Indique si toutes les entités en entrée ou uniquement les entités en entrée appariées à une entité linéaire sont renvoyées.

  • ALL_FEATURESToutes les entités ponctuelles en entrée sont renvoyées qu’elles soient appariées ou non à une entité linéaire. Il s’agit de l’option par défaut.
  • MATCHED_FEATURESSeules les entités ponctuelles en entrée appariées à une entité linéaire sont renvoyées.
String
data_store
(Facultatif)

Indique l’instance ArcGIS Data Store dans laquelle la sortie est enregistrée. La valeur par défaut est SPATIOTEMPORAL_DATA_STORE. Tous les résultats stockés dans un répertoire de données Big Data spatio-temporelles seront stockés en WGS84. Les résultats stockés dans un répertoire de données relationnelles conservent leur système de coordonnées.

  • SPATIOTEMPORAL_DATA_STORELa sortie sera stockée dans un stockage de Big Data spatio-temporelles. Il s’agit de l’option par défaut.
  • RELATIONAL_DATA_STORELa sortie sera stockée dans un data store relationnel.
String

Sortie obtenue

NomExplicationType de données
output

Points en sortie.

Feature Set

Exemple de code

Exemple 1 d’utilisation de l’outil SnapTracks (script autonome)

Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction SnapTracks.

# 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")

Environnements

Cas particuliers

Système de coordonnées en sortie

Système de coordonnées qui sera utilisé pour l'analyse. L’analyse sera réalisée dans le système de coordonnées en entrée, à moins que ce paramètre en spécifie un autre. Pour GeoAnalytics Tools, les résultats finaux sont stockés dans le Spatiotemporal Data Store dans WGS84.

Informations de licence

  • Basic: Nécessite ArcGIS GeoAnalytics Server
  • Standard: Nécessite ArcGIS GeoAnalytics Server
  • Advanced: Nécessite ArcGIS GeoAnalytics Server

Rubriques connexes