# 16. Query: YieldDatasets abrufen

## Übersicht

Holen Sie alle Ertragsdatensätze (YieldDatasets) für das ausgewählte Feld. 

YieldDatasets können mit generischen GraphQL-Abfragen abgerufen werden:

1. `getFarms` unter Verwendung der vollständigen Hierarchie Betrieb (Farm) > Feld > YieldDataset mit seinen Filtern
2.  `getFields` vom verknüpften Feld und der Hierarchie Feld > YieldDataset
3. getYieldDatasets mit einer großen Auswahl an Filtern und Paginierung

{% hint style="warning" %}
Ein "YieldDataset" muss im Vorfeld hochgeladen worden sein.
{% endhint %}

## Entität Ertragsdatensatz (Yield Dataset)

YieldDataset enthält viele Attribute. GraphQL ermöglicht es, nur die benötigten Felder abzurufen, was die Größe von Anfrage und Antwort deutlich reduziert. Detaillierte Erklärungen zu jedem Attribut sind weiter unten inline angegeben.

{% hint style="info" %}
Attribute im "YieldDataset" unten gekennzeichnet als *stammen aus Metainformationen* sind optional. Sie werden aus den Metainformationen des Datensatzes abgeleitet, die nicht zwingend in jedem YieldDataset vorhanden sind.
{% endhint %}

{% hint style="success" %}
Details zum `geoMaps`  Attribut für das YieldDataset sind verfügbar [hier](/geopard-tutorials/de/api-dokumentation/geo-endpunkte-fur-den-zugriff-auf-raumliche-daten/wms-rasterbilder-von-raumlichen-datenebenen-abrufen/12.-yielddatasetsmap.md).
{% endhint %}

{% hint style="success" %}
Details dazu, wie Clean und Calibration für das YieldDataset ausgelöst werden, sind verfügbar [hier](/geopard-tutorials/de/api-dokumentation/uberblick-uber-geopard-api-anfragen/84.-mutation-yielddataset-kalibrieren-und-bereinigen.md).
{% endhint %}

```graphql
{
  uuid
  name #Muster "<OperationType> <YYYY-mm-DD>" Bodenbearbeitung (Tillage)
  number #Gesamtanzahl der Geofeatures
  geometryType #Polygone oder Punkte
  totalCoveredArea(unit: HECTARES) #Gesamtfläche aller Geometrien (relevant für Polygone)
  fieldCoverage #Prozent des Feldes, das vom Datensatz abgedeckt wird
  fieldCoveredArea(unit: HECTARES) #Vereinigung der Geometrien (ohne Duplikate)

  attributes
  fullAttributes { #vollständige Details pro Attribut
    name #Verweis auf Statistik >> Attribut
    transliteratedName
    fullName #korrekter, für Menschen lesbarer Name
    unit#Maßeinheiten
  }

  usedMachines { #verwendete Maschinen, die aus den Metainformationen stammen
    id
    serial
    operatorId
  } 

  createdDate #Entität-Erstellungsdatum/-uhrzeit in GeoPard
  updatedDate #Datum/Uhrzeit der letzten Aktualisierung
  operationId
  operationType
  operationFileDate #DateTime der Dateierstellung stammt aus den Metainformationen 
  operationStartDate #Beginn der Tätigkeit stammt aus den Metainformationen
  
  statistics { #Statistikverteilung für jedes Attribut
    attribute
    min
    max
    avg
    mdn
    var
    std
    sum
  }
  
  cropName #Kulturname stammt aus den Metainformationen
  cropToken #Kultur-Token (in GROSSBUCHSTABEN) stammt aus den Metainformationen

  appliedCorrections #Liste der angewendeten Korrekturen in der genannten Reihenfolge
  appliedCorrectionsVersion #Version des verwendeten Korrekturalgorithmus

  geoMaps {
    url
    shortName #Präfixoptionen: raw, thumbnail_raw, processed, thumbnail_processed
    hexColorCodes
    classes
  } 
}
```

## 1. Abfrage getFarms

### Anfordern

{% code overflow="wrap" lineNumbers="true" %}

