ST_CoveredBy
ST_CoveredBy は、最初の入力ジオメトリの 2D 射影が、 2 番目の入力ジオメトリの 2D 射影に包含される場合 true を返します。どちらも空ではなく、A のすべてのポイントが B のポイントである場合、ジオメトリ A はジオメトリ B で覆われます。
ST_CoveredBy(A、B) は ST_Covers(B、A) と同等です。
構文
ST_CoveredBy(geom1, geom2)
引数
- geom1
-
データ型
GEOMETRYの値またはGEOMETRY型と評価される式の値。この値を geom2 と比較して、geom2 でカバーされているかどうかを判断します。 - geom2
-
データ型
GEOMETRYの値またはGEOMETRY型と評価される式の値。
戻り型
BOOLEAN
geom1 または geom2 が null の場合、null が返されます。
geom1 および geom2 の空間リファレンスシステム識別子 (SRID) が同じ値でない場合、エラーが返されます。
geom1 または geom2 がジオメトリコレクションである場合、エラーが返されます。
例
次の SQL は、最初のポリゴンが 2 番目のポリゴンで覆われるかどうかを確認します。
SELECT ST_CoveredBy(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'));
st_coveredby
-----------
true
