这些函数接受参数a斑点
包含众所周知的二进制(WKB)表示,并且可选地,空间参考系统标识符(SRID)。它们返回相应的几何形状。有关WKB格式的描述,请参阅众所周知的二进制(WKB)格式.
本节中的函数检测笛卡尔或地理空间参考系统(SRS)中的参数,并返回适合于SRS的结果。
st_geom fromwkb()
接受任意几何类型的WKB值作为第一个参数。其他函数提供特定于类型的构造函数,用于构造每个几何类型的几何值。
在MySQL 8.0之前,这些函数也接受了函数返回的几何对象第12.17.5节“创建几何值的MySQL特定函数”.不再允许几何参数并产生错误。要将调用从使用几何参数迁移到使用WKB参数,请遵循以下原则:
重写构造,如
st_geom fromwkb(point(0,0))
作为点(0,0)
.重写构造,如
ST_GeomFromWKB(点(0,0),4326)
作为ST_SRID(点(0,0),4326)
或者ST_GeomFromWKB (ST_AsWKB(点(0,0)),4326)
.
除非另有说明,本节中的函数处理其几何参数的方式如下:
如果WKB或SRID参数是
空值
,返回值为空值
.默认情况下,地理坐标(纬度、经度)按照几何参数的空间参考系统指定的顺序进行解释。一个可选的
选项
参数可以重写默认的轴顺序。选项
由逗号分隔的列表组成
.唯一允许关键
=价值
关键
价值是轴顺序
,允许值拉龙
,long-lat
和srid-defined
(默认)。如果
选项
参数是空值
,返回值为空值
.如果选项
参数无效,发生错误以指示为什么。如果SRID参数是指未定义的空间参考系统(SRS),则
er_srs_not_found.
发生错误。对于地理SRS几何参数,如果任何参数具有超出范围的经度或纬度,则会发生错误:
如果经度值不在(−180,180)范围内,则表示
er_longitude_out_of_range.
发生错误。如果纬度值不在[−90,90]范围内,则表示
ER_LATITUDE_OUT_OF_RANGE
发生错误。
范围以度数表示。如果一个SRS使用另一个单元,则该范围使用其单元中相应的值。由于浮点运算,确切的范围限制略有偏差。
这些函数可用于从WKB值创建几何图形:
ST_GeomCollFromWKB (
,wkb
[,萨里德
[,选项
]])ST_GeometryCollectionFromWKB (
wkb
[,萨里德
[,选项
]])构造一个
GeometryCollection
值,使用其WKB表示和SRID。这些函数处理它们的参数,如本节介绍中所述。
st_geom fromwkb(
,wkb
[,萨里德
[,选项
]])st_geometryfromwkb(
wkb
[,萨里德
[,选项
]])使用WKB表示和SRID构造任意类型的几何值。
这些函数处理它们的参数,如本节介绍中所述。
st_linefromwkb(
,wkb
[,萨里德
[,选项
]])st_linestringfromwkb(
wkb
[,萨里德
[,选项
]])构造一个
LineString
值,使用其WKB表示和SRID。这些函数处理它们的参数,如本节介绍中所述。
st_mlinefromwkb(
,wkb
[,萨里德
[,选项
]])st_multilinestringfromwkb(
wkb
[,萨里德
[,选项
]])构造一个
多重原因
值,使用其WKB表示和SRID。这些函数处理它们的参数,如本节介绍中所述。
ST_MPointFromWKB (
,wkb
[,萨里德
[,选项
]])ST_MultiPointFromWKB (
wkb
[,萨里德
[,选项
]])构造一个
多点
值,使用其WKB表示和SRID。这些函数处理它们的参数,如本节介绍中所述。
ST_MPolyFromWKB (
,wkb
[,萨里德
[,选项
]])st_multipolygonfromwkb(
wkb
[,萨里德
[,选项
]])构造一个
多个多边形
值,使用其WKB表示和SRID。这些函数处理它们的参数,如本节介绍中所述。
ST_PointFromWKB (
wkb
[,萨里德
[,选项
]])构造一个
观点
值,使用其WKB表示和SRID。ST_PointFromWKB ()
处理其参数,如本节简介中所述。ST_PolyFromWKB (
,wkb
[,萨里德
[,选项
]])ST_PolygonFromWKB (
wkb
[,萨里德
[,选项
]])构造一个
多边形
值,使用其WKB表示和SRID。这些函数处理它们的参数,如本节介绍中所述。