Name

ST_StartPoint — 返回 LineString 的第一个点.

Synopsis

geometry ST_StartPoint(geometry geomA);

描述

返回LINESTRINGCIRCULARLINESTRING 几何图形的第一个点作为POINT。 如果输入不是LINESTRINGCIRCULARLINESTRING,则返回 NULL

该方法实现了SQL/MM规范。 SQL-MM 3: 7.1.3

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

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

[Note]

增强: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)

相关信息

ST_EndPoint, ST_PointN