# 16. Spørring: Hent YieldDatasets

## Oversikt

Hent alle YieldDatasets for det valgte feltet.&#x20;

YieldDatasets kan hentes ved hjelp av generiske GraphQL-spørringer:

1. `getFarms` ved å bruke hele hierarkiet Gård > Felt > YieldDataset med sine filtre
2. &#x20;`getFields` fra det tilknyttede feltet og hierarkiet Felt > YieldDataset
3. getYieldDatasets med et bredt spekter av filtre og paginering

{% hint style="warning" %}
En "YieldDataset" må være lastet opp på forhånd.
{% endhint %}

## Yield Dataset-enhet

YieldDataset inkluderer mange attributter. GraphQL lar deg hente kun de nødvendige feltene, noe som reduserer forespørsels- og svartstørrelsen betydelig. Detaljerte forklaringer for hver attributt gis inline nedenfor.

{% hint style="info" %}
Attributter i "YieldDataset" merket nedenfor som *kommer fra metainformasjon* er valgfrie. De er avledet fra datasetets metainformasjon, som ikke nødvendigvis er til stede i hvert YieldDataset.
{% endhint %}

{% hint style="success" %}
Detaljer om `geoMaps`  attributtet for YieldDataset er tilgjengelig [her](/geopard-tutorials/nor/api-dokumentasjon/geo-endepunkter-for-tilgang-til-romlige-data/wms-hent-rasterbilder-av-romlige-datalag/12.-yielddatasetsmap.md).
{% endhint %}

{% hint style="success" %}
Detaljer om hvordan utløse Rensing og Kalibrering for YieldDataset er tilgjengelig [her](/geopard-tutorials/nor/api-dokumentasjon/geopard-api-foresporsler-oversikt/84.-mutasjon-kalibrer-og-rens-yielddataset.md).
{% endhint %}

```graphql
{
  uuid
  navn #mønster "<OperationType> <YYYY-mm-DD>" Jordarbeiding
  number #totalt antall geofunksjoner
  geometryType #Polygoner eller Punkter
  totalCoveredArea(unit: HECTARES) #totalt areal av alle geometrier (relevant for Polygoner)
  fieldCoverage #prosent av feltet dekket av datasettet
  fieldCoveredArea(unit: HECTARES) #union av geometrier (uten duplikater)

  attributes
  fullAttributes { #komplette detaljer per attributt
    name #lenke til statistikk >> attributt
    transliteratedName
    fullName #korrekt menneske-lesbart navn
    unit#måleenheter
  }

  usedMachines { #brukte maskiner, som kommer fra metainformasjonen
    id
    serienummer
    operatørId
  } 

  createdDate #entitet opprettet dato og tid i GeoPard
  updatedDate #siste oppdatering dato og tid
  operationId
  operationType
  operationFileDate #filens opprettelsesdato og -tid kommer fra metainformasjonen 
  operationStartDate #starttidspunkt for operasjonen kommer fra metainformasjonen
  
  statistics { #statistikkfordeling for hver attributt
    attribute
    min
    max
    avg
    mdn
    var
    std
    sum
  }
  
  cropName #navn på avlingen kommer fra metainformasjonen
  cropToken #avlingstoken (i STORE BOKSTAVER) kommer fra metainformasjonen

  appliedCorrections #liste over anvendte korreksjoner i nevnt rekkefølge
  appliedCorrectionsVersion #versjon av den brukte korreksjonsalgoritmen

  geoMaps {
    url
    shortName #prefiksvalg: raw, thumbnail_raw, processed, thumbnail_processed
    hexColorCodes
    classes
  } 
}
```

## 1. Spørring getFarms

### Be om

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

```graphql
spørring 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 %}

### 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. Spørring getFields

### Be om

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

```graphql
spørring 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 %}

### 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. Spørring getYieldDatasets

### Be om første side

```graphql
spørring GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            sideStørrelse: 2
        }
    ) {
        yieldDatasets {
            uuid
            navn
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            nummer
        }
        sisteEvaluerteNøkkel {
            PartitionKey
            SortKey
            TagString
        }
    }
}
```

### Responsen for 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
      }
    }
  }
}
```

### Be om neste side

Paginering parametere sendes via `sisteEvaluerteNøkkel`, ved å bruke verdien returnert i responsen for første side ovenfor.

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

### Responsen for neste 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/nor/api-dokumentasjon/geopard-api-foresporsler-oversikt/16.-sporring-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.
