Mysql参考手册

19.5.2. Geometry函数

19.5.2.1. 通用几何函数
19.5.2.2. Point函数
 
19.5.2.3. LineString函数
19.5.2.4. MultiLineString函数
19.5.2.5. Polygon函数
19.5.2.6. MultiPolygon函数
19.5.2.7. GeometryCollection函数
属于该组的每个函数均将几何值作为其参量，并返回几何值的定性或定量属性。某些函数限制了其参量类型。如果参量是不正确的几何类型，这类函数将返回 NULL。例如，如果对象类型既不是 Polygon也不是 MultiPolygon，Area()将返回NULL。

19.5.2.1. 通用几何函数

本节列出的函数不限制其参量，可接受任何类型的几何值。

  • Dimension(g)

    返回几何值g的固有维数。结果可以是-1、0、1或2。（关于这些值的含义，请参见19.2.2节，“类Geometry”）。 

    mysql> SELECT Dimension(GeomFromText('LineString(1 1,2 2)'));
+------------------------------------------------+
| Dimension(GeomFromText('LineString(1 1,2 2)')) |
+------------------------------------------------+
|                                              1 |
+------------------------------------------------+

  • Envelope(g)

    返回几何值g的最小边界矩形（MBR）。结果以Polygon值的形式返回。

    多边形（polygon）是由边界框的顶点定义的：
    POLYGON((MINX MINY, MAXX MINY, MAXX MAXY, MINX MAXY, MINX MINY))

    mysql> SELECT AsText(Envelope(GeomFromText('LineString(1 1,2 2)')));
+-------------------------------------------------------+
| AsText(Envelope(GeomFromText('LineString(1 1,2 2)'))) |
+-------------------------------------------------------+
| POLYGON((1 1,2 1,2 2,1 2,1 1))                        |
+-------------------------------------------------------+

  • GeometryType(g)

    以字符串形式返回几何类型的名称，几何实例g是几何类型的成员。该名称与可实例化几何子类之一对应。

    mysql> SELECT GeometryType(GeomFromText('POINT(1 1)'));
+------------------------------------------+
| GeometryType(GeomFromText('POINT(1 1)')) |
+------------------------------------------+
| POINT                                    |
+------------------------------------------+

  • SRID(g)

    返回指明了几何值g的空间参考系统ID的整数。

    在MySQL中，SRID值仅是与几何值相关的整数。所有计算均是在欧几里得（平面）几何中进行的。

    mysql> SELECT SRID(GeomFromText('LineString(1 1,2 2)',101));
+-----------------------------------------------+
| SRID(GeomFromText('LineString(1 1,2 2)',101)) |
+-----------------------------------------------+
|                                           101 |
+-----------------------------------------------+

OpenGIS规范还定义了下述函数，MySQL未实施这类函数：

  • Boundary(g)

    返回几何值g的组合边界的闭包的几何对象。

  • IsEmpty(g)

    如果几何值g为空的几何对象，返回1，如果非空，返回0，如果参量为NULL，返回-1。如果几何对象是空的，它表示空的点集合。

  • IsSimple(g)

    目前该函数是占位符，不应使用它。如果实施了它，其行为与下段所给出的描述类似。

    如果几何值g没有异常的几何点（如自相交或自相切），返回1。如果参量不是简单参量，IsSimple()返回0，如果参量是NULL，返回-1。

    对于本章前面介绍的每个可实例化几何类，均包含特定的条件，这类条件会使类实例被分类为非简单的。

19.5.2.2. Point函数
 

Point由X和Y坐标构成，可使用下述函数获得它们：

  • X(p)

    以双精度数值返回点p的X坐标值。

    mysql> SELECT X(GeomFromText('Point(56.7 53.34)'));
+--------------------------------------+
| X(GeomFromText('Point(56.7 53.34)')) |
+--------------------------------------+
|                                 56.7 |
+--------------------------------------+

  • Y(p)

    以双精度数值返回点p的Y坐标值。

    mysql> SELECT Y(GeomFromText('Point(56.7 53.34)'));
