90. Query: Obtener datos de imágenes satelitales por geometría
Obtener estadísticas de índices de vegetación para cualquier geometría ad-hoc - no se requiere un límite de campo registrado. Este endpoint calcula estadísticas resumidas para los píxeles dentro de su geometría mientras ignora los píxeles con nubes. Actualmente compatible en Sentinel2 (S2) , Landsat (L4/L5/L7/L8/L9) y Planet (PS) proveedores.
Esta página sigue los patrones de la API de GeoPard y autenticación utilizada en los endpoints de GraphQL.
Qué puedes hacer
Consultar índices de vegetación para geometrías Point, MultiPoint, Polygon y MultiPolygon. geometrías.
Elegir proveedores de imágenes proveedores: S2, L4, L5, L7, L8, L9, PS.
Obtener resultados con marca de fecha por adquisición con:
sin nubes - fracción de su geometría que está libre de nubes, rango de valores de 0 a 1, donde 1 significa totalmente libre de nubes.
value - estadísticas para el índice seleccionado calculadas solo en píxeles libres de nubes, incluye min, max, avg, mdn, var, std.
Opcionalmente proporcione rangos matriz de rangos de valores del índice para calcular estadísticas de cobertura. Cuando se proporciona, la respuesta incluirá un rangos campo que muestra qué porcentaje del área cae dentro de cada rango especificado.
Área ocupada por cada color/rango - basado en el valor del índice (bajo => alto)
Porcentaje de cobertura - valor 0..1 por rango que representa el porcentaje de superficie
Índices compatibles
EVI2, NDVI, RVI, LAI, OSAVI, SAVI, GNDVI, IPVI, GCI, WDRVI, RCI, SBI, MCARI1. Las definiciones de los índices siguen el catálogo de índices de vegetación de GeoPard utilizado en toda la API.
Parámetros de entrada
Campo
Tipo
Requerido
Notas
index
Enum (ver arriba)
✅
Índice de vegetación a calcular.
proveedores
[Proveedor!]!
✅
Cualquiera de S2, L4, L5, L7, L8, L9, PS.
startDate
String (ISO8601)
✅
Inicio inclusivo, p. ej. "2025-05-10T00:00:00.000Z".
endDate
String (ISO8601)
✅
Fin exclusivo o fin inclusivo dependiendo del esquema; coincida con sus otras consultas GeoPard.
geojson
String
✅
Un GeoJSON en cadena de tipo Point / MultiPoint / Polygon / MultiPolygon (WGS84 [lon, lat]). Recuerde escapar las comillas dentro de la cadena.
rangos
[[Float!]!]
❌
Array de [min, max] pares de rangos de valores del índice para calcular estadísticas de cobertura
Orientación de rendimiento
Para geometrías Polygon/MultiPolygon, mantenga los rangos de fechas ajustados (~10–15 días) debido al tiempo de procesamiento.
Tiempo de espera: 30 s. Use menos días y/o menos proveedores si alcanza el límite.
Para Point/MultiPoint, los rangos más amplios suelen estar bien (los puntos son ligeros).
Estructura de la respuesta
Ejemplo 1: MultiPolygon con MCARI1 en S2/L8/L9 dentro de una ventana de 5 días
Solicitar
Respuesta
Ejemplo 2: MultiPoint con NDVI en S2/L8/L9 durante una ventana de 5 días
Solicitar
Respuesta
Ejemplo 3: MultiPolygon con NDVI en S2/L8/L9 con rangos dentro de una ventana de 5 días
graphqlCopiarEditar{
geojson # eco de su geometría de entrada (stringificada)
data: [
{
uuid # id de la escena ráster
provider # S2, L8, L9, ...
acquisitionDate # ISO8601
cloudfree # fracción 0..1 de área libre de nubes
value: {
index # p. ej., NDVI
min
max
avg
mdn
var
std
}
ranges: {
value
coverage
}
}
]
}
query GetSatelliteImageryDataByMultiPoint {
getSatelliteImageryDataByGeometry(
input: {
providers: [S2, L8, L9]
index: NDVI
startDate: "2025-05-10T00:00:00.000Z" # los puntos son ligeros; ventanas más grandes están bien; tiempo de espera 30s
endDate: "2025-05-15T00:00:00.000Z"
geojson: "{\"type\": \"MultiPoint\", \"coordinates\": [[8.088754, 50.216859],[8.092651, 50.216905],[ 8.090799, 50.217442]]}"
}
) {
geojson
data {
uuid
provider
acquisitionDate
sin nubes
value {
index
min
max
avg
mdn
var
std
}
}
}
}
