Name

ST_Covers — Retourne true si aucun point du raster rastB ne se trouve à l'extérieur du raster rastA.

Synopsis

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

boolean ST_Covers( raster rastA , raster rastB );

Description

Le raster rastA recouvre le raster rastB si et seulement si aucun point du raster rastB ne se trouve à l'extérieur du raster rastA. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

[Note]

Cette fonction utilisera tous les index qui peuvent être disponibles sur les données raster.

[Note]

Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Covers(ST_Polygon(raster), geometry) ou ST_Covers(geometry, ST_Polygon(raster)).

Disponibilité : 2.1.0

Exemples

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
            

Voir aussi

ST_Intersects, ST_CoveredBy