描述

如果几何/地理 B 中的每个点都位于几何/地理 A 的内部（即与 A 的内部或边界相交），则返回 true。等效地，测试 B 的任何点是否位于 A 的外部。

用数学术语表示：ST_Covers(A, B) ⇔ A ⋂ B = B

ST_Covers 是 ST_CoveredBy 的逆运算。所以，ST_Covers(A,B) = ST_CoveredBy(B,A)。

通常，此函数应代替 ST_Contains 使用，因为它具有更简单的定义，并且没有“几何图形不包含其边界”的怪癖。

由 GEOS 模块执行

增强功能：2.4.0 添加了对地理类型中多边形中的多边形和多边形中的线的支持

增强功能：2.3.0 扩展了对具有少量点的 MultiPoints 的 PIP 短路支持。之前的版本仅支持点在多边形中。

可用性：1.5 - 引入了对地理的支持。

可用性：1.2.2

注意：这是返回布尔值而不是整数的“允许”版本。

不是 OGC 标准，但 Oracle 也具有此功能。

示例

几何示例

  --a circle covering a circle
SELECT ST_Covers(smallc,smallc) As smallinsmall,
  ST_Covers(smallc, bigc) As smallcoversbig,
  ST_Covers(bigc, ST_ExteriorRing(bigc)) As bigcoversexterior,
  ST_Contains(bigc, ST_ExteriorRing(bigc)) As bigcontainsexterior
FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As smallc,
  ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As bigc) As foo;
  --Result
 smallinsmall | smallcoversbig | bigcoversexterior | bigcontainsexterior
--------------+----------------+-------------------+---------------------
 t            | f              | t                 | f
(1 row) 

地理示例

-- a point with a 300 meter buffer compared to a point, a point and its 10 meter buffer
SELECT ST_Covers(geog_poly, geog_pt) As poly_covers_pt,
  ST_Covers(ST_Buffer(geog_pt,10), geog_pt) As buff_10m_covers_cent
  FROM (SELECT ST_Buffer(ST_GeogFromText('SRID=4326;POINT(-99.327 31.4821)'), 300) As geog_poly,
        ST_GeogFromText('SRID=4326;POINT(-99.33 31.483)') As geog_pt ) As foo;

 poly_covers_pt | buff_10m_covers_cent
----------------+------------------
 f              | t
    

另请参阅

ST_Contains, ST_CoveredBy, ST_Within