Definición
La función ST_Raster.getValue devuelve el valor de un único píxel dado que la ubicación de píxel se encuentra dentro del objeto ST_Raster. La ubicación se puede especificar en coordenadas de píxel o mediante coordenadas geográficas. La función muestra un error cuando la ubicación especificada se encuentra fuera de la dimensión del píxel de ráster o de la extensión geográfica. ST_Raster.GetValue devuelve NULL si el valor de píxel en la ubicación especificada es NoData.
Sintaxis
Oracle
getValue (band INTEGER, level INTEGER, x INTEGER, y INTEGER) getValue (band INTEGER, level INTEGER, point SE_COORD)
PostgreSQL
getValue (raster IN ST_RASTER, band INT, level INT, x INT, y INT) getValue (raster IN ST_RASTER, band INT, level INT, point SE_COORD)
SQL Server
getValue (band IN NUMBER, level IN NUMBER, x IN NUMBER, y IN NUMBER) getValueByLoc (band IN NUMBER, level IN NUMBER, x IN DOUBLE, y IN DOUBLE)
Devuelve
Oracle
Número
PostgreSQL
Float8
SQL Server
Doble
Parámetros
| Parámetro | Descripción |
|---|---|
band | Número de banda (a partir de 1) del píxel |
level | Nivel de pirámide del píxel |
x | Coordenada de píxel x |
y | Coordenada de píxel y |
point | Coordenadas geográficas del píxel |
raster | El objeto ST_Raster que contiene el valor de píxel |
Ejemplos
El primer ejemplo devuelve los valores de píxel de la banda 1, 2 y 3 para el nivel de pirámide básico en la ubicación de píxel (0,0).
El segundo ejemplo devuelve los valores de píxel para el nivel de pirámide básico para las bandas 1, 2 y 3 en una ubicación geográfica (100.5, 20.5).
Oracle
SELECT t.image.getValue(1,0,0,0) r, t.image.getValue(2,0,0,0) g, t.image.getValue(3,0,0,0) b FROM VEG t WHERE t.image.raster_id = 1; R G B ---------- ---------- ---------- 83 49 173SELECT t.image.getValue(1,0,se_coord(100.5,20.5)) r, t.image.getValue(2,0,se_coord(100.5,20.5)) g, t.image.getValue(3,0,se_coord(100.5,20.5)) b FROM VEG t WHERE t.image.raster_id = 1; R G B ---------- ---------- ---------- 83 49 173
PostgreSQL
SELECT getValue(image,1,0,0,0) r, getValue(image,2,0,0,0) g, getValue(image,3,0,0,0) b FROM veg WHERE raster_id(image) = 1; R G B ---------- ---------- ---------- 83 49 173SELECT getValue(image,1,0,se_coord(100.5,20.5)) r, getValue(image,2,0,se_coord(100.5,20.5)) g, getValue(image,3,0,se_coord(100.5,20.5)) b FROM veg WHERE raster_id(image) = 1; R G B ---------- ---------- ---------- 83 49 173
SQL Server
SELECT image.getValue(1,0,0,0) r, image.getValue(2,0,0,0) g, image.getValue(3,0,0,0) b FROM veg WHERE image.raster_id = 1; R G B ---------- ---------- ---------- 83 49 173SELECT getValueByLoc(image,1,0,100.5,20.5) as r, getValueByLoc(image,2,0,100.5,20.5) as g, getValueByLoc(image,3,0,100.5,20.5) as b FROM veg WHERE image.raster_id = 1; R G B ---------- ---------- ---------- 83 49 173