MaxCompute:ST_COVERS

Sintaksis

BOOLEAN ST_COVERS(GEOGRAPHY <value1>, GEOGRAPHY <value2>)

Parameter

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.

Nilai kembalian

Mengembalikan nilai BOOLEAN.

• Mengembalikan TRUE jika semua titik pada objek geografi kedua berada di batas atau di dalam objek geografi pertama; jika tidak, mengembalikan FALSE.

• Mengembalikan FALSE jika value1 atau value2 merupakan objek geografi kosong.

Objek geografi mencakup boundary nodes-nya sendiri.

Contoh

• Contoh 1: Memeriksa apakah poligon POLYGON ((0 0, 1 0, 1 1, 0 1, 0 0)) mencakup tiga titik: (5, 5) di luar poligon, (0, 0) pada batasnya, dan (0.5, 0.5) di bagian dalamnya.

  -- Mengembalikan TRUE karena point(0 0) berada pada boundary node poligon.
  SELECT ST_COVERS(ST_GEOGFROMTEXT('POLYGON ((0 0, 1 0, 1 1, 0 1, 0 0))'), ST_GEOGPOINT(0, 0));
  
  -- Mengembalikan TRUE karena point(0.5 0.5) berada di interior poligon.
  SELECT ST_COVERS(ST_GEOGFROMTEXT('POLYGON ((0 0, 1 0, 1 1, 0 1, 0 0))'), ST_GEOGPOINT(0.5, 0.5));
  
  -- Mengembalikan FALSE karena point(5 5) berada di luar poligon.
  SELECT ST_COVERS(ST_GEOGFROMTEXT('POLYGON ((0 0, 1 0, 1 1, 0 1, 0 0))'), ST_GEOGPOINT(5, 5));

• Contoh 2: Menunjukkan bahwa ST_COVERS mengembalikan FALSE ketika salah satu argumen merupakan objek geografi kosong.

  -- Mengembalikan FALSE
  SELECT ST_COVERS(ST_GEOGFROMTEXT('POLYGON ((0 0, 1 0, 1 1, 0 1, 0 0))'),ST_GEOGFROMTEXT('point empty'));

Topik terkait

• Tipe data GEOGRAPHY

• Ikhtisar fungsi geospasial

• Spatial join