ALineString
由
Point
值组成。您可以提取 a 的特定点LineString
,计算它包含的点数,或获取它的长度。
本节中的一些函数也适用于
MultiLineString
值。
除非另有说明,本节中的函数按如下方式处理它们的几何参数:
如果任何参数是
NULL
或任何几何参数是空几何,则返回值为NULL
。如果任何几何参数不是语法上格式正确的几何,
ER_GIS_INVALID_DATA
则会发生错误。如果任何几何参数是未定义空间参考系统 (SRS) 中语法上格式正确的几何,
ER_SRS_NOT_FOUND
则会发生错误。否则,返回值为非
NULL
。
这些函数可用于获取线串属性:
返回值
Point
的端点。LineString
ls
ST_EndPoint()
如本节介绍中所述处理其参数。mysql> SET @ls = 'LineString(1 1,2 2,3 3)'; mysql> SELECT ST_AsText(ST_EndPoint(ST_GeomFromText(@ls))); +----------------------------------------------+ | ST_AsText(ST_EndPoint(ST_GeomFromText(@ls))) | +----------------------------------------------+ | POINT(3 3) | +----------------------------------------------+
对于
LineString
valuels
,ST_IsClosed()
如果闭合则返回 1ls
(即它ST_StartPoint()
和ST_EndPoint()
值相同)。对于
MultiLineString
valuels
,ST_IsClosed()
如果关闭则返回 1ls
(也就是说, 对于每个in , theST_StartPoint()
和 的ST_EndPoint()
值都相同)。LineString
ls
ST_IsClosed()
ls
如果未关闭 则返回 0,如果NULL
是ls
则 返回 0NULL
。ST_IsClosed()
如本节介绍中所述处理其参数,但以下情况除外:如果几何具有地理空间参考系统 (SRS) 的 SRID 值,
ER_NOT_IMPLEMENTED_FOR_GEOGRAPHIC_SRS
则会发生错误。
mysql> SET @ls1 = 'LineString(1 1,2 2,3 3,2 2)'; mysql> SET @ls2 = 'LineString(1 1,2 2,3 3,1 1)'; mysql> SELECT ST_IsClosed(ST_GeomFromText(@ls1)); +------------------------------------+ | ST_IsClosed(ST_GeomFromText(@ls1)) | +------------------------------------+ | 0 | +------------------------------------+ mysql> SELECT ST_IsClosed(ST_GeomFromText(@ls2)); +------------------------------------+ | ST_IsClosed(ST_GeomFromText(@ls2)) | +------------------------------------+ | 1 | +------------------------------------+ mysql> SET @ls3 = 'MultiLineString((1 1,2 2,3 3),(4 4,5 5))'; mysql> SELECT ST_IsClosed(ST_GeomFromText(@ls3)); +------------------------------------+ | ST_IsClosed(ST_GeomFromText(@ls3)) | +------------------------------------+ | 0 | +------------------------------------+
返回一个双精度数字,指示
LineString
orMultiLineString
值ls
在其关联空间参考系统中的长度。值的长度MultiLineString
等于其元素的长度之和。ST_Length()
计算结果如下:如果几何
LineString
在笛卡尔 SRS 中有效,则返回值是几何的笛卡尔长度。如果几何
MultiLineString
在笛卡尔 SRS 中有效,则返回值是其元素的笛卡尔长度之和。如果几何
LineString
在地理 SRS 中有效,则返回值是该 SRS 中几何的大地测量长度,以米为单位。如果几何
MultiLineString
在地理 SRS 中有效,则返回值是该 SRS 中其元素的大地测量长度之和,以米为单位。
ST_Length()
按照本节介绍中的描述处理其参数,但有以下例外:如果几何不是
LineString
或MultiLineString
,则返回值为NULL
。如果几何在几何上无效,则结果要么是未定义的长度(即,它可以是任何数字),要么会发生错误。
如果长度计算结果为
+inf
,则发生ER_DATA_OUT_OF_RANGE
错误。如果几何图形的地理 SRS 的经度或纬度超出范围,则会发生错误:
如果经度值不在 (−180, 180] 范围内,
ER_GEOMETRY_PARAM_LONGITUDE_OUT_OF_RANGE
则会发生错误(ER_LONGITUDE_OUT_OF_RANGE
MySQL 8.0.12 之前)。如果纬度值不在 [−90, 90] 范围内,
ER_GEOMETRY_PARAM_LATITUDE_OUT_OF_RANGE
则会发生错误(ER_LATITUDE_OUT_OF_RANGE
MySQL 8.0.12 之前)。
显示的范围以度为单位。由于浮点运算,确切的范围限制略有偏差。
从 MySQL 8.0.16 开始,
ST_Length()
允许一个可选unit
参数指定返回长度值的线性单位。这些规则适用:如果指定了一个单位但 MySQL 不支持,
ER_UNIT_NOT_FOUND
则会发生错误。如果指定了支持的线性单位且 SRID 为 0,
ER_GEOMETRY_IN_UNKNOWN_LENGTH_UNIT
则会发生错误。如果指定了支持的线性单位且 SRID 不为 0,则结果采用该单位。
如果未指定单位,则结果采用几何 SRS 的单位,无论是笛卡尔还是地理。目前,所有 MySQL SRS 均以米为单位表示。
如果在
INFORMATION_SCHEMA
ST_UNITS_OF_MEASURE
表中找到单位,则支持该单位。请参阅 第 26.3.37 节,“INFORMATION_SCHEMA ST_UNITS_OF_MEASURE 表”。mysql> SET @ls = ST_GeomFromText('LineString(1 1,2 2,3 3)'); mysql> SELECT ST_Length(@ls); +--------------------+ | ST_Length(@ls) | +--------------------+ | 2.8284271247461903 | +--------------------+ mysql> SET @mls = ST_GeomFromText('MultiLineString((1 1,2 2,3 3),(4 4,5 5))'); mysql> SELECT ST_Length(@mls); +-------------------+ | ST_Length(@mls) | +-------------------+ | 4.242640687119286 | +-------------------+ mysql> SET @ls = ST_GeomFromText('LineString(1 1,2 2,3 3)', 4326); mysql> SELECT ST_Length(@ls); +-------------------+ | ST_Length(@ls) | +-------------------+ | 313701.9623204328 | +-------------------+ mysql> SELECT ST_Length(@ls, 'metre'); +-------------------------+ | ST_Length(@ls, 'metre') | +-------------------------+ | 313701.9623204328 | +-------------------------+ mysql> SELECT ST_Length(@ls, 'foot'); +------------------------+ | ST_Length(@ls, 'foot') | +------------------------+ | 1029205.9131247795 | +------------------------+
返回 value 中的对象
Point
数。LineString
ls
ST_NumPoints()
如本节介绍中所述处理其参数。mysql> SET @ls = 'LineString(1 1,2 2,3 3)'; mysql> SELECT ST_NumPoints(ST_GeomFromText(@ls)); +------------------------------------+ | ST_NumPoints(ST_GeomFromText(@ls)) | +------------------------------------+ | 3 | +------------------------------------+
返回value 中 的
N
第 -th 个 。点从 1 开始编号。Point
Linestring
ls
ST_PointN()
如本节介绍中所述处理其参数。mysql> SET @ls = 'LineString(1 1,2 2,3 3)'; mysql> SELECT ST_AsText(ST_PointN(ST_GeomFromText(@ls),2)); +----------------------------------------------+ | ST_AsText(ST_PointN(ST_GeomFromText(@ls),2)) | +----------------------------------------------+ | POINT(2 2) | +----------------------------------------------+
返回值
Point
的起点。LineString
ls
ST_StartPoint()
如本节介绍中所述处理其参数。mysql> SET @ls = 'LineString(1 1,2 2,3 3)'; mysql> SELECT ST_AsText(ST_StartPoint(ST_GeomFromText(@ls))); +------------------------------------------------+ | ST_AsText(ST_StartPoint(ST_GeomFromText(@ls))) | +------------------------------------------------+ | POINT(1 1) | +------------------------------------------------+