Fungsi ST_CONTAINS menentukan apakah value1 berisi value2.
Syntax
BOOLEAN ST_CONTAINS(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 BOOLEAN:
TRUE jika setiap titik dalam value2 berada di dalam value1; jika tidak, FALSE.
FALSE jika value1 atau value2 merupakan objek geografi kosong.
Objek geografi tidak mencakup batasnya sendiri.
Examples
Contoh berikut menguji apakah poligon POLYGON((0 0, 10 0, 10 10, 0 10, 0 0)) berisi tiga titik: satu di luar poligon (20, 20), satu pada batasnya (0, 0), dan satu di dalamnya (5, 5).
-- Mengembalikan TRUE karena POINT(5 5) berada di dalam poligon.
SELECT ST_CONTAINS(ST_GEOGFROMTEXT('POLYGON((0 0, 10 0, 10 10, 0 10, 0 0))'), ST_GEOGFROMTEXT('POINT(5 5)'));
-- Mengembalikan FALSE karena POINT(20 20) berada di luar poligon.
SELECT ST_CONTAINS(ST_GEOGFROMTEXT('POLYGON((0 0, 10 0, 10 10, 0 10, 0 0))'), ST_GEOGFROMTEXT('POINT(20 20)'));
-- Mengembalikan FALSE karena POINT(0 0) berada pada batas poligon.
SELECT ST_CONTAINS(ST_GEOGFROMTEXT('POLYGON((0 0, 10 0, 10 10, 0 10, 0 0))'), ST_GEOGFROMTEXT('POINT(0 0)'));