All Products
Search
Document Center

ApsaraDB RDS:ST_PixelAsPolygons

Last Updated:Mar 28, 2026

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

ParameterDeskripsi
raster_objRaster yang akan dikueri.
bandID band yang akan dikueri. ID band dimulai dari 0. Default: 0.
pyramidID level piramida yang akan dikueri. Default: 0.
exclude_nodata_valueMenentukan apakah piksel NoData dikeluarkan dari set hasil. Default: true.

Kolom output

Setiap baris yang dikembalikan oleh fungsi ini mencakup kolom-kolom berikut:

KolomTipeDeskripsi
rowsnintegerNomor baris piksel.
columnsnintegerNomor kolom piksel.
bandsnintegerID band tempat piksel tersebut berada.
valuedoubleNilai piksel.
geomgeometryCakupan 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 gabungan

  • ST_PixelAsPolygon — mengembalikan geometri poligon untuk satu piksel pada baris dan kolom tertentu

  • ST_PixelAsPoint — mengembalikan geometri titik untuk satu piksel

  • ST_PixelAsPoints — mengembalikan geometri titik untuk semua piksel dalam suatu band

  • ST_PixelAsCentroid — mengembalikan pusat (centroid) poligon untuk satu piksel

  • ST_PixelAsCentroids — mengembalikan geometri pusat (centroid) untuk semua piksel dalam suatu band