Tous les produits
Search
Centre de documentation

PolarDB:ST_PixelAsPolygons

Dernière mise à jour :Aug 22, 2026

Renvoie la géométrie polygonale délimitant chaque pixel d'une bande raster, ainsi que la valeur du pixel et ses coordonnées de ligne et de colonne.

Contrairement à ST_DumpAsPolygons, qui regroupe les pixels de même valeur en une seule géométrie, ST_PixelAsPolygons renvoie un polygone par pixel.

Syntaxe

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);

Paramètres

Paramètre Description
raster_obj Le raster à interroger.
band L'identifiant de la bande à interroger. Les identifiants de bande commencent à 0. Valeur par défaut : 0.
pyramid L'identifiant du niveau de pyramide à interroger. Valeur par défaut : 0.
exclude_nodata_value Indique s'il faut exclure les pixels NoData du jeu de résultats. Valeur par défaut : true.

Colonnes de sortie

Chaque ligne renvoyée par la fonction contient les colonnes suivantes :

Colonne Type Description
rowsn integer Le numéro de ligne du pixel.
columnsn integer Le numéro de colonne du pixel.
bandsn integer L'identifiant de la bande à laquelle appartient le pixel.
value double La valeur du pixel.
geom geometry L'étendue spatiale (polygone) du pixel.

Exemple

L'exemple suivant interroge la table rast_table pour les pixels de la bande 1, puis filtre le résultat pour ne conserver que les lignes dont la valeur du pixel est supérieure à 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;

Exemple de sortie :

 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))

Voir aussi

  • ST_DumpAsPolygons — regroupe les pixels de même valeur en géométries polygonales fusionnées

  • ST_PixelAsPolygon — renvoie la géométrie polygonale d'un seul pixel situé à une ligne et une colonne spécifiées

  • ST_PixelAsPoint — renvoie la géométrie ponctuelle d'un seul pixel

  • ST_PixelAsPoints — renvoie les géométries ponctuelles de tous les pixels d'une bande

  • ST_PixelAsCentroid — renvoie le centroïde du polygone d'un seul pixel

  • ST_PixelAsCentroids — renvoie les géométries des centroïdes de tous les pixels d'une bande