MySQL 支持本节中列出的函数,用于将几何值从内部几何格式转换为 WKT 或 WKB 格式,或者用于交换 X 和 Y 坐标的顺序。
还有一些函数可以将字符串从 WKT 或 WKB 格式转换为内部几何格式。请参阅 第 12.17.3 节,“从 WKT 值创建几何值的函数”和 第 12.17.4 节,“从 WKB 值创建几何值的函数”。
诸如ST_GeomFromText()
接受 WKT 几何集合参数的函数理解 OpenGIS'GEOMETRYCOLLECTION EMPTY'
标准语法和 MySQL'GEOMETRYCOLLECTION()'
非标准语法。生成空几何集合的另一种方法是
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 |
+--------------------------+--------------------------+
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
=value
key
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) | +----------------------------+