描述

这些函数允许测试和评估两个几何图形之间的空间（拓扑）关系，如维度扩展 九交模型 (DE-9IM) 所定义。

DE-9IM 被指定为 9 元素矩阵，指示两个几何图形的内部、边界和外部之间相交的维度。 它由使用符号“F”、“0”、“1”、“2”的 9 个字符文本字符串表示（例如“FF1FF0102”）。

可以通过将相交矩阵与相交矩阵模式进行匹配来测试特定类型的空间关系。 模式可以包含附加符号“T”（表示“交集非空”）和“*”（表示“任何值”）。 常见空间关系由命名函数 ST_Contains、ST_ContainsProperly、ST_Covers、ST_CoveredBy、ST_Crosses、ST_Disjoint、ST_Equals、ST_Intersects、ST_Overlaps、ST_Touches和 ST_Within 提供。 使用显式模式可以一步测试相交、交叉等多种条件。 它还允许测试没有命名空间关系函数的空间关系。 例如，关系“Interior-Intersects”具有 DE-9IM 模式 T********，该模式不由任何命名谓词求值。

有关更多信息，请参见Section 5.1, “空间关系的确定”。

形式 1：根据给定的 junctionMatrixPattern 测试两个几何图形是否在空间上相关。

形式 2：返回两个输入几何之间的空间关系的 DE-9IM 矩阵字符串。 可以使用 ST_RelateMatch 测试矩阵字符串与 DE-9IM 模式匹配。

形式 3：与形式 2 类似，但允许指定边界节点规则。 边界节点规则允许更好地控制 MultiLineString 的端点是否被视为位于 DE-9IM 内部或边界内。 boundaryNodeRule 值为：

OGC 规范中没有此函数，但它是隐含的。 见s2.1.13.2

此方法实现了 SQL 1.1 的 OGC 简单功能规范。 s2.1.1.2 // s2.1.13.3

该方法实现了SQL/MM规范。 SQL-MM 3: 5.1.25

它是通过GEOS模块实现的

增强：2.0.0 - 添加了对指定边界节点规则的支持。

示例

使用布尔值函数测试空间关系。

SELECT ST_Relate('POINT(1 2)', ST_Buffer( 'POINT(1 2)', 2), '0FFFFF212');
st_relate
-----------
t

SELECT ST_Relate(POINT(1 2)', ST_Buffer( 'POINT(1 2)', 2), '*FF*FF212');
st_relate
-----------
t

测试一个自定义的空间关系模式作为查询条件，使用&& 来启用空间索引。

-- Find compounds that properly intersect (not just touch) a poly (Interior Intersects)

SELECT c.* , p.name As poly_name
    FROM polys AS p
    INNER JOIN compounds As c
          ON c.geom && p.geom
             AND ST_Relate(p.geom, c.geom,'T********');

计算空间关系的交集矩阵。

SELECT ST_Relate( 'POINT(1 2)',
                  ST_Buffer( 'POINT(1 2)', 2));
-----------
0FFFFF212

SELECT ST_Relate( 'LINESTRING(1 2, 3 4)',
                  'LINESTRING(5 6, 7 8)' );
-----------
FF1FF0102

使用不同的边界节点规则来计算具有重复端点的 LineString 和 MultiLineString 之间的空间关系 (3 3)：

WITH data AS (SELECT
  'LINESTRING(1 1, 3 3)'::geometry AS a_line,
  'MULTILINESTRING((3 3, 3 5), (3 3, 5 3))':: geometry AS b_multiline
)
SELECT ST_Relate( a_line, b_multiline, 1) AS bnr_mod2,
       ST_Relate( a_line, b_multiline, 2) AS bnr_endpoint
    FROM data;

 bnr_mod2  | bnr_endpoint
-----------+--------------
 FF10F0102 | FF1F00102

相关信息

Section 5.1, “空间关系的确定”, ST_RelateMatch, ST_Contains, ST_ContainsProperly, ST_Covers, ST_CoveredBy, ST_Crosses, ST_Disjoint, ST_Equals, ST_Intersects, ST_Overlaps, ST_Touches, ST_Within