Ingérer des images satellites dans Azure Data Manager pour l’agriculture

L’imagerie satellite est un pilier fondamental des données agricoles. Pour prendre en charge l’ingestion évolutive d’images clippées géométriques, Microsoft a collaboré avec Sentinel Hub by Sinergise pour offrir une expérience BYOL (apportez votre propre licence) transparente pour Azure Data Manager for Agriculture. Vous pouvez utiliser cette expérience BYOL pour gérer vos propres coûts. Cette fonctionnalité vous aide à stocker l’historique clippé des champs et les images à jour dans le contexte lié des champs appropriés.

Conditions préalables

• Pour rechercher et ingérer des images, vous avez besoin d’un compte d’utilisateur disposant d’un droit d’abonnement approprié avec Sentinel Hub.
• Lisez les conditions d’utilisation et la politique de confidentialité du Hub Sinergise Sentinel.
• Ayez vos valeurs providerClientId et providerClientSecret prêtes.

Ingestion d’images découpées géométriquement

L’utilisation de données satellites dans Azure Data Manager pour l’agriculture implique les étapes suivantes :

Remarque

Microsoft Azure Data Manager for Agriculture est actuellement en préversion. Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités en version bêta, en préversion ou plus généralement pas encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.

Microsoft Azure Data Manager pour l’agriculture nécessite une inscription et n’est disponible que pour les clients et partenaires approuvés pendant la période de préversion. Pour demander l’accès à Microsoft Data Manager for Agriculture pendant la période de préversion, utilisez ce formulaire.

Visibilité et journalisation de la consommation

Étant donné que toutes les données ingérées sont sous un modèle BYOL, le coût d’un travail est transparent. Azure Data Manager pour l’agriculture offre une journalisation intégrée afin de fournir une transparence sur la consommation d’unités de traitement (PU) pour les appels vers le hub Sentinel partenaire en amont. L'information est affichée dans la SatelliteLogs catégorie de la journalisation standard d'Azure Data Manager.

Recherche STAC pour des images disponibles

Azure Data Manager for Agriculture prend en charge l’interface de recherche STAC (SpatioTemporal Asset Catalogs) standard pour retrouver des métadonnées dans les images de la collection Sentinel Hub avant d’initier le téléchargement de pixels. Pour ce faire, le point de terminaison de recherche accepte un emplacement sous la forme d’un point, d’un polygone ou d’un multipolygon, ainsi qu’une date/heure de début et de fin. Sinon, si vous disposez déjà de l’ID d’élément unique, vous pouvez le fournir en tant que tableau de jusqu’à cinq pour récupérer directement ces éléments spécifiques.

Important

Pour être cohérent avec la syntaxe STAC, l’ID de fonctionnalité est renommé en ID d’élément à partir de la version d’API 2023-11-01-preview.

Si vous fournissez un ID d’élément, tous les paramètres d’emplacement et d’heure de la demande sont ignorés.

Contrôle de code source à mosaïque unique

Les vignettes publiées chevauchent l’espace sur la terre pour garantir une couverture spatiale complète. Si la géométrie interrogée se trouve dans un espace où plusieurs vignettes correspondent pour une période raisonnable, le fournisseur mosaïque automatiquement l’image retournée avec des pixels sélectionnés à partir de la plage de vignettes candidates. Le fournisseur produit la meilleure image résultante.

Dans certains cas, l'utilisation de plusieurs tuiles n'est pas souhaitable, et la traçabilité vers une seule source de tuile est préférée. Pour prendre en charge ce contrôle de source strict, Azure Data Manager pour Agriculture prend en charge la spécification d’un ID d’élément unique dans la tâche d’ingestion.

Remarque

Cette fonctionnalité est disponible uniquement à partir de la version d’API 2023-11-01-preview.

Si la géométrie d’un ID d’élément fourni a une couverture partielle (par exemple, la géométrie s’étend sur plusieurs vignettes), les images retournées reflètent uniquement les pixels présents dans la vignette de l’élément spécifié et entraînent une image partielle.

Reprojection

Important

La fonctionnalité de reprojection a changé à partir de la version d’API 2023-11-01-preview, mais elle est immédiatement applicable à toutes les versions. Les versions antérieures utilisaient une conversion statique de 10 m * 10 m définie au niveau de l’équateur. L’imagerie ingérée avant cette version peut avoir une différence de taille par rapport à l’imagerie ingérée après cette version.

Azure Data Manager for Agriculture utilise WGS84 (EPSG : 4326), un système de coordonnées plat. Les images Sentinel-2 sont présentées dans UTM, un système de projection au sol qui se rapproche de celle de notre globe terrestre.

La traduction entre une image plate et une terre ronde implique une traduction d’approximation. La précision de cette traduction est définie sur une valeur égale à l’équateur (10 m^2) et augmente la marge d’erreur à mesure que le point en question s’éloigne de l’équateur aux pôles.

Pour assurer la cohérence, Azure Data Manager pour l’agriculture utilise la formule suivante à 10 m^2 de base pour tous les appels Sentinel-2 :

$$ Latitude = \frac{10 m}{111320} $$

$$ Longitude = \frac{10 m}{\frac{111320}{cos(lat)}} $$

$$ \ Où\ lat = latitude\ du\ centroïde\ de\ la\ géométrie\ fournie $$

Mise en cache

Important

La fonctionnalité de mise en cache est disponible uniquement à partir de la version d’API 2023-11-01-preview. La mise en cache des éléments s’applique uniquement à la récupération basée sur l’ID d’élément. Pour une recherche de géométrie et d’heure classique, les éléments retournés ne sont pas mis en cache.

