ST_CoveredBy

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

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

Sintaxis

ST_CoveredBy(geom1, geom2)

Argumentos

geom1

Un valor de tipo de datos GEOMETRY o una expresión que toma el valor de un tipo GEOMETRY. Este valor se compara con geom2 para determinar si está cubierto por geom2.

geom2

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

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 está cubierto por el segundo polígono.

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

st_coveredby
-----------
 true