すべてのプロダクト
Search

このプロダクト

    ApsaraDB RDS:ST_PointValues

    ドキュメントセンター

    ApsaraDB RDS:ST_PointValues

    最終更新日:Aug 21, 2026

    ラスタオブジェクト内の特定の場所にあるすべてのバンドのピクセル値を返します。

    構文

    SETOF record ST_PointValues(raster raster_obj, integer column_sn, integer row_sn, boolean exclude_nodata DEFAULT true, OUT integer* band, OUT float8 value)

SETOF record ST_PointValues(raster raster_obj, float8 x, float8 y, boolean exclude_nodata DEFAULT true, text options DEFAULT '{}', OUT integer band, OUT float8 value)

    1 つ目のオーバーロードは、列と行のインデックスでピクセルを特定します。2 つ目のオーバーロードは、経度と緯度でピクセルを特定し、必要に応じてリサンプリングを行います。

    パラメーター

    パラメーター説明
    raster_objラスタオブジェクト。
    column_sn対象ピクセルの列インデックス。左上隅を起点とします。
    row_sn対象ピクセルの行インデックス。左上隅を起点とします。
    x対象ピクセルの経度。
    y対象ピクセルの緯度。
    exclude_nodataNoData 値を除外するかどうかを指定します。true に設定すると、NoData 値を持つピクセルは返されません。デフォルト値： true。
    optionsJSON 文字列で指定するリサンプリングメソッド。以下のサブパラメーター resample を参照してください。デフォルト値： '{}'。
    band出力パラメーター。ピクセルのバンド番号。
    value出力パラメーター。ピクセル値。

    options サブパラメーター： resample

    resample を設定すると、4 つの近傍ピクセルを使用して計算します。

    値説明
    noneリサンプリングなし。
    idw逆距離加重 (IDW) リサンプリング。
    mean平均値リサンプリング。
    max最大値リサンプリング。
    min最小値リサンプリング。

    例： '{"resample": "idw"}'

    戻り値

    フィールド型説明
    bandintegerバンド番号。
    valuefloat8バンドのピクセル値。

    説明

    ST_PointValues は、指定した場所にあるすべてのバンドのピクセル値を返します。場所は、ピクセル座標 (column_sn、row_sn) または地理座標 (経度 x、緯度 y) で指定します。

    resample オプションを指定すると、この関数は 4 つの近傍ピクセルを使用して戻り値を計算します：

    image

    例

    地理座標でのクエリ

    次の例では、経度/緯度座標を使用して、t_pixel に格納されたラスタのうち id = 3 のピクセル値をクエリします。

    NoData 値の除外を無効にしたクエリ (exclude_nodata = false)：

    SELECT * FROM
    (SELECT (st_pointValues(rast, 125.84382034243441, 47.67709555783107, false)).*
     FROM t_pixel WHERE id = 3) a
ORDER BY band;

    結果：

     band | value
------+-------
    0 |    66
    1 |    87
    2 |    28

    地理座標 (整数) を使用したクエリ：

    SELECT * FROM
    (SELECT (st_pointValues(rast, 125, 47)).*
     FROM t_pixel WHERE id = 3) a
ORDER BY band;

    結果：

     band | value
------+-------
    0 |    39
    1 |    66
    2 |    11

    IDW リサンプリングを使用したクエリ

    idw リサンプリングメソッドを指定します。

    SELECT * FROM
    (SELECT (st_pointValues(rast, 125.84382034243441, 47.67709555783107, false, '{"resample": "idw"}')).*
     FROM t_pixel WHERE id = 3) a
ORDER BY band;

    結果：

     band | value
------+--------------------
    0 |  60.81401293159196
    1 |  85.23822259113626
    2 | 26.300926205142165