ST_DWithin
ST_DWithin devuelve true si la distancia euclidiana entre las proyecciones 2D de los dos valores de geometría de entrada no es mayor que el valor de un límite.
Sintaxis
ST_DWithin(geom1, geom2, threshold)
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. - threshold
-
Un valor de tipo de datos
DOUBLE PRECISION. Este valor está en las mismas unidades que los argumentos de entrada.
Tipo de retorno
BOOLEAN
Si geom1 o geom2 son null, entonces se devuelve el valor null.
Si threshold es negativo, se devuelve un error.
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 comprueba si la distancia entre dos polígonos está en un rango de cinco unidades.
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
