ST_PointN
Prev  7.4. 几何访问器  Next

Name

ST_PointN — 返回几何图形中第一个线串或圆形线串中的第 N 个点。

Synopsis

geometry ST_PointN(geometry a_linestring, integer n);

描述

返回几何图形中单个线串或圆形线串中的第 N 个点。负值从 LineString 末尾开始向后计数，因此 -1 是最后一个点。如果几何图形中没有线串，则返回 NULL。

[Note]

自版本 0.8.0 以来，OGC 规范的索引从 1 开始。 OGC 中没有向后索引（负索引），以前的版本将其实现为基于 0。
[Note]

如果要获取 MultiLineString 中每个 LineString 的第 N 个点，请与 ST_Dump 结合使用

此方法实现了 SQL 1.1 的 OGC 简单功能规范。

该方法实现了SQL/MM规范。 SQL-MM 3: 7.2.5, 7.3.5

该函数支持 3d 并且不会丢失 z-index。

此方法支持圆形字符串和曲线。

[Note]

更改：2.0.0 不再适用于单个几何multilinestrings。 在旧版本的 PostGIS 中——单行 multilinestring可以与此函数很好地配合并返回起点。 在 2.0.0 中，它像任何其他 multilinestring一样只返回 NULL。

更改：2.3.0：负索引可用（-1 是最后一点）

示例

-- Extract all POINTs from a LINESTRING
SELECT ST_AsText(
   ST_PointN(
          column1,
          generate_series(1, ST_NPoints(column1))
   ))
FROM ( VALUES ('LINESTRING(0 0, 1 1, 2 2)'::geometry) ) AS foo;

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

--Example circular string
SELECT ST_AsText(ST_PointN(ST_GeomFromText('CIRCULARSTRING(1 2, 3 2, 1 2)'), 2));

 st_astext
------------
 POINT(3 2)
(1 row)

SELECT ST_AsText(f)
FROM ST_GeomFromText('LINESTRING(0 0 0, 1 1 1, 2 2 2)') AS g
  ,ST_PointN(g, -2) AS f; -- 1 based index

    st_astext
-----------------
 POINT Z (1 1 1)
(1 row)

相关信息

ST_NPoints