st_dwithin Función

Se aplica a: Databricks SQL Databricks Runtime 17.1 y versiones posteriores

Important

Esta característica está en versión preliminar pública.

Nota:

Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.

Devuelve true si la distancia cartesiana 2D entre los dos valores de entrada GEOMETRY es menor o igual que el valor de distancia de entrada.

Syntax

st_dwithin ( geoExpr1, geoExpr2, distanceExpr )

Arguments

• geoExpr1: el primer GEOMETRY valor.
• geoExpr2: El segundo GEOMETRY valor.
• distanceExpr: valor de umbral de distancia.

Returns

Valor de tipo BOOLEAN, que indica si la distancia de los dos valores de entrada GEOMETRY es menor o igual que el valor de distanceExpr.

Las unidades del umbral de distancia son las de las coordenadas de las geometrías de entrada.

La función devuelve NULL si alguna de las entradas es NULL.

Condiciones de error

• Si las dos geometrías de entrada tienen valores SRID diferentes, la función devuelve ST_DIFFERENT_SRID_VALUES.

Examples

-- Returns true as the distance between the point and linestring is within the threshold.
> SELECT st_dwithin(st_geomfromtext('POINT Z (0 0 300)'),st_geomfromtext('LINESTRING(-10 10,20 10)'), 10.0);
  true
-- Returns false as the distance between the geometries exceeds the threshold.
> SELECT st_dwithin(st_geomfromtext('POINT(0 0)'),st_geomfromtext('POINT(20 20)'), 10.0);
  false

Funciones relacionadas

• st_distance Función