Mengembalikan geometri poligon yang membatasi setiap piksel pada suatu band raster, lengkap dengan nilai piksel serta koordinat baris dan kolomnya.
Berbeda dengan ST_DumpAsPolygons, yang mengelompokkan piksel-piksel bernilai sama ke dalam satu geometri tunggal, ST_PixelAsPolygons mengembalikan satu poligon untuk setiap piksel.
Sintaksis
setof record ST_PixelAsPolygons(raster raster_obj,
integer band default 0,
integer pyramid default 0,
boolean exclude_nodata_value default true,
out integer rowsn,
out integer columnsn,
out integer bandsn,
out double value,
out geometry geom);Parameter
| Parameter | Deskripsi |
|---|---|
raster_obj | Raster yang akan dikueri. |
band | ID band yang akan dikueri. ID band dimulai dari 0. Default: 0. |
pyramid | ID level piramida yang akan dikueri. Default: 0. |
exclude_nodata_value | Menentukan apakah piksel NoData dikeluarkan dari set hasil. Default: true. |
Kolom output
Setiap baris yang dikembalikan oleh fungsi ini mencakup kolom-kolom berikut:
| Kolom | Tipe | Deskripsi |
|---|---|---|
rowsn | integer | Nomor baris piksel. |
columnsn | integer | Nomor kolom piksel. |
bandsn | integer | ID band tempat piksel tersebut berada. |
value | double | Nilai piksel. |
geom | geometry | Cakupan spasial (poligon) dari piksel tersebut. |
Contoh
Contoh berikut mengkueri rast_table untuk piksel-piksel pada band 1, lalu memfilter hasilnya ke baris-baris di mana nilai piksel melebihi 38,0.
WITH tmp AS (
SELECT (ST_PixelAsPolygons(rast, 1)).*
FROM rast_table
WHERE id = 10
)
SELECT rowsn, columnsn, bandsn, value, ST_AsEWKT(geom)
FROM tmp
WHERE value > 38.0;Output contoh:
rowsn | columnsn | bandsn | value | st_asewkt
-------+----------+--------+-------+------------------------------------------------------------
100 | 100 | 0 | 43 | SRID=4326;POLYGON((-180 90,-180 89.1,-179.1 89.1,-179.1 90,-180 90))Lihat juga
ST_DumpAsPolygons— mengelompokkan piksel-piksel bernilai sama ke dalam satu geometri poligon gabunganST_PixelAsPolygon— mengembalikan geometri poligon untuk satu piksel pada baris dan kolom tertentuST_PixelAsPoint— mengembalikan geometri titik untuk satu pikselST_PixelAsPoints— mengembalikan geometri titik untuk semua piksel dalam suatu bandST_PixelAsCentroid— mengembalikan pusat (centroid) poligon untuk satu pikselST_PixelAsCentroids— mengembalikan geometri pusat (centroid) untuk semua piksel dalam suatu band