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 tipoGEOMETRY
. 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 tipoGEOMETRY
.
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