这些函数将一个众所周知的文本(WKT)表示作为参数,还可以选择一个空间引用系统标识符(SRID)。它们返回相应的几何图形。有关WKT格式的说明,请参见WKT格式.
本节中的函数检测笛卡尔或地理空间参考系统(SRS)中的参数,并返回适合SRS的结果。
ST_GeomFromText ()
接受任意几何类型的WKT值作为第一个参数。其他函数提供特定于类型的构造函数,用于构造每个几何类型的几何值。
函数如ST_MPointFromText ()
而且ST_GeomFromText ()
的wkt格式表示多点
值允许值内的单个点用圆括号括起来。例如,下面两个函数调用都是有效的:
ST_MPointFromText('MULTIPOINT (1,1,2,3)') ST_MPointFromText('MULTIPOINT ((1 1), (2 2), (3 3))')
函数如ST_GeomFromText ()
接受WKT几何集合参数的OpenGIS“GEOMETRYCOLLECTION空”
标准语法和MySQL“GEOMETRYCOLLECTION()”
非标准语法。函数如ST_AsWKT ()
产生WKT值“GEOMETRYCOLLECTION空”
标准的语法:
mysql> SET @s1 = ST_GeomFromText('GEOMETRYCOLLECTION()');mysql> SET @s2 = ST_GeomFromText('几何集合空');mysql> SELECT ST_AsWKT(@s1), ST_AsWKT(@s2);+--------------------------+--------------------------+ | ST_AsWKT (@s1) | ST_AsWKT (@s2 ) | +--------------------------+--------------------------+ | GEOMETRYCOLLECTION空| GEOMETRYCOLLECTION空的 | +--------------------------+--------------------------+
除非另有说明,本节中的函数以如下方式处理它们的几何参数:
如果任何几何参数为
零
或者不是一个语法结构良好的几何,或者如果SRID参数是零
,返回值为零
.默认情况下,地理坐标(纬度、经度)按照几何参数的空间参考系统指定的顺序进行解释。一个可选的
选项
参数可以覆盖默认的轴顺序。选项
由逗号分隔的列表组成
.唯一允许的关键
=价值
关键
值是axis-order
的允许值坐标
,long-lat
而且srid-defined
(默认)。如果
选项
参数是零
,返回值为零
.如果选项
参数无效,则发生错误以指示原因。如果一个SRID参数引用一个未定义的空间参考系统(SRS),则一个
ER_SRS_NOT_FOUND
发生错误。对于地理SRS几何参数,如果任何参数具有超出范围的经度或纬度,则会发生错误:
如果经度值不在(−180,180])范围内,则an
ER_LONGITUDE_OUT_OF_RANGE
发生错误。如果纬度值不在[- 90,90]范围内,则使用
ER_LATITUDE_OUT_OF_RANGE
发生错误。
范围以度为单位。如果SRS使用另一个单位,则范围使用其单位中相应的值。由于浮点运算,精确的范围限制略有偏差。
这些函数可用于从WKT值创建几何图形:
ST_GeomCollFromText (
,wkt
(,srid
(,选项
]])ST_GeometryCollectionFromText (
,wkt
(,srid
(,选项
]])ST_GeomCollFromTxt (
wkt
(,srid
(,选项
]])构造一个
GeometryCollection
值使用它的WKT表示和SRID。这些函数按照本节介绍中的描述处理它们的参数。
mysql> SET @g = "MULTILINESTRING((10 10, 11 11), (9 9, 10 10))";SELECT ST_AsText(ST_GeomCollFromText(@g));+--------------------------------------------+ | ST_AsText (ST_GeomCollFromText (@g )) | +--------------------------------------------+ | MULTILINESTRING ((10 10, 11 11), (9 9, 10 10 )) | +--------------------------------------------+
ST_GeomFromText (
,wkt
(,srid
(,选项
]])ST_GeometryFromText (
wkt
(,srid
(,选项
]])使用其WKT表示和SRID构造任意类型的几何值。
这些函数按照本节介绍中的描述处理它们的参数。
ST_LineFromText (
,wkt
(,srid
(,选项
]])ST_LineStringFromText (
wkt
(,srid
(,选项
]])构造一个
LineString
值使用它的WKT表示和SRID。这些函数按照本节介绍中的描述处理它们的参数。
ST_MLineFromText (
,wkt
(,srid
(,选项
]])ST_MultiLineStringFromText (
wkt
(,srid
(,选项
]])构造一个
MultiLineString
值使用它的WKT表示和SRID。这些函数按照本节介绍中的描述处理它们的参数。
ST_MPointFromText (
,wkt
(,srid
(,选项
]])ST_MultiPointFromText (
wkt
(,srid
(,选项
]])构造一个
多点
值使用它的WKT表示和SRID。这些函数按照本节介绍中的描述处理它们的参数。
ST_MPolyFromText (
,wkt
(,srid
(,选项
]])ST_MultiPolygonFromText (
wkt
(,srid
(,选项
]])构造一个
多个多边形
值使用它的WKT表示和SRID。这些函数按照本节介绍中的描述处理它们的参数。
ST_PointFromText (
wkt
(,srid
(,选项
]])构造一个
点
值使用它的WKT表示和SRID。ST_PointFromText ()
按照本节介绍中的描述处理其参数。ST_PolyFromText (
,wkt
(,srid
(,选项
]])ST_PolygonFromText (
wkt
(,srid
(,选项
]])构造一个
多边形
值使用它的WKT表示和SRID。这些函数按照本节介绍中的描述处理它们的参数。