12.17.6 几何格式转换函数_MySQL 5.7 参考手册

MySQL 8.0 参考手册 / 第 12 章函数和运算符 / 12.17空间分析函数 / 12.17.6 几何格式转换函数

12.17.6 几何格式转换函数

MySQL 支持本节中列出的函数，用于将几何值从内部几何格式转换为 WKT 或 WKB 格式。

还有一些函数可以将字符串从 WKT 或 WKB 格式转换为内部几何格式。请参阅第 12.17.3 节，“从 WKT 值创建几何值的函数”和第 12.17.4 节，“从 WKB 值创建几何值的函数”。

AsBinary(g), AsWKB(g)
ST_AsBinary(), ST_AsWKB(), AsBinary()和 AsWKB() 是同义词。有关详细信息，请参阅的说明 ST_AsBinary()。
AsBinary()并被 AsWKB() 弃用；希望它们在未来的 MySQL 版本中被删除。使用ST_AsBinary()and ST_AsWKB() 代替。
AsText(g), AsWKT(g)
ST_AsText(), ST_AsWKT(), AsText()和 AsWKT()是同义词。有关详细信息，请参阅的说明 ST_AsText()。
AsText()并被 AsWKT()弃用；希望它们在未来的 MySQL 版本中被删除。使用ST_AsText()and ST_AsWKT() 代替。
ST_AsBinary(g), ST_AsWKB(g)
将内部几何格式的值转换为其 WKB 表示形式并返回二进制结果。
如果参数是NULL，则返回值为NULL。如果参数不是语法上格式正确的几何图形， ER_GIS_INVALID_DATA则会发生错误。
```
SELECT ST_AsBinary(g) FROM geom;
```
ST_AsBinary(), ST_AsWKB(), AsBinary()和 AsWKB() 是同义词。

ST_AsText(g), ST_AsWKT(g)

将内部几何格式的值转换为其 WKT 表示形式并返回字符串结果。

如果参数是NULL，则返回值为NULL。如果参数不是语法上格式正确的几何图形， ER_GIS_INVALID_DATA则会发生错误。

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)        |
+--------------------------------+

ST_AsText(), ST_AsWKT(), AsText()和 AsWKT()是同义词。

值的输出MultiPoint包括每个点周围的括号。例如：

mysql> SET @mp = 'MULTIPOINT(1 1, 2 2, 3 3)';
mysql> SELECT ST_AsText(ST_GeomFromText(@mp));
+---------------------------------+
| ST_AsText(ST_GeomFromText(@mp)) |
+---------------------------------+
| MULTIPOINT((1 1),(2 2),(3 3))   |
+---------------------------------+