ST_Covers

更新时间:
复制 MD 格式

Checks whether a raster object fully covers another raster object or a geometry object in the same spatial reference system (SRS).

Syntax

bool ST_Covers(raster rast1, raster rast2);
bool ST_Covers(raster rast, geometry geom);
bool ST_Covers(geometry geom, raster rast);

Parameters

ParameterDescription
rast1Raster object 1.
rast2Raster object 2.
rastThe raster object.
geomThe geometric object.

Description

The function accepts three input combinations:

  • Raster vs. raster: Tests whether rast1 covers rast2.

  • Raster vs. geometry: Tests whether rast covers geom, or whether geom covers rast, depending on argument order.

Examples

SELECT a.id FROM tbl_a a, tbl_b b WHERE ST_Covers(a.rast, b.rast);
 id
----
  1
(1 row)