ApsaraDB RDS:ST_Values

set of record ST_Values(raster raster_obj,
                     geometry geom,
                     integer pyramidLevel default 0,
                     cstring bands default '', /* All bands */
                     cstring clipOption default '',
                     out point cords,
                     out integer band,
                     out float8 value)

SELECT (ST_Values(rast, geom)).*
FROM your_table;

SELECT (ST_Values(rast, geom)).cords,
       (ST_Values(rast, geom)).value
FROM your_table;

Paramètres d'entrée

Champs de sortie

Paramètres clipOption

Quand utiliser window_clip :

• Utilisez window_clip: true lorsque vous souhaitez récupérer toutes les cellules situées dans l'enveloppe rectangulaire d'un objet géométrique, par exemple lors d'un découpage avec un point, afin de capturer la grille de pixels environnante plutôt que la seule intersection exacte.

• Utilisez window_clip: false (valeur par défaut) lorsque vous avez besoin d'une intersection précise avec la forme réelle de l'objet géométrique, comme un découpage le long d'une linestring ou d'une limite de polygone.

Découpage avec un objet géométrique de type point

Le fait de définir window_clip sur true permet de récupérer la grille de pixels située dans le MBR du point, plutôt qu'une seule cellule d'intersection exacte.

SELECT (ST_Values(rast, ST_geomfromtext('POINT(128.135 29.774)', 4326)::geometry, 0,'{"window_clip":"true"}')).*
FROM rat_clip WHERE id=1;
    coord     | band | value
--------------+------+-------
 (127.8,29.7) |    0 |    11
 (127.8,29.7) |    1 |    10
 (127.8,29.7) |    2 |    50
(3 rows)

Découpage avec un objet géométrique de type linestring

Cet exemple découpe le raster en utilisant la forme exacte d'une linestring, en renvoyant jusqu'à 10 lignes pour toutes les bandes.

SELECT (ST_Values(rast, ST_geomfromtext('LINESTRING(0 0, 45 45, 90 0, 135 45)', 4326)::geometry, 0)).*
FROM rat_clip WHERE id=1 LIMIT 10;
    coord    | band | value
-------------+------+-------
 (44.1,45)   |    0 |   115
 (44.1,45)   |    1 |   112
 (44.1,45)   |    2 |    69
 (45,45)     |    0 |   122
 (45,45)     |    1 |   117
 (45,45)     |    2 |    75
 (134.1,45)  |    0 |    37
 (134.1,45)  |    1 |    64
 (134.1,45)  |    2 |    13
 (43.2,44.1) |    0 |    66
(10 rows)