# 16. Forespørgsel: Hent YieldDatasets

## Oversigt

Hent alle YieldDatasets for den valgte mark.&#x20;

YieldDatasets kan hentes ved hjælp af generiske GraphQL-forespørgsler:

1. `getFarms` ved at bruge den komplette hierarki Gård > Mark > YieldDataset med dets filtre
2. &#x20;`getFields` fra den tilknyttede mark og hierarkiet Mark > YieldDataset
3. getYieldDatasets med et bredt udvalg af filtre og paginering

{% hint style="warning" %}
Et "YieldDataset" skal være uploadet på forhånd.
{% endhint %}

## Yield Dataset-enhed

YieldDataset indeholder mange attributter. GraphQL giver dig mulighed for kun at hente de nødvendige felter, hvilket reducerer størrelsen af forespørgslen og svaret betydeligt. Detaljerede forklaringer for hver attribut er angivet nedenfor.

{% hint style="info" %}
Attributter i "YieldDataset" markeret nedenfor som *kommer fra metainformation* er valgfrie. De er afledt af datasættets metainformation, som ikke nødvendigvis findes i hvert YieldDataset.
{% endhint %}

{% hint style="success" %}
Detaljer om `geoMaps`  attributten for YieldDataset er tilgængelige [her](/geopard-tutorials/dnk/api-dokumentation/geo-endepunkter-til-adgang-til-spatial-data/wms-hent-rasterbilleder-af-spatiale-datalag/12.-yielddatasetsmap.md).
{% endhint %}

{% hint style="success" %}
Detaljer om hvordan man udløser Rensning og Kalibrering for YieldDataset er tilgængelige [her](/geopard-tutorials/dnk/api-dokumentation/oversigt-over-geopard-api-anmodninger/84.-mutation-kalibrer-og-rens-yielddataset.md).
{% endhint %}

```graphql
{
  uuid
  navn #mønster "<OperationType> <YYYY-mm-DD>" Jordbearbejdning
  number #samlet antal geofunktioner
  geometryType #Polygoner eller Punkter
  totalCoveredArea(unit: HECTARES) #total areal af alle geometrier (relevant for Polygoner)
  fieldCoverage #procent af marken dækket af datasættet
  fieldCoveredArea(unit: HECTARES) #union af geometrier (uden dubletter)

  attributes
  fullAttributes { #komplette detaljer pr. attribut
    name #link til statistik >> attribut
    transliteratedName
    fullName #korrekt menneskelæseligt navn
    unit#måleenheder
  }

  usedMachines { #brugte maskiner, som kommer fra metainformationen
    id
    serial
    operatorId
  } 

  createdDate #enhed oprettet dato og tid i GeoPard
  updatedDate #sidste opdateringsdato og -tid
  operationId
  operationType
  operationFileDate #filens oprettelsesdato og -tid kommer fra metainformationen 
  operationStartDate #operationens starttidspunkt kommer fra metainformationen
  
  statistics { #statistikfordeling for hver attribut
    attribute
    min
    max
    avg
    mdn
    var
    std
    sum
  }
  
  cropName #afgrødenavn kommer fra metainformationen
  cropToken #afgrødetoken (i STORE bogstaver) kommer fra metainformationen

  appliedCorrections #liste over anvendte korrektioner i nævnte rækkefølge
  appliedCorrectionsVersion #version af den anvendte korrelationsalgoritme

  geoMaps {
    url
    shortName #præfiks muligheder: raw, thumbnail_raw, processed, thumbnail_processed
    hexColorCodes
    classes
  } 
}
```

## 1. Forespørgsel getFarms

### Anmod

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

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

{% endcode %}

### Svar

```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. Forespørgsel getFields

### Anmod

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

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

{% endcode %}

### Svar

```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. Forespørgsel getYieldDatasets

### Anmod om den første side

```graphql
forespørgsel GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            sideStørrelse: 2
        }
    ) {
        yieldDatasets {
            uuid
            navn
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            nummer
        }
        sidstEvalueretNøgle {
            PartitionsNøgle
            SorteringsNøgle
            TagStreng
        }
    }
}
```

### Svar på den første side

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

### Anmod om den følgende side

Pagineringsparametre sendes via `sidstEvalueretNøgle`, ved at bruge værdien returneret i svaret på den første side ovenfor.

```graphql
forespørgsel GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            sideStørrelse: 2
            sidstEvalueretNøgle: {
                PartitionKey: "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
                SortKey: "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380",
                TagString: null
            }
        }
    ) {
        yieldDatasets {
            uuid
            navn
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            nummer
        }
        sidstEvalueretNøgle {
            PartitionsNøgle
            SorteringsNøgle
            TagStreng
        }
    }
}
```

### Svar på den følgende side

```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/dnk/api-dokumentation/oversigt-over-geopard-api-anmodninger/16.-foresporgsel-hent-yielddatasets.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.
