Tous les produits
Search
Centre de documentation

PolarDB:ST_PixelAsCentroids

Dernière mise à jour :Aug 22, 2026

Convertit les pixels d'un raster situés à une position donnée en objets géométriques, chacun représenté par le centroïde du pixel.

Syntaxe

setof record ST_PixelAsCentroids(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);

Paramètres

Paramètre Type Par défaut Description
raster_obj raster — Raster à interroger.
band integer 0 Identifiant de la bande à interroger. Les identifiants valides commencent à 0.
pyramid integer 0 Niveau de pyramide à interroger.
exclude_nodata_value boolean true Indique s'il faut exclure les pixels NoData.
rowsn out integer — Numéro de ligne du pixel.
columnsn out integer — Numéro de colonne du pixel.
bandsn out integer — Identifiant de la bande du pixel.
value out double — Valeur du pixel.
geom out geometry — Étendue spatiale du pixel.

Description

La fonction ST_PixelAsCentroids renvoie les mêmes résultats que ST_PixelAsPoints lorsque le paramètre ref_point de ST_PixelAsPoints est défini sur CENTER.

Exemples

WITH tmp AS (
SELECT (ST_PixelAsCentroids(rast, 1)).*
FROM rast_table
WHERE id = 10 )
SELECT rowsn, columnsn, bandsn, value, ST_AsEWKT(geom)  FROM tmp WHERE value > 38.0;

----------------------------------------------------
    100 |      100 |      0 |    43 | SRID=4326;POINT(-89.5 0.5)