Couches de trace

Lorsqu’un administrateur active le partage de la localisation pour votre organisation, des couches de trace sont créées. Elles contiennent des informations sur la position actuelle des utilisateurs et sur leurs localisations précédentes. Vous pouvez utiliser les vues de couches d’entités hébergées de ces couches (connues sous le nom de vues des traces) dans vos cartes et applications pour connaître les localisations précédentes de vos utilisateurs mobiles par rapport à d’autres ressources et informations. Vous pouvez également utiliser les couches de trace pour réaliser une analyse avancée dans ArcGIS.

Remarque :

Si vous souhaitez une vue d’ensemble plus générale des informations de trace et réaliser de simples opérations de filtrage et d’analyse des traces, vous pouvez afficher les traces dans l’application Web Track Viewer.

Structure de partage de la localisation

Lorsque le partage de la localisation est activé pour votre organisation, une couche de partage de la localisation est créée pour stocker la dernière position connue des utilisateurs mobiles, ainsi que l’historique complet des traces de localisation des utilisateurs. Ces informations sont stockées dans trois sous-couches, chacune avec une structure prédéfinie : dernières positions connues, traces et lignes de trace. Lorsque vous créez des vues des traces dans l’application Web Track Viewer, une vue de couche d’entités hébergée est créée pour chacune de ces couches de trace.

La couche d’entités de partage de la localisation et les vues de couches d’entités hébergées sont créées dans un dossier Location sharing (Partage de la localisation) dans le contenu du compte d’administrateur qui a servi à activer le partage de la localisation. La couche d’entités de partage de la localisation est nommée Location sharing (Partage de la localisation) et les vues de couches d’entités hébergées prennent le nom de la vue des traces pour laquelle elles ont été créées. Vous pouvez partager ces vues de couches d’entités hébergées avec les utilisateurs de votre organisation en les ajoutant en tant qu’utilisateurs en consultation lorsque la vue des traces est créée. Pour plus d’informations, reportez-vous à la rubrique Créer des vues de traces.

Remarque :

Les couches d’entités de partage de la localisation et les vues de couches d’entités ne peuvent pas être partagées avec le public.

La couche de partage de la localisation ne consomme pas de crédits pour le stockage. Pour plus d’informations sur l’utilisation des crédits dans ArcGIS Online, reportez-vous à la rubrique Présentation des crédits.

Couche d’entités des traces

La couche d’entités de traces (et les vues de couches d’entités hébergées qui reposent dessus) est une couche ponctuelle contenant un enregistrement de chaque position où un utilisateur mobile a fait l’objet d’un suivi avec l’application mobile Field Maps, QuickCapture, Survey123 ou Indoors. Ces enregistrements incluent des informations sur le point de trace, notamment la trace associée, le type d’activité de l’utilisateur mobile, l’état de la batterie de son appareil, sa trajectoire et son altitude (par rapport au niveau moyen de la mer), ainsi que la précision de la localisation.

Les points sont uniquement insérés par l’application mobile Field Maps, QuickCapture, Survey123 ou Indoors et ne sont jamais mis à jour ni supprimés. Aucun filtrage ne s’applique aux points enregistrés. Ils reflètent les données brutes issues de l’appareil de l’utilisateur mobile. La couche suit le système de coordonnées WGS 1984 Web Mercator (Sphère auxiliaire) [WGS84], avec l’ID connu (WKID) 4326.

Couche d’entités des dernières positions connues

La couche d’entités des dernières positions connues (et toute vue de couche d’entités hébergée basée dessus) est une couche de points qui comporte un seul enregistrement pour chaque utilisateur, cet enregistrement correspondant à la dernière position connue de l’utilisateur. Elle contient les mêmes champs et informations que la couche d’entités des traces et est également dans le système de coordonnées WGS84.

La table suivante recense les champs de la couche d’entités des traces et de la couche d’entités des dernières positions connues :

TerrainDescription
activity

Ce champ représente l’activité d’un utilisateur mobile au moment de l’enregistrement d’une trace. Six valeurs sont disponibles pour ce champ :

  • Unknown (0)
  • Stationary (1)
  • Walking (2)
  • Running (3)
  • Cycling (4)
  • Automotive (5)

L’activité est déterminée par Core Motion sur iOS et ActivityRecognitionClient sur Android, avec ArcGIS Field Maps, ArcGIS QuickCapture, Survey123 et ArcGIS Indoors tenant compte des activités communes entre les deux systèmes. Chacune de ces API s’appuie sur des capteurs, notamment les accéléromètres, les gyroscopes, le podomètre, le magnétomètre et le baromètre de votre appareil. Si la valeur Unknown (Inconnu) s’affiche en continu, il est possible que votre appareil ne dispose pas de tous les capteurs.

