ST_Dwithin

ST_DWithin mengembalikan true jika jarak Euclidean antara proyeksi 2D dari dua nilai geometri input tidak lebih besar dari nilai ambang.

Sintaksis

ST_DWithin(geom1, geom2, threshold)

Argumen

geom1

Nilai tipe data GEOMETRY atau ekspresi yang mengevaluasi ke GEOMETRY tipe.

geom2

Nilai tipe data GEOMETRY atau ekspresi yang mengevaluasi ke GEOMETRY tipe.

ambang batas

Nilai tipe dataDOUBLE PRECISION. Nilai ini ada dalam satuan argumen input.

Jenis pengembalian

BOOLEAN

Jika geom1 atau geom2 adalah null, maka null dikembalikan.

Jika ambang batas negatif, maka kesalahan dikembalikan.

Jika geom1 dan geom2 tidak memiliki nilai yang sama untuk pengenal sistem referensi spasial (SRID), maka kesalahan dikembalikan.

Jika geom1 atau geom2 adalah kumpulan geometri, maka kesalahan dikembalikan.

Contoh

SQL berikut memeriksa apakah jarak antara dua poligon berada dalam lima unit.

SELECT ST_DWithin(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'),5);

st_dwithin
-----------
 true