ST_StayPoint détecte tous les points d'arrêt d'une trajectoire, c'est-à-dire les emplacements où un objet en mouvement est resté dans un rayon spatial défini pendant une durée minimale.
Deux variantes sont disponibles :
| Fonction | Cas d'utilisation |
|---|---|
ST_StayPoint |
Renvoie chaque point d'arrêt avec ses heures de début et de fin. Utilisez la variante groupée lorsque la trajectoire contient plusieurs allers-retours sur la même zone. |
ST_stayPointSpatialClustered |
La trajectoire contient plusieurs allers-retours sur la même zone. Cette fonction fusionne les points d'arrêt qui se chevauchent spatialement et renvoie la durée totale à chaque emplacement. |
Syntaxe
SETOF trstaypoint ST_StayPoint(trajectory traj, interval resample_int, float dr, interval dt, float thres);
TABLE(point geometry, length interval) ST_stayPointSpatialClustered(trajectory traj, interval resample_int, float dr, interval dt, float thres, float merger)
Paramètres
| Paramètre | Description |
|---|---|
traj |
L'objet trajectoire. |
resample_int |
L'intervalle de rééchantillonnage. Le rééchantillonnage uniformise l'espacement des points d'échantillonnage le long de la trajectoire. Un intervalle plus court permet une détection plus précise des points d'arrêt, mais augmente le temps de calcul. Pour ignorer le rééchantillonnage, définissez cette valeur sur un nombre élevé, par exemple '100000 day'. Pour plus de détails, consultez ST_Resample. |
dr |
Le seuil de rayon spatial. Un point d'échantillonnage est considéré comme « proche » d'un point d'arrêt candidat s'il se trouve dans ce rayon. L'unité dépend de l'identifiant de référence spatiale (SRID) de la trajectoire : le SRID 0 utilise les unités de distance euclidienne ; le SRID 4326 utilise les mètres. |
dt |
Le seuil de fenêtre temporelle. Un point d'échantillonnage est considéré comme « proche » d'un point d'arrêt candidat si la différence de temps se situe dans cet intervalle. Définissez cette valeur légèrement supérieure à la durée prévue d'un seul arrêt. |
thres |
Le nombre minimal de points d'échantillonnage qui doivent se trouver « autour » d'un point candidat pour qu'il soit qualifié de point d'arrêt. Un point d'échantillonnage est « autour » d'un candidat si sa distance est inférieure à dr et si sa différence de temps est inférieure à dt. Lorsque plusieurs points consécutifs sont éligibles, celui qui est entouré du plus grand nombre de points d'échantillonnage est sélectionné comme point d'arrêt final. |
merger |
(Uniquement pour ST_stayPointSpatialClustered) Le seuil de distance de fusion. Deux points d'arrêt détectés à des moments différents sont fusionnés en un seul si la distance entre eux est inférieure à cette valeur. |
Valeur de retour
ST_StayPoint renvoie un ensemble de valeurs trstaypoint. trstaypoint est un type composite comportant les colonnes suivantes :
| Colonne | Type | Description |
|---|---|---|
point |
geometry | La position du point d'arrêt. |
startt |
timestamp | L'heure de début de l'arrêt, basée sur le premier point d'échantillonnage identifié comme faisant partie de l'arrêt. |
endt |
timestamp | L'heure de fin de l'arrêt, basée sur le dernier point d'échantillonnage identifié comme faisant partie de l'arrêt. |
ST_stayPointSpatialClustered renvoie une table contenant les colonnes suivantes :
| Colonne | Type | Description |
|---|---|---|
point |
geometry | La position du groupe de points d'arrêt fusionnés. |
length |
interval | La durée totale cumulée de tous les arrêts fusionnés dans ce groupe. |
Description
Un point de la trajectoire est qualifié de point d'arrêt lorsqu'au moins thres points d'échantillonnage se trouvent dans un rayon de dr et dans un intervalle de temps de dt autour de ce point.
Calcul de thres : divisez la durée minimale de l'arrêt par l'intervalle de rééchantillonnage, puis ajoutez 1. Par exemple, pour détecter des arrêts de 30 minutes ou plus avec un intervalle de rééchantillonnage de 5 minutes :
thres = (30 min / 5 min) + 1 = 7
Avec ces paramètres, définissez dr sur 250 m et dt sur 40 minutes (légèrement plus long que l'arrêt minimal de 30 minutes). Cet exemple détecte les arrêts dans une zone de 500 m.
Lorsqu'une trajectoire comporte plusieurs allers-retours sur la même zone, utilisez ST_stayPointSpatialClustered pour regrouper les points d'arrêt spatialement similaires. La fonction renvoie le nombre total d'emplacements d'arrêt (sous forme de nombre de lignes) et la durée totale de séjour à chaque emplacement.
Les points d'arrêt correspondent généralement à des emplacements significatifs, tels que des parkings, des stations-service ou des sites fréquemment visités, où l'objet en mouvement s'est arrêté ou a stationné.
Exemples
Détecter les points d'arrêt dans une trajectoire à passage unique
SELECT ST_AsText((ST_StayPoint(traj, '12 hour', 3, '3 day', 3)).point),
(ST_StayPoint(traj, '12 hour', 3, '3 day', 3)).*
FROM (
SELECT ST_MakeTrajectory(
'STPOINT'::leaftype,
'LINESTRING(1 1, 2 2, 3 3, 10 10, 11 11, 12 12, 13 13, 3 3, 2 2, 2 2, 3 3, 8 8,10 10,9 9,8 8)',
'2000-01-01',
'2000-01-01'::timestamp + '1 day'::interval * (ST_NPoints('LINESTRING(1 1, 2 2, 3 3, 10 10, 11 11, 12 12, 13 13, 3 3, 2 2, 2 2, 3 3, 8 8,10 10,9 9,8 8)') - 1),
'{}'
) AS traj
) tj;
La requête renvoie quatre points d'arrêt avec leurs positions (sous forme de WKT lisible via ST_AsText) et leurs plages horaires :
st_astext | point | startt | endt
----------------+--------------------------------------------+---------------------+---------------------
POINT(1 1) | 0101000000000000000000F03F000000000000F03F | 2000-01-01 00:00:00 | 2000-01-03 00:00:00
POINT(11 11) | 010100000000000000000026400000000000002640 | 2000-01-04 00:00:00 | 2000-01-07 00:00:00
POINT(3 3) | 010100000000000000000008400000000000000840 | 2000-01-08 00:00:00 | 2000-01-11 00:00:00
POINT(9.5 9.5) | 010100000000000000000023400000000000002340 | 2000-01-12 00:00:00 | 2000-01-15 00:00:00
La colonnepointstocke les coordonnées au format binaire WKB. UtilisezST_AsText()pour convertir les coordonnées en WKT lisible, comme illustré dans la requête ci-dessus.
Agréger les points d'arrêt sur plusieurs allers-retours
SELECT ST_AsText((ST_stayPointSpatialClustered(traj, '12 hour', 3, '3 day', 3, 3)).point),
(ST_stayPointSpatialClustered(traj, '12 hour', 3, '3 day', 3, 3)).*
FROM (
SELECT ST_MakeTrajectory(
'STPOINT'::leaftype,
'LINESTRING(1 1, 2 2, 3 3, 10 10, 11 11, 12 12, 13 13, 3 3, 2 2, 2 2, 3 3, 8 8,10 10,9 9,8 8)',
'2000-01-01',
'2000-01-01'::timestamp + '1 day'::interval * (ST_NPoints('LINESTRING(1 1, 2 2, 3 3, 10 10, 11 11, 12 12, 13 13, 3 3, 2 2, 2 2, 3 3, 8 8,10 10,9 9,8 8)') - 1),
'{}'
) AS traj
) tj;
La même trajectoire produit deux groupes de points d'arrêt fusionnés lors de l'utilisation de ST_stayPointSpatialClustered avec une distance de fusion de 3 (dernier paramètre) :
st_astext | point | length
--------------------+--------------------------------------------+--------
POINT(10.25 10.25) | 010100000000000000008024400000000000802440 | 6 days
POINT(2 2) | 010100000000000000000000400000000000000040 | 5 days
Les quatre points d'arrêt individuels de l'exemple précédent sont consolidés en deux groupes en fonction de leur proximité spatiale. La colonne length indique la durée totale cumulée des séjours à chaque emplacement.