altitude

Altitude de l’appareil, mesurée en mètres au-dessus du niveau moyen de la mer (MSL).

app_id

Application ayant enregistré la localisation. La valeur tracker sera appliquée pour les points téléchargés depuis Tracker.

battery_percentage

Pourcentage d’autonomie de la batterie de l’appareil. Il est compris entre 0 et 100.

battery_state

Ce champ représente l’état de la batterie de l’appareil. Quatre valeurs peuvent être enregistrées :

  • Unknown (0)
  • Unplugged (1)
  • Charging (2)
  • Plugged and fully charged (3)
category

Catégorie associée à la trace.

course

Le sens de déplacement, compris entre 0 et 360 degrés.

created_user

Nom d’utilisateur de l’utilisateur mobile.

created_date

Date et heure de chargement du point sur le serveur.

device_id

ID unique attribué à l’appareil.

floor

Numéro d’étage communiqué par le fournisseur de services de localisation.

globalid

ID global de l’entité générée par le serveur.

full_name

Nom complet de l’utilisateur.

horizontal_accuracy

Précision horizontale de la localisation enregistrée, mesurée en mètres.

last_edited_date

Date et heure de la dernière mise à jour du point sur le serveur.

last_edited_user

Nom d’utilisateur du dernier utilisateur à avoir mis à jour l’entité.

level_id

Niveau enregistré lors de l’utilisation de ArcGIS IPS

location_source

Source de la localisation (Wi-Fi, GPS, fusionné, etc.). Elle est uniquement enregistrée sur les appareils Android.

location_timestamp

Date et heure d’enregistrement de la localisation par l’appareil.

objectid

Champ d'ID géré par le système.

session_id

ID unique généré à chaque activation du suivi.

signal_strength

Force du signal de l’appareil. Ce champ n’est pas renseigné actuellement dans la couche de partage de la localisation.

speed

Vitesse de l’appareil, enregistrée en mètres par seconde.

vertical_accuracy

Précision verticale de la localisation enregistrée, mesurée en mètres.

Remarque :

Toutes les valeurs de date/heure (datetime) sont enregistrées en UTC (Temps universel coordonné).

Le paramètre location_timestamp correspond à la date et l’heure auxquelles une localisation a été enregistrée par l’application mobile. Le paramètre last_edited_date correspond au moment auquel a eu lieu la dernière modification de l’entité dans la base de données du serveur.

Couche d’entités des lignes de trace

La couche d’entités des lignes de trace (et n’importe quelle vue de couche d’entités hébergée basée dessus) est une couche de polylignes qui contient les lignes correspondant aux localisations antérieures d’un utilisateur mobile. Ces lignes sont automatiquement générées par le serveur à l’aide des points de suivi chargés depuis la couche d’entités des traces. Les lignes de trace sont mises à jour toutes les 10 minutes environ et représentent une durée maximale d’une heure. Les statistiques de chaque polyligne sont calculées et stockées sous forme d’attributs dans la couche. La couche suit le système de coordonnées WGS 1984 Web Mercator (Sphère auxiliaire) [WGS84], avec l’ID connu (WKID) 4326.

La table suivante répertorie les champs de la couche d’entités des lignes de trace :

TerrainDescription
avg_altitude

Altitude moyenne basée sur les points de suivi utilisés pour générer la ligne, mesurée en mètres au-dessus du niveau moyen de la mer (MSL).

avg_horizontal_accuracy

Précision horizontale moyenne basée sur les points de suivi utilisés pour générer la ligne, mesurée en mètres.

avg_speed

Vitesse moyenne de l’utilisateur basée sur les points de suivi utilisés pour générer la ligne, mesurée en mètres par seconde.

avg_vertical_accuracy

Précision verticale moyenne basée sur les points de suivi utilisés pour générer la ligne, mesurée en mètres.

category

Catégorie associée à la trace.

count

Nombre de points de suivi utilisés pour générer la ligne.

created_date

Date et heure de création de la ligne.

created_user

Nom d’utilisateur de l’utilisateur mobile.

end_time

Heure de fin de la ligne.

full_name

Nom complet de l’utilisateur.

globalid

ID global de l’entité générée par le serveur.

max_altitude

Altitude la plus élevée, mesurée en mètres au-dessus du niveau moyen de la mer (MSL).

max_battery_percentage

Pourcentage d’autonomie le plus élevé de la batterie de l’appareil. Il est compris entre 0 et 100.

max_horizontal_accuracy

Précision horizontale maximale, mesurée en mètres.

max_speed

Vitesse maximale, mesurée en mètres par seconde.

max_vertical_accuracy

Précision verticale maximale, mesurée en mètres.

min_altitude

