全部产品
Search
文档中心

PolarDB:ST_PointValues

更新时间:Jul 02, 2025

Topik ini menjelaskan fungsi ST_PointValues, yang mengembalikan nilai piksel untuk semua band pada lokasi tertentu.

Sintaksis

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

Parameter

Parameter

Deskripsi

raster_obj

Objek raster.

column_sn

Indeks kolom piksel, dimulai dari pojok kiri atas.

row_sn

Indeks baris piksel, dimulai dari pojok kiri atas.

x

Bujur piksel.

y

Lintang piksel.

exclude_nodata

Menentukan apakah akan mengecualikan nilai NoData.

Jika Anda mengatur parameter ini ke true, piksel dengan nilai NoData tidak akan dikembalikan.

band

Nomor band piksel.

value

Nilai piksel.

options

Metode resampling piksel. Tentukan parameter dalam format string JSON.

  • resample: metode resampling. Nilai yang valid:

    • none: tanpa pemrosesan.

    • idw: resampling pembobotan jarak terbalik (IDW).

    • mean: resampling nilai rata-rata.

    • max: resampling nilai maksimum.

    • min: resampling nilai minimum.

Nilai Pengembalian

Nilai pengembalian

Deskripsi

band

Nomor band.

value

Nilai piksel.

Deskripsi

  • Fungsi ini mengembalikan nilai piksel dari semua band berdasarkan nomor kolom dan baris atau koordinat bujur dan lintang.

  • Jika parameter resample dikonfigurasi, empat nilai piksel tetangga terlibat dalam perhitungan.

    image

Contoh

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

    Hasil contoh:

     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;

    Hasil contoh:

     band | value
    ------+-------
        0 |    39
        1 |    66
        2 |    11
  • Tentukan metode resampling idw.

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

    Hasil contoh:

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