この関数は、ラスタの指定された位置のピクセルを幾何学的オブジェクトに変換するために使用されます。幾何学的オブジェクトのそれぞれは、幾何学的オブジェクトの中心の点によって表されます。
構文
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 | クエリするラスター。The raster that you want to query. |
band | 照会するバンドのID。 有効なバンドIDは0から始まります。 |
pyramid | クエリするピラミッドレベルのID。 |
exclude_nodata_value | NoDataピクセルを除外するかどうかを指定します。 |
rowsn | ピクセルが存在する行の番号。 |
olumnsn | ピクセルが存在する列の番号。 |
bandsn | ピクセルが属するバンドのID。 |
value | ピクセルの値。 |
geom | ピクセルの空間範囲。 |
説明
この関数は、ラスタの指定された位置のピクセルを幾何学的オブジェクトに変換します。幾何学的オブジェクトのそれぞれは、幾何学的オブジェクトの中心の点で表されます。 ST_PixelAspPoints関数のref_pointパラメーターをCENTERに設定すると、指定したピクセルに対して同じ結果が得られます。
例
tmp AS付き
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)