Arbeiten mit Farmaktivitäten und Aktivitätsdaten in Azure Data Manager for Agriculture
Benutzer können einen Auftrags zum Aufnehmen von Farmvorgängen erstellen, um zugeordnete Aktivitätsdaten von Farmaktivitäten aus einem bestimmten Datenanbieter in Ihre Azure Data Manager for Agriculture-Instanz abzurufen, die einer bestimmten Partei zugeordnet ist. Der Auftrag behandelt alle erforderlichen Authentifizierungsaktualisierungen und erkennt und synchronisiert standardmäßig alle Änderungen täglich. In einigen Fällen wird der Auftrag auch Farm- und Feldinformationen abrufen, die dem angegebenen Konto zugeordnet sind.
Hinweis
Vor dem Erstellen des Auftrags "Farmaktivitäten" ist es obligatorisch, den oAuth-Fluss erfolgreich in den OAuth-Datenanbieter für Farmaktivitäten zu integrieren.
FarmOperations-Auftrag erstellen
Erstellen Sie einen Auftrag für Farmvorgänge, um Farmaktivitätsdaten mit einer ID Ihrer Wahl aufzunehmen. Diese Auftrags-ID wird verwendet, um den Status des Auftrags mithilfe von GET Farm Operations-Auftrag zu überwachen.
API-Dokumentation:FarmOperations_CreateDataIngestionJob
Hinweis
shapeType und shapeResolution sind anbieterspezifische Attribute. Wenn sie nicht auf Ihren Anbieter anwendbar sind, legen Sie den Wert auf "None" fest.
Basierend auf der startYear bereitgestellten Liste operations ruft Azure Data Manager for Agriculture die Daten vom Startjahr bis zum aktuellen Datum ab.
Neben bestimmten Daten (Geometrie) gibt uns der Datenanbieter für Farmaktivitäten auch die DAT-Datei für die Aktivität, die für Ihre Farm oder Ihr Feld ausgeführt wurde. Die DAT-Datei, die Shape-Datei usw. enthalten eine Geometrie, die angibt, wo die Aktivität ausgeführt wurde.
Auftragsstatus und Details können abgerufen werden mit: FarmOperations_GetDataIngestionJobDetails
Suchen und Abrufen von Farmaktivitätendaten
Da die Daten nun in Azure Data Manager for Agriculture aufgenommen werden, können sie mit den folgenden Methoden abgefragt oder aufgelistet werden:
Methode 1: Durchsuchen von Farmaktivitätendaten mithilfe von Geometrie-Überschneiden
Um den hohen Grad an Änderung in Felddefinitionen zu berücksichtigen, unterstützt Azure Data Manager für Landwirtschaft eine Suche nach einem Überschneiden-Feature, mit dem Sie Daten nach Raum und Zeit über alle Parteien hinweg organisieren können, ohne zuerst die Farm-/Feldhierarchie oder -zuordnung kennen zu müssen. Wenn Sie über die partyId verfügen, können Sie sie in der Eingabe verwenden, und es gibt Ihnen die Liste der Farmaktivitätsdatenelemente für die angegebene Partei.
Sie können auch die ID verwenden, plantingId um die oben genannten Daten in derselben API abzurufen. Wenn Sie die ID entfernen, können Sie alle anderen Daten sehen, die sich mit derselben Geometrie überschneiden. Es zeigt also Daten für die gleiche Geometrie in verschiedenen Parteien an.
Methode 2: Listendaten nach Typ
Abgerufene Daten werden nach Aktivitätstyp unter der Partei sortiert. Diese können mit angewendeten Standardfiltern aufgelistet werden. Einzelne Datenelemente können abgerufen werden, um die Eigenschaften und Metadaten anzuzeigen, einschließlich des sourceActivityIdUnd providerFieldIdGeometry.
Anlagen auflisten und herunterladen
Das Nachrichtenattribut in der Antwort der FarmOperations_GetDataIngestionJobDetails API zeigt, wie viele Daten verarbeitet wurden und wie viele Anlagen erstellt wurden. Um die Anlagen zu überprüfen, die der PartyId zugeordnet sind, wechseln Sie zur Anlagen-API. Die Antwort gibt Ihnen alle Anlagen, die unter der partyId erstellt wurden.
API-Dokumentation: Anlagen
Nächste Schritte
- Hier erfahren Sie mehr über unsere APIs.