ST_Covers

ST_Covers devuelve true si la proyección 2D de la primera geometría de entrada cubre la proyección 2D de la segunda geometría de entrada. La geometría A cubre la geometría B si ninguna de ellas está vacía y cada punto de B es un punto en A.

ST_Covers(A, B) es equivalente a ST_CoveredbBy(B, A).

Sintaxis

ST_Covers(geom1, geom2)

Argumentos

geom1

Un valor de tipo de datos GEOMETRY o una expresión que toma el valor de un tipo GEOMETRY.

geom2

Un valor de tipo de datos GEOMETRY o una expresión que toma el valor de un tipo GEOMETRY. Este valor se compara con geom1 para determinar si cubre geom1.

Tipo de retorno

BOOLEAN

Si geom1 o geom2 son null, entonces se devuelve el valor null.

Si geom1 y geom2 no tienen el mismo valor en el identificador de sistema de referencia espacial (SRID), se devuelve un error.

Si geom1 o geom2 son una colección geométrica, se devuelve un error.

Ejemplos

El siguiente SQL revisa si el primer polígono cubre el segundo polígono.

SELECT ST_Covers(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'));

st_covers
-----------
 false