ST_LocateAlong
上一个  7.19. 线性参考  下一个

名称

ST_LocateAlong — 返回几何图形上与指定度量值匹配的点。

概要

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

描述

返回沿具有给定度量值的测量几何图形上的位置。结果是一个点或多点。不支持多边形输入。

如果提供了 offset，则结果将按指定的距离偏移到输入线的左侧或右侧。正偏移将向左，负偏移将向右。

[Note]

此函数仅适用于具有 M 分量的线性几何图形。

语义由 ISO/IEC 13249-3 SQL/MM Spatial 标准指定。

可用性：1.1.0 版本，旧名称为 ST_Locate_Along_Measure。

已更改：2.0.0 版本，在以前的版本中，此函数名为 ST_Locate_Along_Measure。

此函数支持 M 坐标。

此方法实现了 SQL/MM 规范。SQL-MM IEC 13249-3: 5.1.13

示例

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