+--------------------------------------+
| Y(GeomFromText('Point(56.7 53.34)')) |
+--------------------------------------+
|                                53.34 |
+--------------------------------------+

19.5.2.3. LineString函数

LineString由Point值组成。你可以提取LineString的特定点，计数它所包含的点数，或获取其长度。

  • EndPoint(ls)

    返回LineString值1s的最后一个点的Point。

    mysql> SET @ls = 'LineString(1 1,2 2,3 3)';
mysql> SELECT AsText(EndPoint(GeomFromText(@ls)));
+-------------------------------------+
| AsText(EndPoint(GeomFromText(@ls))) |
+-------------------------------------+
| POINT(3 3)                          |
+-------------------------------------+

  • GLength(ls)

    以双精度数值返回LineString值1s在相关的空间参考系中的长度。

    mysql> SET @ls = 'LineString(1 1,2 2,3 3)';
mysql> SELECT GLength(GeomFromText(@ls));
+----------------------------+
| GLength(GeomFromText(@ls)) |
+----------------------------+
|            2.8284271247462 |
+----------------------------+

  • NumPoints(ls)

    返回LineString值1s中的点数。

    mysql> SET @ls = 'LineString(1 1,2 2,3 3)';
mysql> SELECT NumPoints(GeomFromText(@ls));
+------------------------------+
| NumPoints(GeomFromText(@ls)) |
+------------------------------+
|                            3 |
+------------------------------+

  • PointN(ls,n)

    返回LineString值1s中的第n个点。点编号从1开始。

    mysql> SET @ls = 'LineString(1 1,2 2,3 3)';
mysql> SELECT AsText(PointN(GeomFromText(@ls),2));
+-------------------------------------+
| AsText(PointN(GeomFromText(@ls),2)) |
+-------------------------------------+
| POINT(2 2)                          |
+-------------------------------------+

  • StartPoint(ls)

    返回LineString值1s的第一个点的Point。

    mysql> SET @ls = 'LineString(1 1,2 2,3 3)';
mysql> SELECT AsText(StartPoint(GeomFromText(@ls)));
+---------------------------------------+
| AsText(StartPoint(GeomFromText(@ls))) |
+---------------------------------------+
| POINT(1 1)                            |
+---------------------------------------+

OpenGIS规范还定义了下述函数，MySQL尚未实施这些函数：

  • IsRing(ls)

    如果LineString值ls是封闭的（即其StartPoint()和EndPoint()值相同）和简单的（未通过相同的点1次以上）返回1。如果ls不是环，返回0，如果它是NULL，返回-1。

19.5.2.4. MultiLineString函数

  • GLength(mls)

    以双精度数值形式返回MultiLineString值m1s的长度。mls的长度等于其元素的长度之和。

    mysql> SET @mls = 'MultiLineString((1 1,2 2,3 3),(4 4,5 5))';
mysql> SELECT GLength(GeomFromText(@mls));
+-----------------------------+
| GLength(GeomFromText(@mls)) |
+-----------------------------+
|             4.2426406871193 |
+-----------------------------+

  • IsClosed(mls)

    如果MultiLineString值m1s是封闭的（即StartPoint()和EndPoint()值对m1s中的每个LineString是相同的）返回1。如果mls是非封闭的，返回0，如果它是NULL，返回-1。

    mysql> SET @mls = 'MultiLineString((1 1,2 2,3 3),(4 4,5 5))';
mysql> SELECT IsClosed(GeomFromText(@mls));
+------------------------------+
| IsClosed(GeomFromText(@mls)) |
+------------------------------+
|                            0 |
+------------------------------+

19.5.2.5. Polygon函数

  • Area(poly)

    以双精度数值形式返回Polygon值poly的面积，根据在其空间参考系中的测量值。

    mysql> SET @poly = 'Polygon((0 0,0 3,3 0,0 0),(1 1,1 2,2 1,1 1))';
mysql> SELECT Area(GeomFromText(@poly));
+---------------------------+
| Area(GeomFromText(@poly)) |
+---------------------------+
|                         4 |
+---------------------------+

  • ExteriorRing(poly)

    以LineString形式返回Polygon值poly的外环。

    mysql> SET @poly =
    -> 'Polygon((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 2,2 1,1 1))';
