指定された位置にあるラスタのピクセルを、それぞれそのピクセルの重心で表されるジオメトリオブジェクトに変換します。
構文
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);パラメーター
| パラメーター | 型 | デフォルト | 説明 |
|---|---|---|---|
raster_obj | raster | — | クエリ対象のラスタです。 |
band | integer | 0 | クエリ対象のバンド ID です。有効なバンド ID は 0 から始まります。 |
pyramid | integer | 0 | クエリ対象のピラミッドレベルです。 |
exclude_nodata_value | boolean | true | NoData ピクセルを除外するかどうかを指定します。 |
rowsn | out integer | — | ピクセルの行番号です。 |
columnsn | out integer | — | ピクセルの列番号です。 |
bandsn | out integer | — | ピクセルのバンド ID です。 |
value | out double | — | ピクセル値です。 |
geom | out geometry | — | ピクセルの空間範囲です。 |
説明
ST_PixelAsCentroids は、ST_PixelAsPoints の ref_point パラメーターを CENTER に設定した場合と同一の結果を返します。詳細については、「ST_PixelAsPoints」をご参照ください。
使用例
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)