90. Query : obtenir les données d'imagerie satellite par géométrie
Récupérer des statistiques d'indices de végétation pour n'importe quelle géométrie ad hoc - aucune limite de parcelle enregistrée requise. Ce point de terminaison calcule des statistiques résumées pour les pixels à l'intérieur de votre géométrie tout en ignorant les pixels nuageux. Actuellement pris en charge sur Sentinel2 (S2) , Landsat (L4/L5/L7/L8/L9) et Planet (PS) fournisseurs.
Cette page suit les modèles d'API de GeoPard et authentification utilisés dans les points de terminaison GraphQL.
Ce que vous pouvez faire
Interroger indices de végétation pour géométries Point, MultiPoint, Polygon et MultiPolygon. géométries.
Choisir les images fournisseurs: S2, L4, L5, L7, L8, L9, PS.
Obtenir horodatés résultats par acquisition avec :
sans nuages - fraction de votre géométrie qui est exempte de nuages, plage de valeurs de 0 à 1, où 1 signifie complètement sans nuages.
value - statistiques pour l'indice sélectionné calculées uniquement sur les pixels sans nuages, inclut min, max, avg, mdn, var, std.
Fournir en option plages tableau de plages de valeurs d'indice pour calculer les statistiques de couverture. Lorsqu'il est fourni, la réponse inclura un plages champ indiquant quel pourcentage de la surface se situe dans chaque plage spécifiée.
Surface occupée par chaque couleur/plage - basée sur la valeur de l'indice (faible => élevé)
Pourcentage de couverture - valeur 0..1 par plage représentant le pourcentage de surface
Indices pris en charge
EVI2, NDVI, RVI, LAI, OSAVI, SAVI, GNDVI, IPVI, GCI, WDRVI, RCI, SBI, MCARI1. Les définitions des indices suivent le catalogue d'indices de végétation de GeoPard utilisé dans toute l'API.
Paramètres d'entrée
Champ
Type
Requis
Remarques
index
Enum (voir ci-dessus)
✅
Indice de végétation à calculer.
fournisseurs
[Provider!]!
✅
N'importe lequel de S2, L4, L5, L7, L8, L9, PS.
startDate
Chaîne (ISO8601)
✅
Début inclusif, par ex. "2025-05-10T00:00:00.000Z".
endDate
Chaîne (ISO8601)
✅
Fin exclusive ou fin inclusive selon le schéma ; faites correspondre vos autres requêtes GeoPard.
geojson
Chaîne
✅
Un GeoJSON mis sous forme de chaîne de type Point / MultiPoint / Polygon / MultiPolygon (WGS84 [lon, lat]). N'oubliez pas d'échapper les guillemets à l'intérieur de la chaîne.
plages
[[Float!]!]
❌
Tableau de [min, max] paires de plages de valeurs d'indice pour calculer les statistiques de couverture
Conseils de performance
Pour les géométries Polygon/MultiPolygon, gardez les plages de dates courtes (~10–15 jours) en raison du temps de traitement.
Timeout : 30 s. Utilisez moins de jours et/ou moins de fournisseurs si vous atteignez la limite.
Pour Point/MultiPoint, des plages plus grandes conviennent généralement (les points sont peu gourmands).
Forme de la réponse
Exemple 1 : MultiPolygon avec MCARI1 sur S2/L8/L9 dans une fenêtre de 5 jours
Demander
Réponse
Exemple 2 : MultiPoint avec NDVI sur S2/L8/L9 sur une fenêtre de 5 jours
Demander
Réponse
Exemple 3 : MultiPolygon avec NDVI sur S2/L8/L9 avec plages dans une fenêtre de 5 jours
graphqlCopierÉditer{
geojson # echo de votre géométrie d'entrée (mise en chaîne)
data: [
{
uuid # identifiant de la scène raster
provider # S2, L8, L9, ...
acquisitionDate # ISO8601
cloudfree # fraction 0..1 de la zone exempte de nuages
value: {
index # ex., 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" # les points sont peu gourmands ; des fenêtres plus larges conviennent ; timeout 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
sans nuages
value {
index
min
max
avg
mdn
var
std
}
}
}
}
