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

名稱

ST_EndPoint — 傳回 LineString 或 CircularLineString 的最後一點。

概要

geometry ST_EndPoint(geometry g);

描述

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

這個方法實作了 SQL/MM 規格。SQL-MM 3: 7.1.4

這個函數支援 3D 並不會捨棄 z 索引。

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

[Note]

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

範例

LineString 的端點

postgis=# SELECT ST_AsText(ST_EndPoint('LINESTRING(1 1, 2 2, 3 3)'::geometry));
 st_astext
------------
 POINT(3 3)

非 LineString 的端點為 NULL

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

3D LineString 的端點

--3d endpoint
SELECT ST_AsEWKT(ST_EndPoint('LINESTRING(1 1 2, 1 2 3, 0 0 5)'));
  st_asewkt
--------------
 POINT(0 0 5)

CircularString 的端點

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