19.4.2. 创建空间值_MySQL 中文文档

在本节中，介绍了使用OpenGIS标准中定义的WKT和WKB函数创建空间值的方法，以及使用相应MySQL函数的方法。

MySQL提供了众多以WKT表达式、以及可选的空间参考系ID（SRID）为输入参数的函数。它们将返回对应的几何对象。

GeomFromText()接受任何几何类型的WKT作为其第1个参量。在实施方案中也提供了与类型相关的构造函数，用于构造每一种几何类型的几何值。

GeomCollFromText(wkt[,srid]) , GeometryCollectionFromText(wkt[,srid])
使用其WKT表示和SRID构造GEOMETRYCOLLECTION值。
GeomFromText(wkt[,srid]) , GeometryFromText(wkt[,srid])
使用其WKT表示和SRID构造任何类型的几何值。
LineFromText(wkt[,srid]) , LineStringFromText(wkt[,srid])
使用其WKT表示和SRID构造LINESTRING值。
MLineFromText(wkt[,srid]) , MultiLineStringFromText(wkt[,srid])
使用其WKT表示和SRID构造MULTILINESTRING值。
MPointFromText(wkt[,srid]) , MultiPointFromText(wkt[,srid])
使用其WKT表示和SRID构造MULTIPOINT值。
MPolyFromText(wkt[,srid]) , MultiPolygonFromText(wkt[,srid])
使用其WKT表示和SRID构造MULTIPOLYGON值。
PointFromText(wkt[,srid])
使用其WKT表示和SRID构造POINT值。
PolyFromText(wkt[,srid]) , PolygonFromText(wkt[,srid])
使用其WKT表示和SRID构造POLYGON值。

OpenGIS规范还介绍了用于构造Polygon或MultiPolygon值的可选函数，这些值基于环和封闭LineString值集合的WKT表达式。这些值可以相交。MySQL未实施下述函数：

BdMPolyFromText(wkt,srid)
以包含已关闭LineString值任意集合的WKT格式，从MultiLineString值构造MultiPolygon值。
BdPolyFromText(wkt,srid)
以包含已关闭LineString值任意集合的WKT格式，从MultiLineString值构造Polygon值。

MySQL提供了众多函数，它们将包含WKT表达式、或可选的空间参考系统ID（SRID）的BLOB作为输入参数。它们返回对应的几何对象。

GeomFromWKB()接受任何几何类型的WKB作为其第1个参量。在实施方案中也提供了与类型相关的构造函数，用于构造每一种几何类型的几何值。

GeomCollFromWKB(wkb[,srid]) , GeometryCollectionFromWKB(wkb[,srid])
使用其WKB表示和SRID构造GEOMETRYCOLLECTION值。
GeomFromWKB(wkb[,srid]) , GeometryFromWKB(wkb[,srid])
使用其WKB表示和SRID构造任意类型的几何值。
LineFromWKB(wkb[,srid]) , LineStringFromWKB(wkb[,srid])
使用其WKB表示和SRID构造LINESTRING值。
MLineFromWKB(wkb[,srid]) , MultiLineStringFromWKB(wkb[,srid])
使用其WKB表示和SRID构造MULTILINESTRING值。
MPointFromWKB(wkb[,srid]) , MultiPointFromWKB(wkb[,srid])
使用其WKB表示和SRID构造MULTIPOINT值。
MPolyFromWKB(wkb[,srid]) , MultiPolygonFromWKB(wkb[,srid])
使用其WKB表示和SRID构造MULTIPOLYGON值。
PointFromWKB(wkb[,srid])
使用其WKB表示和SRID构造POINT值。
PolyFromWKB(wkb[,srid]) , PolygonFromWKB(wkb[,srid])
使用其WKB表示和SRID构造POLYGON值。

OpenGIS规范还介绍了用于构造Polygon或MultiPolygon值的可选函数，这些值基于环和封闭LineString值集合的WKB表达式。这些值可以相交。MySQL未实施下述函数：

BdMPolyFromWKB(wkb,srid)
以包含已关闭LineString值任意集合的WKB格式，从MultiLineString值构造MultiPolygon值。
BdPolyFromWKB(wkb,srid)
以包含已关闭LineString值任意集合的WKB格式，从MultiLineString值构造Polygon值。

注释：MySQL未实施本节所列的函数。

MySQL为创建几何WKB表达式提供了有用的函数集合。本节介绍的函数是对OpenGIS规范的MySQL扩展。这些函数的结果是包含几何值（无SRID）的BLOB值。这些函数的结果可被GeomFromWKB()函数系列中任意函数的第1个参量取代。

GeometryCollection(g1,g2,...)
构造WKB GeometryCollection。如果任何参量不是构造良好的几何对象WKB表达式，返回值为NULL。
LineString(pt1,pt2,...)
从多个WKB Point参量构造WKB LineString值。如果任何参量不是WKB Point，返回值为NULL。如果Point参量的数目小于2，返回值为NULL。
MultiLineString(ls1,ls2,...)
使用WKB LineString参量构造WKB MultiLineString值。如果任何参量不是WKB LineString，返回值为NULL。
MultiPoint(pt1,pt2,...)
使用WKB Point参量构造WKB MultiPoint值。如果任何参量不是WKB Point，返回值为NULL。
MultiPolygon(poly1,poly2,...)
从一组WKB Polygon参量构造WKB MultiPolygon值。如果任何参量不是WKB Polygon，返回值为NULL。
Point(x,y)
使用其坐标构造WKB Point。
Polygon(ls1,ls2,...)
从多个WKB LineString参量构造WKB Polygon值。如果任何参量未表示为LinearRing的WKB形式（即，非封闭和简单LineString），返回值为NULL。