MySQL :: MySQL 8.4 参考手册 :: 14.16.3 从 WKT 值创建几何值的函数

版本 8.4

9.0
8.0
5.7

8.0 日语

MySQL 8.4 参考手册 / ... / 从 WKT 值创建几何值的函数

14.16.3 从 WKT 值创建几何值的函数

这些函数将熟知文本 (WKT) 表示形式和可选的空间参考系统标识符 (SRID) 作为参数。它们返回对应的几何图形。有关 WKT 格式的说明，请参见熟知文本 (WKT) 格式。

本节中的函数检测笛卡尔或地理空间参考系统 (SRS) 中的参数，并返回适合 SRS 的结果。

ST_GeomFromText() 接受任何几何类型的 WKT 值作为其第一个参数。其他函数为每种几何类型的几何值的构造提供特定于类型的构造函数。

接受 MultiPoint 值的 WKT 格式表示的函数（如 ST_MPointFromText() 和 ST_GeomFromText()）允许值内的单个点用括号括起来。例如，以下两个函数调用都有效

ST_MPointFromText('MULTIPOINT (1 1, 2 2, 3 3)')
ST_MPointFromText('MULTIPOINT ((1 1), (2 2), (3 3))')

接受 WKT 几何集合参数的函数（如 ST_GeomFromText()）理解 OpenGIS 'GEOMETRYCOLLECTION EMPTY' 标准语法和 MySQL 'GEOMETRYCOLLECTION()' 非标准语法。生成 WKT 值的函数（如 ST_AsWKT()）生成 'GEOMETRYCOLLECTION EMPTY' 标准语法

mysql> SET @s1 = ST_GeomFromText('GEOMETRYCOLLECTION()');
mysql> SET @s2 = ST_GeomFromText('GEOMETRYCOLLECTION EMPTY');
mysql> SELECT ST_AsWKT(@s1), ST_AsWKT(@s2);
+--------------------------+--------------------------+
| ST_AsWKT(@s1)            | ST_AsWKT(@s2)            |
+--------------------------+--------------------------+
| GEOMETRYCOLLECTION EMPTY | GEOMETRYCOLLECTION EMPTY |
+--------------------------+--------------------------+

除非另有说明，否则本节中的函数按如下方式处理其几何参数

如果任何几何参数为 NULL 或不是语法上格式良好的几何图形，或者 SRID 参数为 NULL，则返回值为 NULL。
默认情况下，地理坐标（纬度、经度）按几何参数的空间参考系统指定的顺序解释。可以给出可选的 options 参数来覆盖默认轴顺序。 options 由以逗号分隔的 key=value 列表组成。唯一允许的 key 值是 axis-order，允许的值为 lat-long、long-lat 和 srid-defined（默认值）。
如果 options 参数为 NULL，则返回值为 NULL。如果 options 参数无效，则会发生错误以指示原因。
如果 SRID 参数引用未定义的空间参考系统 (SRS)，则会发生 ER_SRS_NOT_FOUND 错误。
对于地理 SRS 几何参数，如果任何参数的经度或纬度超出范围，则会发生错误
- 如果经度值不在 (−180, 180] 范围内，则会发生 ER_LONGITUDE_OUT_OF_RANGE 错误。
- 如果纬度值不在 [−90, 90] 范围内，则会发生 ER_LATITUDE_OUT_OF_RANGE 错误。
显示的范围以度为单位。如果 SRS 使用其他单位，则范围使用其单位中的相应值。由于浮点运算，确切的范围限制略有偏差。

这些函数可用于从 WKT 值创建几何图形

ST_GeomCollFromText(wkt [, srid [, options]]), ST_GeometryCollectionFromText(wkt [, srid [, options]]), ST_GeomCollFromTxt(wkt [, srid [, options]])

使用其 WKT 表示和 SRID 构造 GeometryCollection 值。

这些函数按本节简介中所述处理其参数。

mysql> SET @g = "MULTILINESTRING((10 10, 11 11), (9 9, 10 10))";
mysql> SELECT ST_AsText(ST_GeomCollFromText(@g));
+--------------------------------------------+
| ST_AsText(ST_GeomCollFromText(@g))         |
+--------------------------------------------+
| MULTILINESTRING((10 10,11 11),(9 9,10 10)) |
+--------------------------------------------+

ST_GeomFromText(wkt [, srid [, options]]), ST_GeometryFromText(wkt [, srid [, options]])
使用其 WKT 表示和 SRID 构造任何类型的几何值。
这些函数按本节简介中所述处理其参数。
ST_LineFromText(wkt [, srid [, options]]), ST_LineStringFromText(wkt [, srid [, options]])
使用其 WKT 表示和 SRID 构造 LineString 值。
这些函数按本节简介中所述处理其参数。
ST_MLineFromText(wkt [, srid [, options]]), ST_MultiLineStringFromText(wkt [, srid [, options]])
使用其 WKT 表示和 SRID 构造 MultiLineString 值。
这些函数按本节简介中所述处理其参数。
ST_MPointFromText(wkt [, srid [, options]]), ST_MultiPointFromText(wkt [, srid [, options]])
使用 WKT 表示和 SRID 构造 MultiPoint 值。
这些函数按本节简介中所述处理其参数。
ST_MPolyFromText(wkt [, srid [, options]]), ST_MultiPolygonFromText(wkt [, srid [, options]])
使用 WKT 表示和 SRID 构造 MultiPolygon 值。
这些函数按本节简介中所述处理其参数。
ST_PointFromText(wkt [, srid [, options]])
使用 WKT 表示和 SRID 构造 Point 值。
ST_PointFromText() 处理参数的方式如本节引言中所述。
ST_PolyFromText(wkt [, srid [, options]]), ST_PolygonFromText(wkt [, srid [, options]])
使用 WKT 表示和 SRID 构造 Polygon 值。
这些函数按本节简介中所述处理其参数。