ST_LocateAlong
戻る 8.12. 線型参照 次へ

名前

ST_LocateAlong — M値に一致するジオメトリ上のポイントを返します。

概要

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

説明

M値を持つジオメトリに沿った、与えられたM値に合致する位置を (POINTOまたはMULTIPOINTで)返します。ポリゴン系要素には対応していません。

offsetが与えられた場合には、結果は、入力ラインの左または右に、指定された距離だけ移動します。正のオフセット値で左に、負の値で右にそれぞれ移動します。

[注記]

この関数は、M要素を持つジオメトリでのみ使います。

ISO/IEC 13249-3 SQL/MM 空間標準で規定されているため、このような意味になります。

Availability: 1.1.0 それまではST_Locale_Along_Measureでした。

Changed: 2.0.0 以前の版ではST_Locate_Along_Measureと呼ばれていました。

This function supports M coordinates.

例

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

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

関連情報

ST_LocateBetween, ST_LocateBetweenElevations

戻る 上に戻る 次へ
ST_LineSubstring ホーム ST_LocateBetween