Mengembalikan kotak pembatas (bounding box) suatu raster sebagai nilai BOX PostgreSQL dalam format ((maxX,maxY),(minX,minY)).
Sintaksis
BOX ST_Extent(raster raster_obj, CoorSpatialOption csOption = 'WorldFirst')
BOX ST_Extent(raster raster_obj, integer pyramid, CoorSpatialOption csOption = 'WorldFirst')Parameter
| Parameter | Deskripsi |
|---|---|
raster_obj | Objek raster yang akan dikueri. |
pyramid | Tingkat piramida yang akan dikueri. Nilai valid dimulai dari 0. |
csOption | Ruang koordinat yang digunakan. Nilai default: WorldFirst. |
Deskripsi
ST_Extent mengembalikan nilai BOX yang merepresentasikan kotak pembatas raster tersebut. Formatnya adalah ((maxX,maxY),(minX,minY))—koordinat kanan atas ditampilkan terlebih dahulu, diikuti oleh koordinat kiri bawah.
Parameter csOption mengontrol ruang koordinat yang digunakan:
| Nilai | Perilaku |
|---|---|
Raster | Mengembalikan koordinat piksel. |
World | Mengembalikan koordinat dunia (geografis). |
WorldFirst | Mengembalikan koordinat dunia jika raster telah direferensikan secara geografis; jika tidak, mengembalikan koordinat piksel. |
WorldFirst merupakan nilai default. Jika raster tidak direferensikan secara geografis dan Anda memanggil ST_Extent tanpa menentukan csOption, hasilnya berupa koordinat piksel. Untuk selalu mendapatkan koordinat dunia, gunakan secara eksplisit 'World'::CoorSpatialOption.
Contoh
Kembalikan koordinat piksel:
SELECT ST_Extent(raster_obj, 'Raster'::CoorSpatialOption) FROM raster_table;Hasil:
((255,255),(0,0))Kembalikan koordinat dunia:
SELECT ST_Extent(raster_obj, 'World'::CoorSpatialOption) FROM raster_table;Kembalikan koordinat dunia pada tingkat piramida tertentu:
SELECT ST_Extent(raster_obj, 2, 'World'::CoorSpatialOption) FROM raster_table;