Name

ST_CoveredBy — Retorna verdade se nenhum ponto do rastA estiver de fora do rastB.

Synopsis

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

boolean ST_CoveredBy( raster rastA , raster rastB );

Descrição

O rastA está coberto pelo rastB se e somente se nenhum ponto do rastA estiver no exterior do rastB. Se o número de banda não for fornecido ( ou for NULO), apenas o casco convexo do raster é considerado no teste. Se o número de banda for fornecido, apenas aqueles pixeis com valor (não NODATA) serão considerados no teste.

[Note]

Esta função fará uso de qualquer índice que possa estar disponível nos rasters.

[Note]

Para testar a relação espacial de um raster e uma geometria, usa ST_Polygon no raster, ex.: ST_CoveredBy(ST_Polygon(raster), geometria) ou ST_CoveredBy(geometria, ST_Polygon(raster)).

Disponibilidade: 2.1.0

Exemplos

SELECT r1.rid, r2.rid, ST_CoveredBy(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

 rid | rid | st_coveredby
-----+-----+--------------
   2 |   1 | f
   2 |   2 | t
            

Veja também

ST_Intersects, ST_Covers