90. Query: Obter Dados de Imagens de Satélite por Geometria
Buscar estatísticas de índice de vegetação para qualquer geometria ad-hoc - não é necessário limite de campo registrado. Este endpoint calcula estatísticas resumidas para pixels dentro da sua geometria enquanto ignorando pixels com nuvens. Atualmente suportado em Sentinel2 (S2) , Landsat (L4/L5/L7/L8/L9) e Planet (PS) provedores.
Esta página segue os padrões de API do GeoPard e autenticação usados em todos os endpoints GraphQL.
O que você pode fazer
Consultar índices de vegetação para geometrias Point, MultiPoint, Polygon e MultiPolygon. geometrias.
Escolher provedores de imagens: S2, L4, L5, L7, L8, L9, PS.
Obter com carimbo de data resultados por aquisição com:
livre de nuvens - fração da sua geometria que está livre de nuvens, intervalo de valores de 0 a 1, onde 1 significa totalmente livre de nuvens.
value - estatísticas para o índice selecionado calculadas apenas em pixels livres de nuvens, inclui min, max, avg, mdn, var, std.
Opcionalmente forneça intervalos array de faixas de valores do índice para calcular estatísticas de cobertura. Quando fornecido, a resposta incluirá um intervalos campo mostrando qual porcentagem da área se enquadra em cada faixa especificada.
Área ocupada por cada cor/faixa - baseado no valor do índice (baixo => alto)
Porcentagem de cobertura - valor 0..1 por faixa representando porcentagem da superfície
Índices suportados
EVI2, NDVI, RVI, LAI, OSAVI, SAVI, GNDVI, IPVI, GCI, WDRVI, RCI, SBI, MCARI1. Definições de índice seguem o catálogo de índices de vegetação do GeoPard usado em toda a API.
Parâmetros de entrada
Campo
Tipo
Obrigatório
Observações
index
Enum (ver acima)
✅
Índice de vegetação a ser calculado.
imagens
[Provider!]!
✅
Qualquer um de S2, L4, L5, L7, L8, L9, PS.
startDate
String (ISO8601)
✅
Início inclusivo, por exemplo "2025-05-10T00:00:00.000Z".
endDate
String (ISO8601)
✅
Fim exclusivo ou fim inclusivo dependendo do esquema; combine com suas outras consultas GeoPard.
geojson
String
✅
Um GeoJSON em forma de string do tipo Point / MultiPoint / Polygon / MultiPolygon (WGS84 [lon, lat]). Lembre-se de escapar as aspas dentro da string.
intervalos
[[Float!]!]
❌
Array de [min, max] pares de faixas de valores do índice para calcular estatísticas de cobertura
Orientações de desempenho
Para geometrias Polygon/MultiPolygon, mantenha intervalos de datas curtos (~10–15 dias) devido ao tempo de processamento.
Tempo limite: 30 s. Use menos dias e/ou menos provedores se atingir o limite.
Para Point/MultiPoint, intervalos maiores geralmente são aceitáveis (pontos são leves).
Formato da resposta
Exemplo 1: MultiPolygon com MCARI1 em S2/L8/L9 dentro de uma janela de 5 dias
Solicitar
Resposta
Exemplo 2: MultiPoint com NDVI em S2/L8/L9 ao longo de uma janela de 5 dias
Solicitar
Resposta
Exemplo 3: MultiPolygon com NDVI em S2/L8/L9 com faixas dentro de uma janela de 5 dias
graphqlCopiarEditar{
geojson # eco da sua geometria de entrada (em forma de string)
data: [
{
uuid # id da cena raster
provider # S2, L8, L9, ...
acquisitionDate # ISO8601
cloudfree # fração 0..1 de área livre de nuvens
value: {
index # ex.: NDVI
min
max
avg
mdn
var
std
}
ranges: {
value
coverage
}
}
]
}