mysql> SELECT AsText(ExteriorRing(GeomFromText(@poly)));
+-------------------------------------------+
| AsText(ExteriorRing(GeomFromText(@poly))) |
+-------------------------------------------+
| LINESTRING(0 0,0 3,3 3,3 0,0 0)           |
+-------------------------------------------+

  • InteriorRingN(poly,n)

    以LineString形式返回Polygon值poly的第n个内环。环编号从1开始。

    mysql> SET @poly =
    -> 'Polygon((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 2,2 1,1 1))';
mysql> SELECT AsText(InteriorRingN(GeomFromText(@poly),1));
+----------------------------------------------+
| AsText(InteriorRingN(GeomFromText(@poly),1)) |
+----------------------------------------------+
| LINESTRING(1 1,1 2,2 2,2 1,1 1)              |
+----------------------------------------------+

  • NumInteriorRings(poly)

    返回Polygon值poly的内环的数目。

    mysql> SET @poly =
    -> 'Polygon((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 2,2 1,1 1))';
mysql> SELECT NumInteriorRings(GeomFromText(@poly));
+---------------------------------------+
| NumInteriorRings(GeomFromText(@poly)) |
+---------------------------------------+
|                                     1 |
+---------------------------------------+

19.5.2.6. MultiPolygon函数

  • Area(mpoly)

    以双精度数值形式返回MultiPolygon值mpoly的面积，根据在其空间参考系中的测量结果。

    mysql> SET @mpoly =
    -> 'MultiPolygon(((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 2,2 1,1 1)))';
mysql> SELECT Area(GeomFromText(@mpoly));
+----------------------------+
| Area(GeomFromText(@mpoly)) |
+----------------------------+
|                          8 |
+----------------------------+

OpenGIS规范还定义了下述函数，MySQL未实施这类函数：

  • Centroid(mpoly)

    以Point形式返回用于MultiPolygon值mpoly的数学质心。不保证结果位于MultiPolygon上。

  • PointOnSurface(mpoly)

    返回Point值，保证该值位于MultiPolygon值mpoly上。

19.5.2.7. GeometryCollection函数

  • GeometryN(gc,n)

    返回GeometryCollection值gc中第n个几何对象。几何对象的编号从1开始。

    mysql> SET @gc = 'GeometryCollection(Point(1 1),LineString(2 2, 3 3))';
mysql> SELECT AsText(GeometryN(GeomFromText(@gc),1));
+----------------------------------------+
| AsText(GeometryN(GeomFromText(@gc),1)) |
+----------------------------------------+
| POINT(1 1)                             |
+----------------------------------------+

  • NumGeometries(gc)

    返回GeometryCollection值gc中几何对象的数目。

    mysql> SET @gc = 'GeometryCollection(Point(1 1),LineString(2 2, 3 3))';
mysql> SELECT NumGeometries(GeomFromText(@gc));
+----------------------------------+
| NumGeometries(GeomFromText(@gc)) |
+----------------------------------+
|                                2 |
+----------------------------------+
相关文章
mysql 添加新的自定义函数mysql 位函数mysql c api预处理语句函数概述mysql c api预处理语句函数描述mysql cast函数和操作符mysql 从已有geometry创建新geometry的函数mysql 测试几何类之间空间关系的函数mysql geometry格式转换函数mysql geometry函数mysql 其他函数php cubrid mysql 兼容性函数 get the error messagephp mysql 函数 新建一个 mysql 数据库php mysql 函数 移动内部结果的指针php mysql 函数 取得结果数据php mysql 函数 取得结果中指定字段的字段名php mysql 函数 将结果集中的指针设定为制定的字段偏移量php mysql 函数 取得结果集中行的数目php mysql 函数 打开一个到 mysql 服务器的持久连接php mysqlnd ms 函数 starts a distributed/xa transaction among mysql serversphp ps 函数 gets geometry of a string
关注编程学问公众号