# 16. Dotaz: Získat YieldDatasets

## Přehled

Získejte všechna YieldDataset pro vybrané pole.&#x20;

YieldDataset lze načíst pomocí obecných GraphQL dotazů:

1. `getFarms` použitím kompletní hierarchie Farma > Pole > YieldDataset s jejich filtry
2. &#x20;`getFields` ze propojeného Pole a hierarchie Pole > YieldDataset
3. getYieldDatasets s širokou škálou filtrů a stránkováním

{% hint style="warning" %}
Soubory typu "YieldDataset" musí být nahrány předem.
{% endhint %}

## Entita Yield Dataset

YieldDataset obsahuje mnoho atributů. GraphQL umožňuje načíst pouze požadovaná pole, což významně snižuje velikost požadavku a odpovědi. Podrobné vysvětlení každého atributu je uvedeno níže přímo v textu.

{% hint style="info" %}
Atributy v "YieldDataset" označené níže jako *pocházející z metainformací* jsou volitelné. Jsou odvozené z metainformací datasetu, které nejsou automaticky obsaženy v každém YieldDataset.
{% endhint %}

{% hint style="success" %}
Podrobnosti o `geoMaps`  atributu pro YieldDataset jsou k dispozici [zde](/geopard-tutorials/cze/api-dokumentace/geo-koncove-body-pro-pristup-k-prostorovym-datum/wms-ziskat-rastrove-snimky-vrstev-prostorovych-dat/12.-yielddatasetsmap.md).
{% endhint %}

{% hint style="success" %}
Podrobnosti o tom, jak spustit Čištění a Kalibraci pro YieldDataset, jsou k dispozici [zde](/geopard-tutorials/cze/api-dokumentace/prehled-pozadavku-api-geopardu/84.-mutace-kalibrovat-a-vycistit-yielddataset.md).
{% endhint %}

```graphql
{
  uuid
  název #vzor "<OperationType> <YYYY-mm-DD>" Orba
  number #celkový počet geofeatures
  geometryType #Polygony nebo Body
  totalCoveredArea(unit: HECTARES) #celková plocha všech geometrií (relevantní pro polygony)
  fieldCoverage #procento pole pokryté datasetem
  fieldCoveredArea(unit: HECTARES) #sjednocení geometrií (bez duplicit)

  atributů
  fullAttributes { #úplné informace pro každý atribut
    name #odkaz na statistiky >> atribut
    transliteratedName
    fullName #správný čitelný název
    unit#jednotky měření
  }

  usedMachines { #použité stroje, které pocházejí z metainformací
    id
    serial
    operatorId
  } 

  createdDate #datum a čas vytvoření entity v GeoPard
  updatedDate #datum a čas poslední aktualizace
  operationId
  operationType
  operationFileDate #datum a čas vytvoření souboru pocházejí z metainformací 
  operationStartDate #začátek operace pochází z metainformací
  
  statistics { #rozdělení statistik pro každý atribut
    attribute
    min
    max
    avg
    mdn
    var
    std
    sum
  }
  
  cropName #název plodiny pochází z metainformací
  cropToken #token plodiny (VELKÝMI PÍSMENY) pochází z metainformací

  appliedCorrections #seznam použitých korekcí v uvedeném pořadí
  appliedCorrectionsVersion #verze použitého korekčního algoritmu

  geoMaps {
    url
    shortName #možnosti prefixu: raw, thumbnail_raw, processed, thumbnail_processed
    hexColorCodes
    classes
  } 
}
```

## 1. Dotaz getFarms

### Požádat

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

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

{% endcode %}

### Odpověď

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

### Požádat

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

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

{% endcode %}

### Odpověď

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

### Požádejte o první stránku

```graphql
dotaz GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            velikostStránky: 2
        }
    ) {
        yieldDatasets {
            uuid
            název
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            number
        }
        posledníVyhodnocenýKlíč {
            OddílKlíče
            TřídicíKlíč
            ŘetězecŠtítku
        }
    }
}
```

### Odpověď první stránky

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

### Požádejte o následující stránku

Parametry stránkování se předávají přes `posledníVyhodnocenýKlíč`, použitím hodnoty vrácené v odpovědi první stránky výše.

```graphql
dotaz GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            velikostStránky: 2
            posledníVyhodnocenýKlíč: {
                PartitionKey: "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
                SortKey: "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380",
                TagString: null
            }
        }
    ) {
        yieldDatasets {
            uuid
            název
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            number
        }
        posledníVyhodnocenýKlíč {
            OddílKlíče
            TřídicíKlíč
            ŘetězecŠtítku
        }
    }
}
```

### Odpověď následující stránky

```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/cze/api-dokumentace/prehled-pozadavku-api-geopardu/16.-dotaz-ziskat-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.
