st_dwithin Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 e superior

Retorna true se a distância cartesiana 2D entre os dois valores de entrada GEOMETRY for menor ou igual ao valor da distância de entrada.

Syntax

st_dwithin ( geoExpr1, geoExpr2, distanceExpr )

Arguments

• geoExpr1: O primeiro GEOMETRY valor.
• geoExpr2: O segundo GEOMETRY valor.
• distanceExpr: O valor do limite de distância.

Returns

Um valor do tipo BOOLEAN, indicando se a distância dos dois valores de entrada GEOMETRY é menor ou igual ao valor de distanceExpr.

As unidades do limiar de distância são as das coordenadas das geometrias de entrada.

A função retorna NULL se qualquer uma das entradas for NULL.

Condições de erro

• Se as duas geometrias de entrada tiverem valores SRID diferentes, a função retornará 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

Funções relacionadas

• st_closestpoint Função
• st_distance Função