Documentation Home
MySQL 8.0 参考手册
MySQL 8.0 参考手册  / 第 12 章函数和运算符  / 12.17空间分析函数  / 12.17.7 几何属性函数  /  12.17.7.4 多边形和多边形属性函数

12.17.7.4 多边形和多边形属性函数

本节中的函数返回 Polygon或MultiPolygon 值的属性。

除非另有说明，本节中的函数按如下方式处理它们的几何参数：

  • 如果任何参数是NULL或任何几何参数是空几何，则返回值为 NULL。

  • 如果任何几何参数不是语法上格式正确的几何， ER_GIS_INVALID_DATA则会发生错误。

  • 如果任何几何参数是未定义空间参考系统 (SRS) 中语法上格式正确的几何， ER_SRS_NOT_FOUND则会发生错误。

  • 对于采用多个几何参数的函数，如果这些参数不在同一个 SRS 中， ER_GIS_DIFFERENT_SRIDS则会发生错误。

  • 否则，返回值为非NULL。

这些函数可用于获取多边形属性：

  • ST_Area({poly|mpoly})

    返回一个双精度数字，指示 Polygon或 MultiPolygon参数的面积，如在其空间参考系统中测量的那样。

    从 MySQL 8.0.13 开始，ST_Area() 按照本节介绍中的描述处理其参数，但有以下例外：

    • 如果几何在几何上无效，则结果要么是未定义的区域（即，它可以是任何数字），要么会发生错误。

    • 如果几何有效但不是 Polygon或 MultiPolygon对象， ER_UNEXPECTED_GEOMETRY_TYPE 则会发生错误。

    • 如果几何Polygon在笛卡尔 SRS 中有效，则结果是多边形的笛卡尔面积。

    • 如果几何 MultiPolygon在笛卡尔 SRS 中有效，则结果是多边形笛卡尔面积的总和。

    • 如果几何Polygon在地理 SRS 中有效，则结果是该 SRS 中多边形的大地测量面积，以平方米为单位。

    • 如果几何 MultiPolygon在地理 SRS 中有效，则结果是该 SRS 中多边形的大地测量面积之和，以平方米为单位。

    • 如果面积计算结果为 +inf， ER_DATA_OUT_OF_RANGE 则会发生错误。

    • 如果几何图形的地理 SRS 的经度或纬度超出范围，则会发生错误：

      显示的范围以度为单位。由于浮点运算，确切的范围限制略有偏差。

    在 MySQL 8.0.13 之前， ST_Area()按照本节介绍中的描述处理其参数，但有以下例外：

    • 对于维度 0 或 1 的参数，结果为 0。

    • 如果几何为空，则返回值为 0 而不是NULL.

    • 对于几何集合，结果是所有组件的面积值之和。如果几何集合为空，则其面积返回为 0。

    • 如果几何具有地理空间参考系统 (SRS) 的 SRID 值， ER_NOT_IMPLEMENTED_FOR_GEOGRAPHIC_SRS 则会发生错误。 

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

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 ST_Area(ST_GeomFromText(@mpoly));
+----------------------------------+
| ST_Area(ST_GeomFromText(@mpoly)) |
+----------------------------------+
|                                8 |
+----------------------------------+

  • ST_Centroid({poly|mpoly})

    Polygon将或 MultiPolygon参数 的数学质心作为 返回 Point。结果不保证在MultiPolygon.

    此函数通过计算集合中最高维度组件的质心点来处理几何集合。这些组件被提取并制成单个MultiPolygon、 MultiLineString或 MultiPoint用于质心计算。

    ST_Centroid()按照本节介绍中的描述处理其参数，但有以下例外：

    • 返回值NULL用于参数为空几何集合的附加条件。

    • 如果几何具有地理空间参考系统 (SRS) 的 SRID 值， ER_NOT_IMPLEMENTED_FOR_GEOGRAPHIC_SRS 则会发生错误。 

    mysql> SET @poly =
       ST_GeomFromText('POLYGON((0 0,10 0,10 10,0 10,0 0),(5 5,7 5,7 7,5 7,5 5))');
mysql> SELECT ST_GeometryType(@poly),ST_AsText(ST_Centroid(@poly));
+------------------------+--------------------------------------------+
| ST_GeometryType(@poly) | ST_AsText(ST_Centroid(@poly))              |
+------------------------+--------------------------------------------+
| POLYGON                | POINT(4.958333333333333 4.958333333333333) |
+------------------------+--------------------------------------------+

  • ST_ExteriorRing(poly)

    Polygon 返回值 的外环poly作为 a LineString。

    ST_ExteriorRing()如本节介绍中所述处理其参数。 

    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 ST_AsText(ST_ExteriorRing(ST_GeomFromText(@poly)));
+----------------------------------------------------+
| ST_AsText(ST_ExteriorRing(ST_GeomFromText(@poly))) |
+----------------------------------------------------+
| LINESTRING(0 0,0 3,3 3,3 0,0 0)                    |
+----------------------------------------------------+

  • ST_InteriorRingN(poly, N)

    返回值为 a 的N第 - 个内环。环从 1 开始编号。 PolygonpolyLineString

    ST_InteriorRingN()如本节介绍中所述处理其参数。 

    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 ST_AsText(ST_InteriorRingN(ST_GeomFromText(@poly),1));
+-------------------------------------------------------+
| ST_AsText(ST_InteriorRingN(ST_GeomFromText(@poly),1)) |
+-------------------------------------------------------+
| LINESTRING(1 1,1 2,2 2,2 1,1 1)                       |
+-------------------------------------------------------+

  • ST_NumInteriorRing(poly), ST_NumInteriorRings(poly)

    Polygon返回值 中的内环数 poly。

    ST_NumInteriorRing() 并ST_NuminteriorRings() 按照本节介绍中所述处理他们的论点。 

    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 ST_NumInteriorRings(ST_GeomFromText(@poly));
+---------------------------------------------+
| ST_NumInteriorRings(ST_GeomFromText(@poly)) |
+---------------------------------------------+
|                                           1 |
+---------------------------------------------+