名前

ST_Covers — rastB が rastA の外部に点を持たない場合に TRUE を返します。

概要

boolean ST_Covers( raster rastA , integer nbandA , raster rastB , integer nbandB );

boolean ST_Covers( raster rastA , raster rastB );

説明

rastA の外部に rastB の点が無い場合には、rastA は rastB に対して Covers です。バンド番号が指定されていないか NULL に指定されている場合には、ラスターの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATA でない) ピクセルについてテストします。

[注記]

この関数はラスターで利用できるインデックスを使用します。

[注記]

ラスターとジオメトリーの空間関係をテストするには、ST_Covers(ST_Polygon(raster), geometry) または ST_Covers(geometry, ST_Polygon(raster)) というふうに、ラスターにST_Polygon を使います。

Availability: 2.1.0

コード
SELECT r1.rid, r2.rid, ST_Covers(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;
出力
rid | rid | st_covers
-----+-----+-----------
   2 |   1 | f
   2 |   2 | t

関連情報

ST_Intersects, ST_CoveredBy