```graphql
query GetYieldDatasetsViaGetFarms {
  getFarms (farmUuids: ["9eecef55-f74f-4099-991a-05cbd976d50a"]) {
    uuid
    name
    fields (fieldUuids: ["a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"]) {
      uuid
      yieldDatasets {
        uuid
        name
        nummer
        geometryType
        totalCoveredArea(unit: HECTARES)
        fieldCoverage
        fieldCoveredArea(unit: HECTARES)
      }
    }
  }
}
```

{% endcode %}

### Antwort

```json
{
  "data": {
    "getFarms": [
      {
        "uuid": "9eecef55-f74f-4099-991a-05cbd976d50a",
        "name": "TEST VECTOR DATA",
        "fields": [
          {
            "uuid": "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
            "yieldDatasets": [
              {
                "uuid": "08f0fee4-daf4-4a98-97e5-660b7b6cfbeb",
                "name": "CALIBRATE-CLEAN-YieldCORN2017",
                "number": 14657,
                "geometryType": "POINTS",
                "totalCoveredArea": -1.0,
                "fieldCoverage": 0.97578,
                "fieldCoveredArea": 21.024173
              },
              {
                "uuid": "2b4fbd15-c961-49c8-8cc2-3031397d0380",
                "name": "CALIBRATE-YieldCORN2017",
                "number": 16200,
                "geometryType": "POINTS",
                "totalCoveredArea": -1.0,
                "fieldCoverage": 0.98791,
                "fieldCoveredArea": 21.285677
              },
              {
                "uuid": "465769d3-14dd-419f-9740-fb230c0505fd",
                "name": "YieldSbean2018_reupload",
                "number": 9073,
                "geometryType": "POINTS",
                "totalCoveredArea": -1.0,
                "fieldCoverage": 0.92874,
                "fieldCoveredArea": 20.0107663
              },
              {
                "uuid": "73d247ad-c45b-47a5-b94d-a2eb502857fe",
                "name": "CLEAN-YieldCORN2017 before build",
                "number": 14709,
                "geometryType": "POINTS",
                "totalCoveredArea": -1.0,
                "fieldCoverage": 0.98305,
                "fieldCoveredArea": 21.1808419
              },
              {
                "uuid": "74f06214-1051-47a2-a560-696d9290245a",
                "name": "YieldSbean2018",
                "number": 10179,
                "geometryType": "POINTS",
                "totalCoveredArea": -1.0,
                "fieldCoverage": 0.92874,
                "fieldCoveredArea": 20.0107663
              },
              {
                "uuid": "7e2bc706-2da4-43ae-beaa-240300d20c53",
                "name": "YieldSbean2015",
                "number": 10293,
                "geometryType": "POINTS",
                "totalCoveredArea": -1.0,
                "fieldCoverage": 0.96217,
                "fieldCoveredArea": 20.730980600000002
              },
              {
                "uuid": "7fb9fb1f-c4df-4146-892c-ba672dab9cd7",
                "name": "CALIBRATE-CLEAN-YieldSbean2018",
                "number": 9026,
                "geometryType": "POINTS",
                "totalCoveredArea": -1.0,
                "fieldCoverage": 0.92426,
                "fieldCoveredArea": 19.914270300000002
              },
              {
                "uuid": "8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8",
                "name": "CLEAN-YieldCORN2017 after build",
                "number": 14709,
                "geometryType": "POINTS",
                "totalCoveredArea": -1.0,
                "fieldCoverage": 0.98305,
                "fieldCoveredArea": 21.1808419
              },
              {
                "uuid": "a7f9d7cc-e1e1-46ff-b13d-468518749ba9",
                "name": "CALIBRATE-YieldSbean2015",
                "number": 9310,
                "geometryType": "POINTS",
                "totalCoveredArea": -1.0,
                "fieldCoverage": 0.95482,
                "fieldCoveredArea": 20.5726658
              },
              {
                "uuid": "cbd0c66b-21e3-4997-96a7-f1179da18c36",
                "name": "CLEAN-CALIBRATE-YieldSbean2015",
                "number": 9183,
                "geometryType": "POINTS",
                "totalCoveredArea": -1.0,
                "fieldCoverage": 0.90674,
                "fieldCoveredArea": 19.5366444
              },
              {
                "uuid": "fdfd701f-6529-4f4e-8027-e831fb557fe2",
                "name": "YieldCORN2017",
                "number": 16334,
                "geometryType": "POINTS",
                "totalCoveredArea": -1.0,
                "fieldCoverage": 0.97947,
                "fieldCoveredArea": 21.103661199999998
              }
            ]
          }
        ]
      }
    ]
  }
}
```

