Name
ST_StartPoint — 返回 LineString 的第一个点.
Synopsis
geometry ST_StartPoint(geometry geomA);
描述
返回LINESTRING 或 CIRCULARLINESTRING 几何图形的第一个点作为POINT。 如果输入不是LINESTRING 或 CIRCULARLINESTRING，则返回 NULL。
该方法实现了SQL/MM规范。 SQL-MM 3: 7.1.3
该函数支持 3d 并且不会丢失 z-index。
此方法支持圆形字符串和曲线。
![[Note]](../images/note.png)
|
|
|
增强：3.2.0 返回所有几何图形的点。 如果输入不是 LineString，则先前的行为将返回 NULL。 更改：2.0.0 不再适用于单个几何体 MultiLineStrings。 在旧版本的 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)