文档首页
MySQL 8.4 参考手册
相关文档 下载本手册
PDF (US Ltr) - 39.9Mb
PDF (A4) - 40.0Mb
手册页 (TGZ) - 258.5Kb
手册页 (Zip) - 365.5Kb
信息 (Gzip) - 4.0Mb
信息 (Zip) - 4.0Mb


MySQL 8.4 参考手册  /  ...  /  使用对象形状的空间关系函数

14.16.9.1 使用对象形状的空间关系函数

OpenGIS 规范定义了以下函数,用于使用精确的对象形状来测试两个几何值 g1g2 之间的关系。返回值 1 和 0 分别表示真和假,但距离函数返回距离值。

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

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

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

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

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

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

  • 如果任何几何参数在几何上无效,则结果为真或假(未定义哪个),或者会发生错误。

  • 对于地理 SRS 几何参数,如果任何参数的经度或纬度超出范围,则会发生错误。

    所示范围以度为单位。如果 SRS 使用其他单位,则该范围使用其单位中的相应值。由于浮点运算,精确的范围限制略有偏差。

  • 否则,返回值为非 NULL

本节中的某些函数允许使用单位参数来指定返回值的长度单位。除非另有说明,否则函数按如下方式处理其单位参数:

以下对象形状函数可用于测试几何关系:

  • ST_Contains(g1, g2)

    返回 1 或 0 以指示 g1 是否完全包含 g2。这将测试与 ST_Within() 相反的关系。

    ST_Contains() 按本节引言中的描述处理其参数。

  • ST_Crosses(g1, g2)

    如果两个几何图形 空间交叉,则它们的空间关系具有以下属性:

    • 除非 g1g2 的维度均为 1:如果 g2 的内部与 g1 的内部有共同点,但 g2 未覆盖 g1 的整个内部,则 g1g2 交叉。

    • 如果 g1g2 的维度均为 1:如果两条线在有限数量的点处相交(即,没有公共线段,只有单个公共点)。

    此函数返回 1 或 0 以指示 g1 是否在空间上与 g2 交叉。

    ST_Crosses() 按本节引言中的描述处理其参数,但在以下附加条件下,返回值为 NULL

    • g1 的维度为 2(PolygonMultiPolygon)。

    • g2 的维度为 1(PointMultiPoint)。

  • ST_Disjoint(g1, g2)

    返回 1 或 0 以指示 g1 是否在空间上与(不与之相交)g2 不相交。

    ST_Disjoint() 按本节引言中的描述处理其参数。

  • ST_Distance(g1, g2 [, unit])

    返回 g1g2 之间的距离,以几何参数的空间参考系统 (SRS) 的长度单位或可选的 unit 参数(如果指定)的单位进行测量。

    此函数通过返回两个几何参数的分量所有组合中最短的距离来处理几何集合。

    ST_Distance() 处理其几何参数的方式如本节引言中所述,但以下情况除外

    • ST_Distance() 检测地理(椭球体)空间参考系统中的参数,并返回椭球体上的测地距离。 ST_Distance() 支持所有几何类型的地理 SRS 参数的距离计算。

    • 如果任何参数在几何上无效,则结果是未定义的距离(即,它可以是任何数字),或者发生错误。

    • 如果中间或最终结果产生 NaN 或负数,则会发生 ER_GIS_INVALID_DATA 错误。

    ST_Distance() 允许使用可选的 unit 参数指定返回距离值的线性单位,ST_Distance() 处理该参数的方式如本节引言中所述。

    mysql> SET @g1 = ST_GeomFromText('POINT(1 1)');
    mysql> SET @g2 = ST_GeomFromText('POINT(2 2)');
    mysql> SELECT ST_Distance(@g1, @g2);
    +-----------------------+
    | ST_Distance(@g1, @g2) |
    +-----------------------+
    |    1.4142135623730951 |
    +-----------------------+
    
    mysql> SET @g1 = ST_GeomFromText('POINT(1 1)', 4326);
    mysql> SET @g2 = ST_GeomFromText('POINT(2 2)', 4326);
    mysql> SELECT ST_Distance(@g1, @g2);
    +-----------------------+
    | ST_Distance(@g1, @g2) |
    +-----------------------+
    |     156874.3859490455 |
    +-----------------------+
    mysql> SELECT ST_Distance(@g1, @g2, 'metre');
    +--------------------------------+
    | ST_Distance(@g1, @g2, 'metre') |
    +--------------------------------+
    |              156874.3859490455 |
    +--------------------------------+
    mysql> SELECT ST_Distance(@g1, @g2, 'foot');
    +-------------------------------+
    | ST_Distance(@g1, @g2, 'foot') |
    +-------------------------------+
    |             514679.7439273146 |
    +-------------------------------+

    有关球体上距离计算的特殊情况,请参见 ST_Distance_Sphere() 函数。

  • ST_Equals(g1, g2)

    返回 1 或 0 以指示 g1 在空间上是否等于 g2

    ST_Equals() 处理其参数的方式如本节引言中所述,但它不会为空的几何参数返回 NULL

    mysql> SET @g1 = Point(1,1), @g2 = Point(2,2);
    mysql> SELECT ST_Equals(@g1, @g1), ST_Equals(@g1, @g2);
    +---------------------+---------------------+
    | ST_Equals(@g1, @g1) | ST_Equals(@g1, @g2) |
    +---------------------+---------------------+
    |                   1 |                   0 |
    +---------------------+---------------------+
  • ST_FrechetDistance(g1, g2 [, unit])

    返回两个几何图形之间的离散 Fréchet 距离,反映几何图形的相似程度。结果是一个双精度数字,以几何参数的空间参考系统 (SRS) 的长度单位或 unit 参数(如果给出)的长度单位进行测量。

    此函数实现离散 Fréchet 距离,这意味着它仅限于几何图形点之间的距离。例如,给定两个 LineString 参数,则仅考虑几何图形中明确提到的点。不考虑这些点之间线段上的点。

    ST_FrechetDistance() 处理其几何参数的方式如本节引言中所述,但以下情况除外

    ST_FrechetDistance() 处理其可选的 unit 参数的方式如本节引言中所述。

    mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)');
    mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)');
    mysql> SELECT ST_FrechetDistance(@ls1, @ls2);
    +--------------------------------+
    | ST_FrechetDistance(@ls1, @ls2) |
    +--------------------------------+
    |             2.8284271247461903 |
    +--------------------------------+
    
    mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)', 4326);
    mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)', 4326);
    mysql> SELECT ST_FrechetDistance(@ls1, @ls2);
    +--------------------------------+
    | ST_FrechetDistance(@ls1, @ls2) |
    +--------------------------------+
    |              313421.1999416798 |
    +--------------------------------+
    mysql> SELECT ST_FrechetDistance(@ls1, @ls2, 'foot');
    +----------------------------------------+
    | ST_FrechetDistance(@ls1, @ls2, 'foot') |
    +----------------------------------------+
    |                     1028284.7767115477 |
    +----------------------------------------+
  • ST_HausdorffDistance(g1, g2 [, unit])

    返回两个几何图形之间的离散 Hausdorff 距离,反映几何图形的相似程度。结果是一个双精度数字,以几何参数的空间参考系统 (SRS) 的长度单位或 unit 参数(如果给出)的长度单位进行测量。

    此函数实现离散 Hausdorff 距离,这意味着它仅限于几何图形点之间的距离。例如,给定两个 LineString 参数,则仅考虑几何图形中明确提到的点。不考虑这些点之间线段上的点。

    ST_HausdorffDistance() 处理其几何参数的方式如本节引言中所述,但以下情况除外

    • 如果几何参数在相同的笛卡尔坐标系或地理坐标系中,但不在支持的组合中,则会发生 ER_NOT_IMPLEMENTED_FOR_CARTESIAN_SRSER_NOT_IMPLEMENTED_FOR_GEOGRAPHIC_SRS 错误,具体取决于 SRS 类型。支持以下组合

      • LineStringLineString

      • PointMultiPoint

      • LineStringMultiLineString

      • MultiPointMultiPoint

      • MultiLineStringMultiLineString

    ST_HausdorffDistance() 处理其可选的 unit 参数的方式如本节引言中所述。

    mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)');
    mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)');
    mysql> SELECT ST_HausdorffDistance(@ls1, @ls2);
    +----------------------------------+
    | ST_HausdorffDistance(@ls1, @ls2) |
    +----------------------------------+
    |                                1 |
    +----------------------------------+
    
    mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)', 4326);
    mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)', 4326);
    mysql> SELECT ST_HausdorffDistance(@ls1, @ls2);
    +----------------------------------+
    | ST_HausdorffDistance(@ls1, @ls2) |
    +----------------------------------+
    |               111319.49079326246 |
    +----------------------------------+
    mysql> SELECT ST_HausdorffDistance(@ls1, @ls2, 'foot');
    +------------------------------------------+
    | ST_HausdorffDistance(@ls1, @ls2, 'foot') |
    +------------------------------------------+
    |                        365221.4264870815 |
    +------------------------------------------+
  • ST_Intersects(g1, g2)

    返回 1 或 0 以指示 g1 在空间上是否与 g2 相交。

    ST_Intersects() 处理其参数的方式如本节引言中所述。

  • ST_Overlaps(g1, g2)

    如果两个几何图形相交并且它们的交集产生相同维度的几何图形但不等于任何给定的几何图形,则这两个几何图形在空间上重叠

    此函数返回 1 或 0 以指示 g1 在空间上是否与 g2 重叠。

    ST_Overlaps() 处理其参数的方式如本节引言中所述,但返回值为 NULL 的附加条件是两个几何图形的维度不相等。

  • ST_Touches(g1, g2)

    如果两个几何图形的内部不相交,但其中一个几何图形的边界与另一个几何图形的边界或内部相交,则这两个几何图形在空间上相切

    此函数返回 1 或 0 以指示 g1 在空间上是否与 g2 相切。

    ST_Touches() 处理其参数的方式如本节引言中所述,但返回值为 NULL 的附加条件是两个几何图形的维度均为 0(PointMultiPoint)。

  • ST_Within(g1, g2)

    返回 1 或 0 以指示 g1 在空间上是否在 g2 内。这将测试与 ST_Contains() 相反的关系。

    ST_Within() 处理其参数的方式如本节引言中所述。