Name

ST_LocateAlong — Renvoie le(s) point(s) d'une géométrie qui correspond(ent) à une valeur de mesure.

Synopsis

geometry ST_LocateAlong(geometry geom_with_measure, float8 measure, float8 offset = 0);

Description

Renvoie le(s) emplacement(s) le long d'une géométrie mesurée qui possède(nt) les valeurs de mesure données. Le résultat est un point ou un multipoint. Les entrées polygonales ne sont pas prises en charge.

Si offset est fourni, le résultat est décalé à gauche ou à droite de la ligne d'entrée de la distance spécifiée. Un décalage positif se fera vers la gauche, et un décalage négatif vers la droite.

[Note]

Cette fonction n'est utilisée que pour les géométries linéaires avec une composante M

La sémantique est spécifiée par la norme ISO/IEC 13249-3 SQL/MM Spatial.

Disponibilité : 1.1.0 sous l'ancien nom ST_Locate_Along_Measure.

Modifié : 2.0.0 dans les versions précédentes, cette fonction était appelée ST_Locate_Along_Measure.

Cette fonction prend en charge les coordonnées M.

Cette méthode implémente la spécification SQL/MM. SQL-MM IEC 13249-3: 5.1.13

Exemples

SELECT ST_AsText(
  ST_LocateAlong(
    'MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 3),(1 2 3, 5 4 5))'::geometry,
    3 ));

----------------------------------
 MULTIPOINT M ((1 2 3),(9 4 3),(1 2 3))