Altitude la plus faible, mesurée en mètres au-dessus du niveau moyen de la mer (MSL).

min_battery_percentage

Pourcentage d’autonomie le plus faible de la batterie de l’appareil. Il est compris entre 0 et 100.

min_horizontal_accuracy

Précision horizontale minimale, mesurée en mètres.

min_speed

Vitesse minimale, mesurée en mètres par seconde.

min_vertical_accuracy

Précision verticale minimale, mesurée en mètres.

objectid

Champ d'ID géré par le système.

last_edited_date

Date et heure de la dernière mise à jour du point sur le serveur.

last_edited_user

Nom d’utilisateur du dernier utilisateur à avoir mis à jour l’entité.

predominant_activity

Activité la plus courante de l’utilisateur mobile. Six valeurs sont disponibles pour ce champ :

  • Unknown (0)
  • Stationary (1)
  • Walking (2)
  • Running (3)
  • Cycling (4)
  • Automotive (5)

L’activité est déterminée par Core Motion sur iOS et ActivityRecognitionClient sur Android, avec ArcGIS Field Maps, ArcGIS QuickCapture, Survey123 et ArcGIS Indoors tenant compte des activités communes entre les deux systèmes. Chacune de ces API s’appuie sur des capteurs, notamment les accéléromètres, les gyroscopes, le podomètre, le magnétomètre et le baromètre de votre appareil. Si la valeur Unknown (Inconnu) s’affiche en continu, il est possible que votre appareil ne dispose pas de tous les capteurs.

predominant_battery_state

État le plus courant de la batterie de l’appareil. Quatre valeurs peuvent être enregistrées :

  • Unknown (0)
  • Unplugged (1)
  • Charging (2)
  • Plugged and fully charged (3)
start_time

Heure de début de la ligne.

Remarque :

Toutes les valeurs de date/heure (datetime) sont enregistrées en UTC (Temps universel coordonné).

Analyse avancée et configuration

Pour utiliser la structure de partage de la localisation à des fins d’analyse avancée et de configuration, faites appel à ArcGIS API for Python. Il propose un module permettant d’automatiser la gestion des couches de trace, des utilisateurs en consultation et des utilisateurs mobiles. Outre la gestion de contenu, ArcGIS API for Python vous permet de développer des analyses de traces plus complexes. Pour accéder à des exemples et aux pratiques conseillées, reportez-vous aux exemples de scripts et aux notebooks disponibles sur GitHub.

Filtrage des traces non valides

L’application web Track Viewer filtre les points de trace non valides pour les supprimer à l’aide de l’expression ci-dessous. Vous pouvez utiliser la même expression dans Map Viewer pour filtrer les points de trace non valides afin de les supprimer sur votre propre carte. Appliquez un filtre à la couche de traces dans Map Viewer à l’aide de l’expression suivante :

horizontal_accuracy <= 10 OR (horizontal_accuracy <= 25 AND (speed is not NULL OR course is not NULL)) OR (speed is not NULL AND course is not NULL)

Suppression des traces

Bien que la fonctionnalité de suppression de la couche de partage de la localisation n’apparaît pas dans la définition de la couche d’entités, les administrateurs peuvent supprimer des traces via ArcGIS REST API à l’aide de l’opération de suppression d’entités. Pour que les administrateurs puissent supprimer des traces, le partage de la localisation doit être désactivé dans les paramètres de l’organisation.

Accédez à l’extrémité REST de suppression des entités pour la couche des traces, où vous pouvez spécifier une clause Where ou des ID d’objet pour identifier et supprimer des traces. L’URL de l’extrémité REST de suppression des entités est au format suivant (où host, domain et webadaptor sont remplacés par les informations propres à votre serveur).

https://host.domain.com/webadaptor/rest/services/Hosted/location_tracking/FeatureServer/0/deleteFeatures
Remarque :

La possibilité de supprimer des traces est limitée au retrait d’une ou de plusieurs traces complètes d’utilisateur. La dernière position connue, les traces et les lignes de trace de l’utilisateur sont ainsi complètement supprimées. La suppression des points de suivi individuels n’est pas prise en charge. Pour supprimer les traces d’un utilisateur, vous devez utiliser les paramètres suivants dans l’extrémité REST de suppression des entités (comme décrit plus haut) :

  • returnDeleteResults = false
  • async = true
  • rollbackOnFailure = false

De plus, la clause where doit utiliser le format suivant : created_user in ('<username>').

Limitations

L’utilisation des traces est soumise aux limitations suivantes :

  • Dans ArcGIS Online, les traces ne peuvent être exportées qu’en tant que shapefiles ou fichiers CSV.
  • Les outils d’analyse ArcGIS Online ne peuvent pas être utilisés dans les couches de partage de la localisation.