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_DWithin
ST_DWithin restituisce true se la distanza euclidea tra le proiezioni 2D dei due valori della geometria di input non è maggiore di un valore soglia.
Sintassi
ST_DWithin(geom1, geom2, threshold)
Argomenti
- geom1
-
Un valore di tipo
GEOMETRY
o un'espressione che restituisce un valore di tipoGEOMETRY
. - geom2
-
Un valore di tipo
GEOMETRY
o un'espressione che restituisce un valore di tipoGEOMETRY
. - soglia
-
Un valore di tipo
DOUBLE PRECISION
. Questo valore è espresso nelle unità di misura utilizzate per gli argomenti di input.
Tipo restituito
BOOLEAN
Se geom1 o geom2 sono nulli, allora viene restituito il valore nullo.
Se la soglia è negativa, allora viene restituito un errore.
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 controlla se la distanza tra due poligoni è inferiore a cinque unità.
SELECT ST_DWithin(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'),5);
st_dwithin
-----------
true