名前
ST_LocateAlong — M 値に一致するジオメトリー上のポイントを返します。
概要
geometry ST_LocateAlong(geometry geom_with_measure, float8 measure, float8 offset = 0);
説明
M 値を持つジオメトリーに沿った位置を返します。結果はポイントまたはマルチポイントです。ポリゴン系入力には対応していません。
offsetが与えられた場合には、結果は、入力ラインの左または右に、指定された距離だけ移動します。正のオフセット値で左に、負の値で右にそれぞれ移動します。
![[注記]](../images/note.png)
|
|
|
この関数は、M 要素を持つライン系ジオメトリーでのみ使います。 |
ISO/IEC 13249-3 SQL/MM 空間標準で規定されているため、このような意味になります。
Availability: 1.1.0 それまでは ST_Locale_Along_Measure でした。
Changed: 2.0.0 以前の版では ST_Locate_Along_Measure と呼ばれていました。
この関数はM値に対応します。
このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1.13
例
コード
SELECT 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))
図