説明

ラインストリングまたは曲線ストリングのN番目の点を返します。負数はラインストリングの終端から逆方向に遡って数えます。-1は終端を指します。ジオメトリにラインストリングが無い場合には、NULLを返します。

	OGC仕様では0.8.0版から要素番号は1始まりです。逆方向要素番号 (負の要素番号)はOGC仕様にはありません。前の版では0始まりで実装していました。

	マルチラインストリング内のラインストリングのN番目のポイントを得るには、ST_Dumpを併用します。

このメソッドはOGC Simple Features Implementation Specification for SQL 1.1の実装です。

このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.2.5, 7.3.5

この関数は3次元に対応し、Z値を削除しません。

このメソッドは曲線ストリングと曲線に対応しています。

Changed: 2.0.0 単一ジオメトリのMULTILINESTRINGで動作しなくなりました。単一のラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、最初のポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。

Changed: 2.3.0 : 負数インデックスが有効になりました (-1は終端を指します)

例

この例では一つのLINESTRINGから全てのPOINTジオメトリーを抽出します。

SELECT ST_PointN(
      column1,
      generate_series(1, ST_NPoints(column1))
   )
FROM ( VALUES ('LINESTRING(0 0,1 1,2 2)'::geometry) ) AS foo;

POINT(0 0)
 POINT(1 1)
 POINT(2 2)
(3 rows)

010100000000000000000000000000000000000000
0101000000000000000000F03F000000000000F03F
010100000000000000000000400000000000000040

Figure

この例ではCIRBULARSTRINGを使います。

SELECT ST_PointN('CIRCULARSTRING(1 2,3 2,1 2)', 2);

POINT(3 2)

010100000000000000000008400000000000000040

Figure

The index is 1-based. A negative index counts backward from the end of the LineString.

SELECT f
FROM ST_GeomFromText('LINESTRING(0 0 0,1 1 1,2 2 2)') AS g
  CROSS JOIN ST_PointN(g, -2) AS f;

POINT Z (1 1 1)

0101000080000000000000F03F000000000000F03F000000000000F03F

Figure

関連情報

ST_NPoints