ST_LocateAlong

更新时间:
复制 MD 格式

Returns the element of a geometry object that matches the specified M coordinate.

Syntax

geometry ST_LocateAlong(geometry ageomWithMeasure, float8 aMeasure, float8 offset)

Parameters

ParameterDescription
ageomWithMeasureThe geometry object to query.
aMeasureThe M coordinate value to match.
offsetThe offset distance applied during computation. A positive value offsets to the left; a negative value offsets to the right along the input line.

Usage notes

  • This function supports only geometry objects that have M coordinates.

  • This function does not support polygon objects.

Examples

SELECT ST_AsText(ST_LocateAlong(ST_GeomFromText('MultiPointM((1 2 3),(5 4 3),(4 5 6))'),3));
         st_astext
----------------------------
 MULTIPOINT M (1 2 3,5 4 3)
(1 row)