Utilisation des activités de batterie de serveurs et des données d’activité dans Azure Data Manager pour l’agriculture
Les utilisateurs peuvent créer un travail d’ingestion de données d’opération de batterie de serveurs pour extraire les données d’activité d’activités de batterie de serveurs associées à partir d’un fournisseur de données spécifié dans votre instance Azure Data Manager for Agriculture, associée à une partie spécifique. Le travail gère toutes les actualisations d’authentification requises, et détecte et synchronise par défaut toutes les modifications quotidiennes. Dans certains cas, le travail extrait également la batterie de serveurs et les informations de champ associées au compte donné dans la partie.
Remarque
Avant de créer un travail d’activités de batterie de serveurs, il est obligatoire de s’intégrer correctement au flux oAuth du fournisseur de données Farm Activities
Créer un travail FarmOperations
Créez un travail d’exploitation de batterie de serveurs pour ingérer des données d’activité de batterie avec un ID de votre choix. Cet ID de travail est utilisé pour surveiller l’état du travail à l’aide du travail GET Farm Operations.
Documentation de l’API :FarmOperations_CreateDataIngestionJob
Remarque
shapeType et shapeResolution sont des attributs spécifiques au fournisseur. S’ils ne sont pas applicables à votre fournisseur, définissez la valeur sur « Aucun ».
En fonction de la startYear liste fournie operations , Azure Data Manager for Agriculture récupère les données de l’année de début à la date actuelle.
En plus des données spécifiques (géométrie), le fournisseur de données Farm Activities nous donne également le fichier DAT pour l’activité effectuée sur votre batterie de serveurs ou votre champ. Le fichier DAT, le fichier de forme, etc. contiennent une géométrie qui reflète l’endroit où l’activité a été effectuée.
L’état et les détails du travail peuvent être récupérés avec : FarmOperations_GetDataIngestionJobDetails
Recherche et récupération des données d’activités de batterie de serveurs
Maintenant que les données sont ingérées dans Azure Data Manager pour l’agriculture, elles peuvent être interrogées ou répertoriées avec les méthodes suivantes :
Méthode 1 : rechercher des données d’activités de batterie à l’aide d’une intersection géométrique
Pour tenir compte du degré élevé de changement trouvé dans les définitions de champs, Azure Data Manager pour l’agriculture prend en charge une recherche en fonction de l’intersection qui vous permet d’organiser les données par espace et temps entre les parties, sans avoir à connaître d’abord la hiérarchie ou l’association de la batterie de serveurs/champs. Si vous avez le partyId, vous pouvez l’utiliser dans l’entrée et vous donne la liste des éléments de données d’activité de batterie de serveurs pour la partie spécifiée.
Vous pouvez également utiliser l’ID comme plantingId pour extraire les données ci-dessus dans la même API. Si vous supprimez l’ID, vous pouvez voir toutes les autres données qui se croisent avec la même géométrie entre les parties. Il affiche donc des données pour la même géométrie entre différentes parties.
Méthode 2 : Répertorier les données par type
Les données récupérées sont triées par type d’activité sous la partie. Ceux-ci peuvent être répertoriés, avec des filtres standard appliqués. Les éléments de données individuels peuvent être récupérés pour afficher les propriétés et les métadonnées, y compris le sourceActivityId, providerFieldId et Geometry.
Répertorier et télécharger des pièces jointes
L’attribut de message dans la réponse de l’API indique la quantité de FarmOperations_GetDataIngestionJobDetails données traitées et le nombre de pièces jointes créées. Pour case activée les pièces jointes associées à partyId, accédez à l’API de pièce jointe. La réponse vous donne toutes les pièces jointes créées sous le partyId.
Documentation de l’API : Pièces jointes
Étapes suivantes
- Découvrez nos API ici.