Fungsi ST_DISTANCE mengembalikan jarak terpendek antara dua objek GEOGRAPHY dalam satuan meter.
Syntax
DOUBLE ST_DISTANCE(GEOGRAPHY <value1>, GEOGRAPHY <value2>)Parameters
value1, value2: Wajib diisi. Nilai dengan tipe data GEOGRAPHY. Anda dapat membuat objek GEOGRAPHY menggunakan fungsi seperti ST_GEOGPOINT, ST_GEOGFROMWKB, ST_GEOGFROMTEXT, ST_MAKELINE, dan ST_MAKEPOLYGON.
Return value
Mengembalikan nilai DOUBLE yang merepresentasikan jarak terpendek antara dua objek GEOGRAPHY dalam satuan meter. Aturan berikut berlaku:
Jika salah satu dari
value1atauvalue2merupakan objek GEOGRAPHY kosong, fungsi akan mengembalikan NULL.Karena keterbatasan presisi pada S2 Geometry Library, nilai yang dikembalikan mungkin sedikit berbeda dari jarak sebenarnya.
Examples
Contoh 1: Hitung jarak terpendek antara dua titik
SELECT ST_DISTANCE(ST_GEOGFROMTEXT('POINT(0 0)'), ST_GEOGFROMTEXT('POINT(1 1)')); -- Returns: +-----------------------+ | _c0 | +-----------------------+ | 157249.62809250783 | +-----------------------+Contoh 2: Tangani objek GEOGRAPHY kosong
-- Mengembalikan NULL karena objek geography kedua kosong. SELECT ST_DISTANCE(ST_GEOGFROMTEXT('POINT(0 0)'), ST_GEOGFROMTEXT('POINT EMPTY'));