Compartilhar via


st_dwithin Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Esse recurso está em Visualização Pública.

Observação

Esse recurso não está disponível em databricks SQL Classic warehouses. Para saber mais sobre os sql warehouses do Databricks, consulte os tipos de sql warehouse.

Retornará 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: Valor primeiro de GEOMETRY.
  • geoExpr2: o segundo valor GEOMETRY.
  • distanceExpr: o valor do limite de distância.

Returns

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

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

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

Condições de erro

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