Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
ST_Within
ST_Within restituisce true se la proiezione 2D della prima geometria di input è all'interno della proiezione 2D della seconda geometria di input.
Ad esempio, l'oggetto geometrico A
è contenuto all'interno dell'oggetto geometrico B
se ogni punto di A
è un punto di B
e le loro aree interne presentano un'intersezione non vuota.
ST_Within(A
, B
) è equivalente a ST_Contains(B
, A
).
Sintassi
ST_Within(geom1, geom2)
Argomenti
- geom1
-
Un valore di tipo
GEOMETRY
o un'espressione che restituisce un valore di tipoGEOMETRY
. Questo valore è confrontato con geom2 per determinare se è contenuto all'interno di geom2. - geom2
-
Un valore di tipo
GEOMETRY
o un'espressione che restituisce un valore di tipoGEOMETRY
.
Tipo restituito
BOOLEAN
Se geom1 o geom2 sono nulli, allora viene restituito il valore nullo.
Se geom1 e geom2 non presentano lo stesso valore di identificatore del sistema di riferimento spaziale (SRID), allora viene restituito il valore nullo.
Se geom1 o geom2 sono una collezione di geometrie, allora viene restituito il valore nullo.
Esempi
Il seguente comando SQL verifica se il primo poligono si trova all'interno del secondo poligono.
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