ST_Contains
ST_Contains devuelve true si la proyección 2D de la primera geometría de entrada contiene la proyección 2D de la segunda geometría de entrada. La geometría A contiene geometría B si cada punto de B es un punto en A, y sus interiores tienen intersecciones no vacías.
ST_Contains(A, B) es equivalente a ST_Within(B, A).
Sintaxis
ST_Contains(geom1, geom2)
Argumentos
- geom1
-
Un valor de tipo de datos
GEOMETRYo una expresión que toma el valor de un tipoGEOMETRY. - geom2
-
Un valor de tipo de datos
GEOMETRYo una expresión que toma el valor de un tipoGEOMETRY. Este valor se compara con geom1 para determinar si está contenido dentro de 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 contiene el segundo polígono.
SELECT ST_Contains(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'));
st_contains
-----------
false
