MySQL 9.0 发行说明
MySQL 支持本节中列出的函数，用于将几何图形值从内部几何图形格式转换为 WKT 或 WKB 格式，或者交换 X 和 Y 坐标的顺序。
也有一些函数可以将字符串从 WKT 或 WKB 格式转换为内部几何图形格式。请参阅第 14.16.3 节“从 WKT 值创建几何图形值的函数”和第 14.16.4 节“从 WKB 值创建几何图形值的函数”。
诸如ST_GeomFromText()之类的接受 WKT 几何图形集合参数的函数，既理解 OpenGIS 'GEOMETRYCOLLECTION EMPTY' 标准语法，也理解 MySQL 'GEOMETRYCOLLECTION()' 非标准语法。生成空几何图形集合的另一种方法是调用不带参数的GeometryCollection()。诸如ST_AsWKT()之类的生成 WKT 值的函数会生成'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 |
+--------------------------+--------------------------+
mysql> SELECT ST_AsWKT(GeomCollection());
+----------------------------+
| ST_AsWKT(GeomCollection()) |
+----------------------------+
| GEOMETRYCOLLECTION EMPTY |
+----------------------------+除非另有说明，否则本节中的函数按如下方式处理其几何图形参数：
如果任何参数为
NULL，则返回值为NULL。如果任何几何图形参数不是语法上格式良好的几何图形，则会发生
ER_GIS_INVALID_DATA错误。如果任何几何图形参数位于未定义的空间参考系统中，则轴会按其在几何图形中出现的顺序输出，并且会发生
ER_WARN_SRS_NOT_FOUND_AXIS_ORDER警告。默认情况下，地理坐标（纬度、经度）的解释顺序与适用于几何图形参数的空间参考系统中指定的顺序相同。可以提供可选的
options参数来覆盖默认轴顺序。options由逗号分隔的key=valuekey值是axis-order，允许的值为lat-long、long-lat和srid-defined（默认值）。如果
options参数为NULL，则返回值为NULL。如果options参数无效，则会发生错误以指示原因。否则，返回值为非
NULL。
这些函数可用于格式转换或坐标交换：
ST_AsBinary(,g[,options])ST_AsWKB(g[,options])将内部几何图形格式的值转换为其 WKB 表示形式，并返回二进制结果。
函数返回值的地理坐标（纬度、经度）顺序由适用于几何图形参数的空间参考系统指定。可以提供可选的
options参数来覆盖默认轴顺序。ST_AsBinary()和ST_AsWKB()的参数处理方式如本节开头所述。mysql> SET @g = ST_LineFromText('LINESTRING(0 5,5 10,10 15)', 4326); mysql> SELECT ST_AsText(ST_GeomFromWKB(ST_AsWKB(@g))); +-----------------------------------------+ | ST_AsText(ST_GeomFromWKB(ST_AsWKB(@g))) | +-----------------------------------------+ | LINESTRING(5 0,10 5,15 10) | +-----------------------------------------+ mysql> SELECT ST_AsText(ST_GeomFromWKB(ST_AsWKB(@g, 'axis-order=long-lat'))); +----------------------------------------------------------------+ | ST_AsText(ST_GeomFromWKB(ST_AsWKB(@g, 'axis-order=long-lat'))) | +----------------------------------------------------------------+ | LINESTRING(0 5,5 10,10 15) | +----------------------------------------------------------------+ mysql> SELECT ST_AsText(ST_GeomFromWKB(ST_AsWKB(@g, 'axis-order=lat-long'))); +----------------------------------------------------------------+ | ST_AsText(ST_GeomFromWKB(ST_AsWKB(@g, 'axis-order=lat-long'))) | +----------------------------------------------------------------+ | LINESTRING(5 0,10 5,15 10) | +----------------------------------------------------------------+ST_AsText(,g[,options])ST_AsWKT(g[,options])将内部几何图形格式的值转换为其 WKT 表示形式，并返回字符串结果。
函数返回值的地理坐标（纬度、经度）顺序由适用于几何图形参数的空间参考系统指定。可以提供可选的
options参数来覆盖默认轴顺序。ST_AsText()和ST_AsWKT()的参数处理方式如本节开头所述。mysql> SET @g = 'LineString(1 1,2 2,3 3)'; mysql> SELECT ST_AsText(ST_GeomFromText(@g)); +--------------------------------+ | ST_AsText(ST_GeomFromText(@g)) | +--------------------------------+ | LINESTRING(1 1,2 2,3 3) | +--------------------------------+MultiPoint值的输出包括每个点周围的括号。例如：mysql> SELECT ST_AsText(ST_GeomFromText(@mp)); +---------------------------------+ | ST_AsText(ST_GeomFromText(@mp)) | +---------------------------------+ | MULTIPOINT((1 1),(2 2),(3 3)) | +---------------------------------+接受内部几何图形格式的参数，交换几何图形中每个坐标对的 X 和 Y 值，并返回结果。
ST_SwapXY()的参数处理方式如本节开头所述。mysql> SET @g = ST_LineFromText('LINESTRING(0 5,5 10,10 15)'); mysql> SELECT ST_AsText(@g); +----------------------------+ | ST_AsText(@g) | +----------------------------+ | LINESTRING(0 5,5 10,10 15) | +----------------------------+ mysql> SELECT ST_AsText(ST_SwapXY(@g)); +----------------------------+ | ST_AsText(ST_SwapXY(@g)) | +----------------------------+ | LINESTRING(5 0,10 5,15 10) | +----------------------------+