ST_StartPoint
上一個  7.4. 幾何存取器  下一個

名稱

ST_StartPoint — 傳回 LineString 的第一個點。

概要

geometry ST_StartPoint(geometry geomA);

描述

以 POINT 形式傳回 LINESTRING 或 CIRCULARLINESTRING 幾何的第一個點。如果輸入不是 LINESTRING 或 CIRCULARLINESTRING，則傳回 NULL。

此方法實作了 SQL/MM 規範。SQL-MM 3: 7.1.3

此函數支援 3D，並且不會捨棄 z 索引。

此方法支援圓形字串和曲線。

[Note]

增強功能：3.2.0 為所有幾何圖形傳回一個點。先前的行為是在輸入不是 LineString 時傳回 NULL。

已變更：2.0.0 不再適用於單一幾何 MultiLineString。在舊版本的 PostGIS 中，單線 MultiLineString 可以順利地使用此函數並傳回起始點。在 2.0.0 中，它就像任何其他 MultiLineString 一樣只會傳回 NULL。舊的行為是一個未經記錄的功能，但是假設它們的資料儲存為 LINESTRING 的使用者可能會在 2.0.0 中遇到這些傳回 NULL 的情況。

範例

LineString 的起始點

SELECT ST_AsText(ST_StartPoint('LINESTRING(0 1, 0 2)'::geometry));
 st_astext
------------
 POINT(0 1)

非 LineString 的起始點為 NULL

SELECT ST_StartPoint('POINT(0 1)'::geometry) IS NULL AS is_null;
  is_null
----------
 t

3D LineString 的起始點

SELECT ST_AsEWKT(ST_StartPoint('LINESTRING(0 1 1, 0 2 2)'::geometry));
 st_asewkt
------------
 POINT(0 1 1)

CircularString 的起始點

SELECT ST_AsText(ST_StartPoint('CIRCULARSTRING(5 2,-3 1.999999, -2 1, -4 2, 6 3)'::geometry));
 st_astext
------------
 POINT(5 2)

另請參閱

ST_EndPoint、ST_PointN