## 2. Abfrage getFields

### Anfordern

{% code overflow="wrap" lineNumbers="true" %}

```graphql
query GetYieldDatasetsViaGetFields {
  getFields (filter: {fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"}) {
    fields {
      uuid
      area(unit: HECTARES)
      yieldDatasets(yieldDatasetUuids: ["8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8"]) {
        uuid
        name
        nummer
        geometryType
        totalCoveredArea(unit: HECTARES)
        fieldCoverage
        fieldCoveredArea(unit: HECTARES)
      }
    }
  }
}
```

{% endcode %}

### Antwort

```json
{
  "data": {
    "getFields": {
      "fields": [
        {
          "uuid": "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
          "area": 21.541909393943847,
          "yieldDatasets": [
            {
              "uuid": "8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8",
              "name": "CLEAN-YieldCORN2017 after build",
              "number": 14709,
              "geometryType": "POINTS",
              "totalCoveredArea": -1.0,
              "fieldCoverage": 0.98305,
              "fieldCoveredArea": 21.1808419
            }
          ]
        }
      ]
    }
  }
}
```

## 3. Abfrage getYieldDatasets

### Fordern Sie die erste Seite an

```graphql
query GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            pageSize: 2
        }
    ) {
        yieldDatasets {
            uuid
            name
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            nummer
        }
        lastEvaluatedKey {
            PartitionKey
            SortKey
            TagString
        }
    }
}
```

### Antwort der ersten Seite

```json
{
  "data": {
    "getYieldDatasets": {
      "yieldDatasets": [
        {
          "uuid": "08f0fee4-daf4-4a98-97e5-660b7b6cfbeb",
          "name": "CALIBRATE-CLEAN-YieldCORN2017",
          "fieldCoverage": 0.97578,
          "fieldCoveredArea": 21.024173,
          "number": 14657
        },
        {
          "uuid": "2b4fbd15-c961-49c8-8cc2-3031397d0380",
          "name": "CALIBRATE-YieldCORN2017",
          "fieldCoverage": 0.98791,
          "fieldCoveredArea": 21.285677,
          "number": 16200
        }
      ],
      "lastEvaluatedKey": {
        "PartitionKey": "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
        "SortKey": "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380",
        "TagString": null
      }
    }
  }
}
```

### Fordern Sie die folgende Seite an

Paginierungsparameter werden übergeben via `lastEvaluatedKey`, unter Verwendung des in der Antwort der ersten Seite oben zurückgegebenen Wertes.

```graphql
query GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            pageSize: 2
            lastEvaluatedKey: {
                PartitionKey: "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
                SortKey: "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380",
                TagString: null
            }
        }
    ) {
        yieldDatasets {
            uuid
            name
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            nummer
        }
        lastEvaluatedKey {
            PartitionKey
            SortKey
            TagString
        }
    }
}
```

### Antwort der folgenden Seite

```json
{
  "data": {
    "getYieldDatasets": {
      "yieldDatasets": [
        {
          "uuid": "465769d3-14dd-419f-9740-fb230c0505fd",
          "name": "YieldSbean2018_reupload",
          "fieldCoverage": 0.92874,
          "fieldCoveredArea": 20.0107663,
          "number": 9073
        },
        {
          "uuid": "73d247ad-c45b-47a5-b94d-a2eb502857fe",
          "name": "CLEAN-YieldCORN2017 before build",
          "fieldCoverage": 0.98305,
          "fieldCoveredArea": 21.1808419,
          "number": 14709
        }
      ],
      "lastEvaluatedKey": {
        "PartitionKey": "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
        "SortKey": "YVDATA-73d247ad-c45b-47a5-b94d-a2eb502857fe",
        "TagString": null
      }
    }
  }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.geopard.tech/geopard-tutorials/de/api-dokumentation/uberblick-uber-geopard-api-anfragen/16.-query-yielddatasets-abrufen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.