fungsi st_dwithin

Berlaku untuk: pemeriksaan Databricks SQL Databricks Runtime 17.1 ke atas

Important

Fitur ini ada di Pratinjau Publik.

Nota

Fitur ini tidak tersedia di gudang Databricks SQL Classic. Untuk mempelajari selengkapnya tentang gudang Databricks SQL, lihat Jenis gudang SQL.

Mengembalikan true jika jarak Kartesius 2D antara dua nilai input GEOMETRY lebih kecil dari atau sama dengan nilai jarak input.

Syntax

st_dwithin ( geoExpr1, geoExpr2, distanceExpr )

Arguments

• geoExpr1: Nilai pertama GEOMETRY.
• geoExpr2: Nilai kedua GEOMETRY.
• distanceExpr: Nilai ambang batas jarak.

Returns

Nilai jenis BOOLEAN, menunjukkan apakah jarak dua nilai input GEOMETRY lebih kecil atau sama dengan nilai distanceExpr.

Unit ambang batas jarak adalah sama dengan unit dari koordinat geometri yang dimasukkan.

Fungsi mengembalikan NULL jika salah satu input adalah NULL.

Kondisi kesalahan

• Jika dua geometri input memiliki nilai SRID yang berbeda, fungsi akan mengembalikan 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

Fungsi terkait

• st_closestpoint fungsi
• st_distance fungsi