# 16. Query: YieldDatasets ophalen

## Overzicht

Haal alle YieldDatasets op voor het geselecteerde perceel.&#x20;

YieldDatasets kunnen worden opgehaald met generieke GraphQL-query's:

1. `getFarms` met de volledige hiërarchie Boerderij > Perceel > YieldDataset met bijbehorende filters
2. &#x20;`getFields` van het gekoppelde perceel en de hiërarchie Perceel > YieldDataset
3. getYieldDatasets met een breed scala aan filters en paginering

{% hint style="warning" %}
Een "YieldDataset" moet vooraf worden geüpload.
{% endhint %}

## Yield Dataset-entiteit

YieldDataset bevat veel attributen. GraphQL laat je alleen de benodigde velden ophalen, waardoor de grootte van verzoeken en antwoorden aanzienlijk wordt verkleind. Gedetailleerde uitleg voor elk attribuut wordt hieronder inline gegeven.

{% hint style="info" %}
Attributen in de "YieldDataset" hieronder gemarkeerd als *afkomstig uit metainformatie* zijn optioneel. Ze worden afgeleid van de metainformatie van de dataset, die niet per definitie in elke YieldDataset aanwezig is.
{% endhint %}

{% hint style="success" %}
Details over het `geoMaps`  attribuut voor de YieldDataset zijn beschikbaar [hier](/geopard-tutorials/nl/api-docs/geo-eindpunten-voor-toegang-tot-ruimtelijke-gegevens/wms-rasterafbeeldingen-van-ruimtelijke-gegevenslagen-ophalen/12.-yielddatasetsmap.md).
{% endhint %}

{% hint style="success" %}
Details over hoe je Clean en Calibration voor de YieldDataset activeert zijn beschikbaar [hier](/geopard-tutorials/nl/api-docs/overzicht-van-api-verzoeken-van-geopard/84.-mutation-yielddataset-kalibreren-en-opschonen.md).
{% endhint %}

```graphql
{
  uuid
  naam #patroon "<OperationType> <YYYY-mm-DD>" Grondbewerking
  number #totaal aantal geofeatures
  geometryType #Polygonen of Punten
  totalCoveredArea(unit: HECTARES) #totale oppervlakte van alle geometrieën (relevant voor Polygonen)
  fieldCoverage #percentage van het perceel dat door de dataset wordt gedekt
  fieldCoveredArea(unit: HECTARES) #unie van geometrieën (zonder duplicaten)

  attributen
  fullAttributes { #volledige details per attribuut
    name #koppeling naar statistieken >> attribuut
    transliteratedName
    fullName #correct leesbare naam
    unit#meeteenheden
  }

  usedMachines { #gebruikte machines, afkomstig uit de metainformatie
    id
    serienummer
    operatorId
  } 

  createdDate #entiteit aanmaakdatum en -tijd in GeoPard
  updatedDate #laatste update datum en -tijd
  operationId
  operationType
  operationFileDate #bestandsaanmaakdatum-tijd komt uit de metainformatie 
  operationStartDate #start van de operatie komt uit de metainformatie
  
  statistics { #statistieke verdeling voor elk attribuut
    attribute
    min
    max
    avg
    mdn
    var
    std
    sum
  }
  
  cropName #gewassnaam komt uit de metainformatie
  cropToken #gewas-token (in hoofdletters) komt uit de metainformatie

  appliedCorrections #lijst van toegepaste correcties in de genoemde volgorde
  appliedCorrectionsVersion #versie van het gebruikte correctie-algoritme

  geoMaps {
    url
    shortName #prefix-opties: raw, thumbnail_raw, processed, thumbnail_processed
    hexColorCodes
    classes
  } 
}
```

## 1. Query getFarms

### Aanvragen

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

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

{% endcode %}

### Respons

```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. Query getFields

### Aanvragen

{% 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
        naam
        nummer
        geometryType
        totalCoveredArea(unit: HECTARES)
        fieldCoverage
        fieldCoveredArea(unit: HECTARES)
      }
    }
  }
}
```

{% endcode %}

### Respons

```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. Query getYieldDatasets

### Vraag de eerste pagina op

```graphql
query GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            paginaGrootte: 2
        }
    ) {
        yieldDatasets {
            uuid
            naam
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            nummer
        }
        laatstBeoordeeldSleutel {
            PartitieSleutel
            SorteerSleutel
            TagString
        }
    }
}
```

### Antwoord van de eerste pagina

```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
      }
    }
  }
}
```

### Vraag de volgende pagina op

Pagineringparameters worden doorgegeven via `laatstBeoordeeldSleutel`, waarbij de in het antwoord van de eerste pagina hierboven geretourneerde waarde wordt gebruikt.

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

### Antwoord van de volgende pagina

```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/nl/api-docs/overzicht-van-api-verzoeken-van-geopard/16.-query-yielddatasets-ophalen.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.
