12.17.9.2 使用最小边界矩形的空间关系函数

# 12.17.9.2 使用最小边界矩形的空间关系函数

MySQL 提供了几个 MySQL 特定的函数来测试两个几何的最小边界矩形 (MBR) 之间的关系*g1和g2*.返回值 1 和 0 分别表示真和假。

点的边界框被解释为既是边界又是内部的点。

直线水平或垂直线的边界框被解释为线的内部也是边界的线。端点是边界点。

如果任何参数是几何集合，则这些参数的内部、边界和外部是集合中所有元素的并集。

本节中的函数检测笛卡尔或地理空间参考系统 (SRS) 中的参数，并返回适合 SRS 的结果。

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

如果有任何论据空值或空几何，返回值为空值.
如果任何几何参数不是语法上格式良好的几何，则ER_GIS_INVALID_DATA (opens new window)发生错误。
如果任何几何参数是未定义的空间参考系统 (SRS) 中的语法结构良好的几何，则ER_SRS_NOT_FOUND (opens new window)发生错误。
对于采用多个几何参数的函数，如果这些参数不在同一个 SRS 中，则ER_GIS_DIFFERENT_SRIDS (opens new window)发生错误。
如果任何参数在几何上无效，则结果要么为真要么为假（未定义哪个），或者发生错误。
对于地理 SRS 几何参数，如果任何参数的经度或纬度超出范围，则会发生错误：
- 如果经度值不在 (−180, 180] 范围内，则ER_GEOMETRY_PARAM_LONGITUDE_OUT_OF_RANGE (opens new window)发生错误（ER_LONGITUDE_OUT_OF_RANGE (opens new window)在 MySQL 8.0.12 之前）。
- 如果纬度值不在范围内[−90, 90]，一个ER_GEOMETRY_PARAM_LATITUDE_OUT_OF_RANGE (opens new window)发生错误（ER_LATITUDE_OUT_OF_RANGE (opens new window)在 MySQL 8.0.12 之前）。
  
  显示的范围以度为单位。如果 SRS 使用另一个单位，则范围使用其单位中的相应值。由于浮点运算，确切的范围限制略有偏差。
否则，返回值为非空值.

这些 MBR 函数可用于测试几何关系：

MBR包含（*g1*, *g2*)

返回 1 或 0 表示是否最小外接矩形*g1包含的最小边界矩形g2*.这测试了相反的关系MBRWithin().

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

mysql> SET @g1 = ST_GeomFromText('Polygon((0 0,0 3,3 3,3 0,0 0))');
mysql> SET @g2 = ST_GeomFromText('Point(1 1)');
mysql> SELECT MBRContains(@g1,@g2), MBRWithin(@g2,@g1);
+----------------------+--------------------+
| MBRContains(@g1,@g2) | MBRWithin(@g2,@g1) |
+----------------------+--------------------+
|                    1 |                  1 |
+----------------------+--------------------+

MBRCoveredBy(*g1*, *g2*)

返回 1 或 0 表示是否最小外接矩形*g1被最小外接矩形覆盖g2*.这测试了相反的关系MBRCovers().

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

mysql> SET @g1 = ST_GeomFromText('Polygon((0 0,0 3,3 3,3 0,0 0))');
mysql> SET @g2 = ST_GeomFromText('Point(1 1)');
mysql> SELECT MBRCovers(@g1,@g2), MBRCoveredby(@g1,@g2);
+--------------------+-----------------------+
| MBRCovers(@g1,@g2) | MBRCoveredby(@g1,@g2) |
+--------------------+-----------------------+
|                  1 |                     0 |
+--------------------+-----------------------+
mysql> SELECT MBRCovers(@g2,@g1), MBRCoveredby(@g2,@g1);
+--------------------+-----------------------+
| MBRCovers(@g2,@g1) | MBRCoveredby(@g2,@g1) |
+--------------------+-----------------------+
|                  0 |                     1 |
+--------------------+-----------------------+

MBRCovers(*g1*, *g2*)

返回 1 或 0 表示是否最小外接矩形*g1覆盖最小外接矩形g2*.这测试了相反的关系MBRCoveredBy().见描述MBRCoveredBy()举些例子。

MBRCovers()如本节介绍中所述处理其参数。
MBR不相交(*g1*, *g2*)

返回 1 或 0 表示两个几何图形的最小外接矩形*g1和g2*不相交（不相交）。

MBR不相交（）如本节介绍中所述处理其参数。
MBREquals(*g1*, *g2*)

返回 1 或 0 表示两个几何图形的最小外接矩形*g1和g2*是相同的。

MBREquals()如本节介绍中所述处理其参数，除了它不返回空值对于空几何参数。
MBR 相交(*g1*, *g2*)

返回 1 或 0 表示两个几何图形的最小外接矩形*g1和g2*相交。

MBRIntersects()如本节介绍中所述处理其参数。
MBR重叠（*g1*, *g2*)

两种几何形状空间重叠如果它们相交并且它们的相交会导致几何尺寸相同但不等于给定几何形状中的任何一个。

该函数返回 1 或 0 表示两个几何的最小外接矩形*g1和g2*重叠。

MBROverlaps()如本节介绍中所述处理其参数。
MBRTouches(*g1*, *g2*)

两种几何形状空间接触如果它们的内部不相交，但其中一个几何图形的边界与另一个几何图形的边界或内部相交。

该函数返回 1 或 0 表示两个几何的最小外接矩形*g1和g2*触碰。

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

MBR内（*g1*, *g2*)

返回 1 或 0 表示是否最小外接矩形*g1在最小边界矩形内g2*.这测试了相反的关系MBRContains().

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

mysql> SET @g1 = ST_GeomFromText('Polygon((0 0,0 3,3 3,3 0,0 0))');
mysql> SET @g2 = ST_GeomFromText('Polygon((0 0,0 5,5 5,5 0,0 0))');
mysql> SELECT MBRWithin(@g1,@g2), MBRWithin(@g2,@g1);
+--------------------+--------------------+
| MBRWithin(@g1,@g2) | MBRWithin(@g2,@g1) |
+--------------------+--------------------+
|                  1 |                  0 |
+--------------------+--------------------+

← 12.17.9.1 使用对象形状的空间关系函数 12.17.10 空间 Geohash 函数 →