st_startpoint 函数

适用于： Databricks Runtime 17.1 及更高版本

如果输入地理空间值为非空线字符串，则返回输入 GEOGRAPHY 或 GEOMETRY 值的第一个点。 否则返回 NULL。

语法

st_startpoint ( geoExpr )

论据

• geoExpr：一个GEOGRAPHY或者GEOMETRY值，用以表示线字符串。

退货

类型为GEOGRAPHY或GEOMETRY的值，代表线字符串的第一个点。

输出点的 SRID 值与输入值的值相同。

输出点的维度与输入线字符串的维度相同。

如果输入为 NULL.，则函数返回 NULL 。

错误条件

• 如果该值 geoExpr 不是线字符串，则函数将返回 ST_INVALID_ARGUMENT_TYPE。
• 如果值为 geoExpr 空行字符串，则函数将返回 ST_INVALID_ARGUMENT_TYPE。

例子

-- Returns first point of linestring with SRID.
> SELECT st_asewkt(st_startpoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)', 4326)));
  SRID=4326;POINT(1 2)
-- Returns first point with ZM coordinates.
> SELECT st_asewkt(st_startpoint(st_geogfromtext('LINESTRING ZM (1 2 3 4,5 6 7 8)')));
  SRID=4326;POINT ZM (1 2 3 4)

相关函数

• st_endpoint 函数
• st_geometryn 函数