19.4.2. 创建空间值
19.4.2.1. 使用WKT函数创建Geometry(几何)值
19.4.2.2. 使用WKB函数创建Geometry(几何)值
19.4.2.3. 使用MySQL函数创建几何值
在本节中,介绍了使用OpenGIS标准中定义的WKT和WKB函数创建空间值的方法,以及使用相应MySQL函数的方法。
19.4.2.1. 使用WKT函数创建Geometry(几何)值
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值。
19.4.2.2. 使用WKB函数创建Geometry(几何)值
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值。
19.4.2.3. 使用MySQL函数创建几何值
注释: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。 |