Tous les produits
Search
Centre de documentation

PolarDB:ST_PixelAsPoints

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 un point placé à la position de référence au sein de l'objet.

Syntaxe

setof record ST_PixelAsPoints(raster raster_obj,
    integer band default 0,
    integer pyramid default 0,
    boolean exclude_nodata_value default true,
    cstring ref_point default 'UPPERLEFT',
    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 — Le raster à interroger.
band integer 0 L'ID de la bande à interroger. Les ID de bande valides commencent à 0.
pyramid integer 0 L'ID du niveau de pyramide à interroger.
exclude_nodata_value boolean true Indique s'il faut exclure les pixels NoData.
ref_point cstring 'UPPERLEFT' La position de référence du point au sein de l'objet géométrique. Valeurs valides : UPPERLEFT (coin supérieur gauche) et CENTER (centre).
rowsn out integer — Le numéro de ligne du pixel.
columnsn out integer — Le numéro de colonne du pixel.
bandsn out integer — L'ID de bande du pixel.
value out double — La valeur du pixel.
geom out geometry — L'étendue spatiale du pixel.

Description

La fonction ST_PixelAsPoints convertit les pixels d'un raster situés à une position donnée en objets géométriques. Chaque objet géométrique est représenté par un seul point, positionné selon le paramètre ref_point : soit le coin supérieur gauche (UPPERLEFT), soit le centre (CENTER) de la géométrie du pixel.

Exemple

L'exemple suivant récupère tous les pixels de la bande 1 du raster dont l'id = 10, puis filtre ceux dont la valeur est supérieure à 38.0. Il renvoie pour chaque pixel le numéro de ligne, le numéro de colonne, la bande, la valeur et la géométrie au format Extended WKT.

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

Résultat :

 rowsn | columnsn | bandsn | value |         st_asewkt
-------+----------+--------+-------+---------------------------
   100 |      100 |      0 |    43 | SRID=4326;POINT(-90 0)