Name
ST_Covers — Retorna verdade se nenhum ponto do rastB estiver de fora do rastA.
Synopsis
boolean ST_Covers( raster rastA , integer nbandA , raster rastB , integer nbandB );
boolean ST_Covers( raster rastA , raster rastB );
Descrição
O rastA cobre rastB se e somente se nenhum ponto do rastB estiver no exterior do rastA. 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]](../images/note.png)
|
|
|
Esta função fará uso de qualquer índice que possa estar disponível nos rasters. |
|
|
|
|
Para testar a relação espacial de um raster e uma geometria, usa ST_Polygon no raster, ex.: ST_Coveres(ST_Polygon(raster), geometria) ou ST_Coveres(geometria, ST_Polygon(raster)). |
Disponibilidade: 2.1.0
Exemplos
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