Documentation Home
MySQL 8.0 参考手册

12.17.13 空间便利功能

本节中的函数提供对几何值的便捷操作。

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

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

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

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

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

  • 否则，返回值为非NULL。

这些便利功能可用：

  • ST_Distance_Sphere(g1, g2 [, radius])

    Point返回球体上参数 之间的最小球面距离 MultiPoint ，以米为单位。（对于通用距离计算，请参阅 ST_Distance()函数。）可选radius参数应以米为单位给出。

    如果两个几何参数都是有效的笛卡尔坐标 Point或MultiPoint SRID 0 中的值，则返回值是具有提供半径的球体上两个几何之间的最短距离。如果省略，则默认半径为 6,370,986 米，点 X 和 Y 坐标分别解释为经度和纬度，以度为单位。

    如果两个几何参数都是有效的Point 或者MultiPoint是地理空间参考系统 (SRS) 中的值，则返回值是具有提供的半径的球体上两个几何之间的最短距离。如果省略，则默认半径等于平均半径，定义为 (2a+b)/3，其中 a 是半长轴，b 是 SRS 的半短轴。

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

    mysql> SET @pt1 = ST_GeomFromText('POINT(0 0)');
mysql> SET @pt2 = ST_GeomFromText('POINT(180 0)');
mysql> SELECT ST_Distance_Sphere(@pt1, @pt2);
+--------------------------------+
| ST_Distance_Sphere(@pt1, @pt2) |
+--------------------------------+
|             20015042.813723423 |
+--------------------------------+

  • ST_IsValid(g)

    如果参数在几何上有效则返回 1，如果参数在几何上无效则返回 0。几何有效性由 OGC 规范定义。

    唯一有效的空几何以空几何集合值的形式表示。 ST_IsValid()在这种情况下返回 1。MySQL 不支持 GISEMPTY 值，例如POINT EMPTY.

    ST_IsValid()如本节介绍中所述处理其参数，但以下情况除外： 

    mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,-0.00 0,0.0 0)');
mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 0, 1 1)');
mysql> SELECT ST_IsValid(@ls1);
+------------------+
| ST_IsValid(@ls1) |
+------------------+
|                0 |
+------------------+
mysql> SELECT ST_IsValid(@ls2);
+------------------+
| ST_IsValid(@ls2) |
+------------------+
|                1 |
+------------------+

  • ST_MakeEnvelope(pt1, pt2)

    返回围绕两点形成包络的矩形，如 a Point、 LineString或Polygon。

    计算是使用笛卡尔坐标系完成的，而不是在球体、椭球体或地球上进行。

    给定两个点pt1和 pt2， ST_MakeEnvelope()在抽象平面上创建结果几何体，如下所示：

    • 如果pt1和 pt2相等，则结果为点pt1。

    • 否则，如果是垂直或水平线段，则结果为线段 。 (pt1, pt2)(pt1, pt2)

    • 否则，结果是使用 pt1和 pt2作为对角点的多边形。

    结果几何的 SRID 为 0。

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

    mysql> SET @pt1 = ST_GeomFromText('POINT(0 0)');
mysql> SET @pt2 = ST_GeomFromText('POINT(1 1)');
mysql> SELECT ST_AsText(ST_MakeEnvelope(@pt1, @pt2));
+----------------------------------------+
| ST_AsText(ST_MakeEnvelope(@pt1, @pt2)) |
+----------------------------------------+
| POLYGON((0 0,1 0,1 1,0 1,0 0))         |
+----------------------------------------+

  • ST_Simplify(g, max_distance)

    使用 Douglas-Peucker 算法简化几何并返回相同类型的简化值。

    几何可以是任何几何类型，尽管 Douglas-Peucker 算法实际上可能不会处理所有类型。通过将其组件一个一个地提供给简化算法来处理几何集合，并将返回的几何作为结果放入几何集合中。

    max_distance参数是顶点到要删除的其他线段的距离（以输入坐标为单位） 。简化线串此距离内的顶点将被删除。

    根据 Boost.Geometry，由于简化过程，几何图形可能会变得无效，并且该过程可能会创建自相交。要检查结果的有效性，将其传递给 ST_IsValid().

    ST_Simplify()如本节介绍中所述处理其参数，但以下情况除外：

    • 如果max_distance参数不是正数，或者是NaN， ER_WRONG_ARGUMENTS则会发生错误。 

    mysql> SET @g = ST_GeomFromText('LINESTRING(0 0,0 1,1 1,1 2,2 2,2 3,3 3)');
mysql> SELECT ST_AsText(ST_Simplify(@g, 0.5));
+---------------------------------+
| ST_AsText(ST_Simplify(@g, 0.5)) |
+---------------------------------+
| LINESTRING(0 0,0 1,1 1,2 3,3 3) |
+---------------------------------+
mysql> SELECT ST_AsText(ST_Simplify(@g, 1.0));
+---------------------------------+
| ST_AsText(ST_Simplify(@g, 1.0)) |
+---------------------------------+
| LINESTRING(0 0,3 3)             |
+---------------------------------+

  • ST_Validate(g)

    根据 OGC 规范验证几何图形。几何可以在句法上格式正确（WKB 值加上 SRID）但在几何上无效。例如，这个多边形在几何上是无效的：POLYGON((0 0, 0 0, 0 0, 0 0, 0 0))

    ST_Validate()如果参数在语法上格式正确并且在几何上有效，NULL如果参数在语法上格式不正确或在几何上无效或者是 ，则返回几何NULL。

    ST_Validate()可用于过滤掉无效的几何数据，但需要付出一定的代价。对于需要不被无效数据污染的更精确结果的应用程序，这种损失可能是值得的。

    如果几何参数有效，则按原样返回，但如果输入Polygon或 MultiPolygon具有顺时针环，则在检查有效性之前将这些环反转。如果几何有效，则返回具有反转环的值。

    唯一有效的空几何以空几何集合值的形式表示。 ST_Validate()在这种情况下直接返回它而无需进一步检查。

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

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

    mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0)');
mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 0, 1 1)');
mysql> SELECT ST_AsText(ST_Validate(@ls1));
+------------------------------+
| ST_AsText(ST_Validate(@ls1)) |
+------------------------------+
| NULL                         |
+------------------------------+
mysql> SELECT ST_AsText(ST_Validate(@ls2));
+------------------------------+
| ST_AsText(ST_Validate(@ls2)) |
+------------------------------+
| LINESTRING(0 0,1 1)          |
+------------------------------+