Azure Data Manager pour agriculture optimise les performances et le coût des appels hautement répétés au même élément. Il met en cache les éléments STAC récents récupérés par ID d’élément pendant cinq jours dans l’instance du client et active la récupération locale.

Pour le premier appel au point de terminaison de recherche, Azure Data Manager pour l'Agriculture gère la requête et déclenche une demande au fournisseur en amont pour récupérer les éléments de données correspondants ou intersectants. La demande entraîne des frais de fournisseur.

Toute recherche suivante s'oriente d'abord vers le cache pour un résultat correspondant. S’il existe une correspondance, les données sont servies directement à partir du cache. Ce processus n’entraîne pas d’appel au fournisseur en amont, de sorte qu’il n’entraîne pas davantage de frais de fournisseur. S’il n’y a aucune correspondance ou si la période de rétention de cinq jours s’écoule, une nouvelle requête pour les données est transmise au fournisseur en amont. Cet appel est traité comme un autre premier appel, de sorte que les résultats sont mis en cache.

Si un travail d’ingestion concerne une géométrie identique, référencée par le même ID de ressource et avec un temps qui se chevauche sur une scène déjà récupérée, Azure Data Manager pour Agriculture utilise l’image stockée localement. L’image n’est pas téléchargée à nouveau à partir du fournisseur en amont. Il n’y a pas d’expiration pour cette mise en cache au niveau des pixels.

Sources satellites prises en charge par Azure Data Manager pour l’agriculture

Bien qu’Azure Data Manager pour l’agriculture soit en préversion, il prend en charge l’ingestion de données à partir de la constellation Sentinel-2.

Sentinel-2

Sentinel-2 est une constellation satellite que l’Agence spatiale européenne (ESA) a lancée sous la mission Copernicus. Cette constellation a une paire de satellites et porte une charge utile d’instrument multispectral (MSI) qui échantillonne 13 bandes spatiales : quatre bandes à 10 m, six bandes à 20 m et trois bandes à résolution spatiale de 60 m.

Sentinel-2 a deux produits :

• Données de niveau 1 pour la partie supérieure de l’atmosphère.
• Données de niveau 2 pour le bas de l’atmosphère. Cette variante bénéficie de corrections atmosphériques.

Azure Data Manager pour l’agriculture prend en charge l’ingestion et la récupération de données Sentinel_2_L2A et Sentinel_2_L1C à partir de Sentinel 2.

Noms et résolutions d’images

Les API que vous utilisez pour ingérer et lire des données satellites (pour Sentinel-2) dans Azure Data Manager pour Agriculture prennent en charge les noms et résolutions d’images suivants :

Catégorie	Nom de l’image	Descriptif	Résolution native
Bandes brutes	B01	Aérosol côtier	60 m
Bandes brutes	B02	Bleu	10 m
Bandes brutes	B03	Vert	10 m
Bandes brutes	B04	Rouge	10 m
Bandes brutes	B05	Bord rouge de la végétation	20 m
Bandes brutes	B06	Bord rouge de la végétation	20 m
Bandes brutes	B07	Bord rouge de la végétation	20 m
Bandes brutes	B08	Infrarouge proche (NIR)	10 m
Bandes brutes	B8A	NIR étroit	20 m
Bandes brutes	B09	Vapeur	60 m
Bandes brutes	B11	Infrarouge à onde courte (SWIR)	20 m
Bandes brutes	B12	SWIR	20 m
Sortie du processeur Sen2Cor	AOT	Carte de l’épaisseur optique de l’aérosol	10 m
Sortie du processeur Sen2Cor	SCL	Données de classification des scènes	20 m
Sortie du processeur Sen2Cor	SNW	Probabilité de neige	20 m
Sortie du processeur Sen2Cor	CLD	Probabilité de nuage	20 m
Index dérivés	NDVI	Indice de végétation à différence normalisée	10 m/20 m/60 m (défini par l’utilisateur)
Index dérivés	NDWI	Indice de différence normalisé de l'eau	10 m/20 m/60 m (défini par l’utilisateur)
Index dérivés	EVI	Indice de végétation amélioré	10 m/20 m/60 m (défini par l’utilisateur)
Index dérivés	LAI	Indice de surface foliaire	10 m/20 m/60 m (défini par l’utilisateur)
Index dérivés	LAIMask	Masque d’indice de surface foliaire	10 m/20 m/60 m (défini par l’utilisateur)
CLP	Probabilité de nuage basée sur s2cloudless	Les valeurs vont de 0 (pas de clouds) à 255 (clouds).	10 m/20 m/60 m (défini par l’utilisateur)
CLM	Masques de nuages basés sur s2cloudless	Valeur de 1 représente les clouds, 0 ne représente aucun cloud et 255 ne représente aucune donnée.	10 m/20 m/60 m (défini par l’utilisateur)
dataMask	Masque binaire pour indiquer la disponibilité des données	La valeur de 0 représente l’indisponibilité des données ou des pixels se trouvant en dehors de la zone d’intérêt.	Non applicable, par valeur de pixel

Points à noter

Azure Data Manager for Agriculture utilise CRS EPSG : 4326 pour les données Sentinel-2. Les résolutions citées dans les API sont au niveau de l’équateur.

Pour l'aperçu :

• Un maximum de cinq travaux satellites peuvent s’exécuter simultanément, par locataire.
• Un travail satellite peut ingérer des données pendant un maximum d’un an dans un seul appel d’API.
• Seuls les TIF sont pris en charge.
• Seules les images de 10 m, 20 m et 60 m sont prises en charge.

Étapes suivantes

• Tester les API REST Azure Data Manager pour l’agriculture