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

这些函数将熟知文本(WKT)table 示形式以及可选的空间参考系统标识符(SRID)作为参数。它们返回相应的几何。

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

有关 WKT 格式的说明,请参见众所周知的文本(WKT)格式

GeomCollFromText(wkt[, srid]), GeometryCollectionFromText(wkt[, srid])

ST_GeomCollFromText()ST_GeometryCollectionFromText()ST_GeomCollFromTxt()GeomCollFromText()GeometryCollectionFromText()是同义词。有关更多信息,请参见ST_GeomCollFromText()的描述。

GeomCollFromText()GeometryCollectionFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_GeomCollFromText()ST_GeometryCollectionFromText()

GeomFromText(wkt[, srid]), GeometryFromText(wkt[, srid])

ST_GeomFromText()ST_GeometryFromText()GeomFromText()GeometryFromText()是同义词。有关更多信息,请参见ST_GeomFromText()的描述。

GeomFromText()GeometryFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_GeomFromText()ST_GeometryFromText()

LineFromText(wkt[, srid]), LineStringFromText(wkt[, srid])

ST_LineFromText()ST_LineStringFromText()LineFromText()LineStringFromText()是同义词。有关更多信息,请参见ST_LineFromText()的描述。

LineFromText()LineStringFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_LineFromText()ST_LineStringFromText()

MLineFromText(wkt[, srid]), MultiLineStringFromText(wkt[, srid])

ST_MLineFromText()ST_MultiLineStringFromText()MLineFromText()MultiLineStringFromText()是同义词。有关更多信息,请参见ST_MLineFromText()的描述。

MLineFromText()MultiLineStringFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_MLineFromText()ST_MultiLineStringFromText()

MPointFromText(wkt[, srid]), MultiPointFromText(wkt[, srid])

ST_MPointFromText()ST_MultiPointFromText()MPointFromText()MultiPointFromText()是同义词。有关更多信息,请参见ST_MPointFromText()的描述。

MPointFromText()MultiPointFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_MPointFromText()ST_MultiPointFromText()

MPolyFromText(wkt[, srid]), MultiPolygonFromText(wkt[, srid])

ST_MPolyFromText()ST_MultiPolygonFromText()MPolyFromText()MultiPolygonFromText()是同义词。有关更多信息,请参见ST_MPolyFromText()的描述。

MPolyFromText()MultiPolygonFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_MPolyFromText()ST_MultiPolygonFromText()

PointFromText(wkt[, srid])

ST_PointFromText()PointFromText()是同义词。有关更多信息,请参见ST_PointFromText()的描述。

PointFromText()已过时,将在以后的 MySQL 版本中删除。请改用ST_PointFromText()

PolyFromText(wkt[, srid]), PolygonFromText(wkt[, srid])

ST_PolyFromText()ST_PolygonFromText()PolyFromText()PolygonFromText()是同义词。有关更多信息,请参见ST_PolyFromText()的描述。

PolyFromText()PolygonFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_PolyFromText()ST_PolygonFromText()

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

使用其 WKTtable 示形式和 SRID 构造一个GeometryCollection值。

如果 geometry 参数为NULL或语法上格式不正确的几何,或者 SRID 参数为NULL,则返回值为NULL

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_GeomCollFromText()ST_GeometryCollectionFromText()ST_GeomCollFromTxt()GeomCollFromText()GeometryCollectionFromText()是同义词。

ST_GeomFromText(wkt[, srid]), ST_GeometryFromText(wkt[, srid])

使用其 WKTtable 示形式和 SRID 构造任何类型的几何值。

如果 geometry 参数为NULL或语法上格式不正确的几何,或者 SRID 参数为NULL,则返回值为NULL

ST_GeomFromText()ST_GeometryFromText()GeomFromText()GeometryFromText()是同义词。

ST_LineFromText(wkt[, srid]), ST_LineStringFromText(wkt[, srid])

使用其 WKTtable 示形式和 SRID 构造一个LineString值。

如果 geometry 参数为NULL或语法上格式不正确的几何,或者 SRID 参数为NULL,则返回值为NULL

ST_LineFromText()ST_LineStringFromText()LineFromText()LineStringFromText()是同义词。

ST_MLineFromText(wkt[, srid]), ST_MultiLineStringFromText(wkt[, srid])

使用其 WKTtable 示形式和 SRID 构造一个MultiLineString值。

如果 geometry 参数为NULL或语法上格式不正确的几何,或者 SRID 参数为NULL,则返回值为NULL

ST_MLineFromText()ST_MultiLineStringFromText()MLineFromText()MultiLineStringFromText()是同义词。

ST_MPointFromText(wkt[, srid]), ST_MultiPointFromText(wkt[, srid])

使用其 WKTtable 示形式和 SRID 构造一个MultiPoint值。

如果 geometry 参数为NULL或语法上格式不正确的几何,或者 SRID 参数为NULL,则返回值为NULL

接受MultiPoint值的 WKT 格式 table 示的ST_MPointFromText()ST_GeomFromText()之类的函数允许用括号将值内的各个点括起来。例如,以下两个函数调用均有效:

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

ST_MPointFromText()ST_MultiPointFromText()MPointFromText()MultiPointFromText()是同义词。

ST_MPolyFromText(wkt[, srid]), ST_MultiPolygonFromText(wkt[, srid])

使用其 WKTtable 示形式和 SRID 构造一个MultiPolygon值。

如果 geometry 参数为NULL或语法上格式不正确的几何,或者 SRID 参数为NULL,则返回值为NULL

ST_MPolyFromText()ST_MultiPolygonFromText()MPolyFromText()MultiPolygonFromText()是同义词。

ST_PointFromText(wkt[, srid])

使用其 WKTtable 示形式和 SRID 构造一个Point值。

如果 geometry 参数为NULL或语法上格式不正确的几何,或者 SRID 参数为NULL,则返回值为NULL

ST_PointFromText()PointFromText()是同义词。

ST_PolyFromText(wkt[, srid]), ST_PolygonFromText(wkt[, srid])

使用其 WKTtable 示形式和 SRID 构造一个Polygon值。

如果 geometry 参数为NULL或语法上格式不正确的几何,或者 SRID 参数为NULL,则返回值为NULL

ST_PolyFromText()ST_PolygonFromText()PolyFromText()PolygonFromText()是同义词。