st_dwithin fonksiyon

Şunun için geçerlidir: Databricks SQL Databricks Runtime 17.1 ve üzeri

Important

Bu özellik Genel Önizleme aşamasındadır.

Uyarı

Bu özellik Databricks SQL Klasik ambarlarında kullanılamaz. Databricks SQL ambarları hakkında daha fazla bilgi edinmek için bkz. SQL ambar türleri.

İki giriş değeri arasındaki 2B Kartezyen uzaklık, giriş GEOMETRY uzaklığı değerinden küçük veya buna eşitse true döndürür.

Syntax

st_dwithin ( geoExpr1, geoExpr2, distanceExpr )

Arguments

• geoExpr1: İlk GEOMETRY değer.
• geoExpr2: İkinci GEOMETRY değer.
• distanceExpr: Uzaklık eşiği değeri.

Returns

BOOLEAN türünde bir değer, iki giriş GEOMETRY değerinin uzaklığının distanceExpr değerinden daha küçük veya ona eşit olup olmadığını belirtir.

Uzaklık eşiğinin birimleri, giriş geometrilerinin koordinatlarının birimleridir.

Eğer girişlerden herhangi biri NULL ise, işlev NULL döndürür.

Hata koşulları

• İki giriş geometrisi farklı SRID değerlerine sahipse işlev ST_DIFFERENT_SRID_VALUES döndürür.

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

İlgili işlevler

• st_closestpoint işlev
• st_distance işlev