ST_Within

ST_Within devuelve true si la proyección 2D de la primera geometría de entrada está dentro de la proyección 2D de la segunda geometría de entrada.

Por ejemplo, la geometría A contiene geometría B si cada punto de A es un punto en B, y sus interiores tienen intersecciones no vacías.

ST_Within(A, B) es equivalente a ST_Contains(B, A).

Sintaxis

ST_Within(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á dentro de 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 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 comprueba si el primer polígono está dentro del segundo polígono.

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

st_within
-----------
 true