説明

ラインストリングまたは曲線ストリングの 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

図

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

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

POINT(3 2)

010100000000000000000008400000000000000040

図

インデックスは 1始まりです。負数インデックスは 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

図

関連情報

ST_NPoints