# 16. Query: obține YieldDatasets

## Prezentare generală

Obține toate seturile de date de producție (YieldDatasets) pentru parcela selectată. 

Seturile de date de producție pot fi preluate folosind interogări GraphQL generice:

1. `getFarms` folosind ierarhia completă Ferma > Parcelă > YieldDataset cu filtrele sale
2.  `getFields` din parcela legată și ierarhia Parcelă > YieldDataset
3. getYieldDatasets cu o gamă largă de filtre și paginare

{% hint style="warning" %}
Un "YieldDataset" trebuie încărcat în prealabil.
{% endhint %}

## Entitate Yield Dataset

YieldDataset include multe atribute. GraphQL îți permite să preiei doar câmpurile necesare, reducând semnificativ dimensiunea cererii și a răspunsului. Explicații detaliate pentru fiecare atribut sunt furnizate inline mai jos.

{% hint style="info" %}
Atributele din "YieldDataset" marcate mai jos ca *provin din metainformații* sunt opționale. Ele sunt derivate din metainformațiile setului de date, care nu sunt prezente în mod inerent în fiecare YieldDataset.
{% endhint %}

{% hint style="success" %}
Detalii despre `geoMaps`  atributul pentru YieldDataset sunt disponibile [aici](/geopard-tutorials/ro/documentatia-api/endpointuri-geo-pentru-acces-la-date-spatiale/wms-obtine-imagini-raster-ale-straturilor-de-date-spatiale/12.-yielddatasetsmap.md).
{% endhint %}

{% hint style="success" %}
Detalii despre cum să declanșezi Clean și Calibration pentru YieldDataset sunt disponibile [aici](/geopard-tutorials/ro/documentatia-api/prezentarea-generala-a-solicitarilor-api-geopard/84.-mutare-calibreaza-si-curata-yielddataset.md).
{% endhint %}

```graphql
{
  uuid
  nume #pattern "<OperationType> <YYYY-mm-DD>" Lucrare de prelucrare a solului
  number #numărul total de geofeature-uri
  geometryType #Poligoane sau Puncte
  totalCoveredArea(unit: HECTARES) #aria totală a tuturor geometrilor (relevant pentru poligoane)
  fieldCoverage #procentul din parcela acoperit de setul de date
  fieldCoveredArea(unit: HECTARES) #uniunea geometriilor (fără duplicate)

  atribute
  fullAttributes { #detalii complete pe atribut
    name #legătură către statistici >> atribut
    transliteratedName
    fullName #nume corect, lizibil de către om
    unit#unități de măsură
  }

  usedMachines { #utilaje folosite, care provin din metainformații
    id
    serial
    operatorId
  } 

  createdDate #data și ora creării entității în GeoPard
  updatedDate #data și ora ultimei actualizări
  operationId
  operationType
  operationFileDate #data și ora creării fișierului provin din metainformații 
  operationStartDate #începutul operațiunii provine din metainformații
  
  statistics { #distribuția statistică pentru fiecare atribut
    attribute
    min
    max
    avg
    mdn
    var
    std
    sum
  }
  
  cropName #numele culturii provine din metainformații
  cropToken #tokenul culturii (cu majuscule) provine din metainformații

  appliedCorrections #lista corecțiilor aplicate în ordinea menționată
  appliedCorrectionsVersion #versiunea algoritmului de corecție utilizat

  geoMaps {
    url
    shortName #opțiuni prefix: raw, thumbnail_raw, processed, thumbnail_processed
    hexColorCodes
    classes
  } 
}
```

## 1. Interogare getFarms

### Solicitați

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

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

{% endcode %}

### Răspuns

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

### Solicitați

{% 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
        nume
        număr
        geometryType
        totalCoveredArea(unit: HECTARES)
        fieldCoverage
        fieldCoveredArea(unit: HECTARES)
      }
    }
  }
}
```

{% endcode %}

### Răspuns

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

### Solicită prima pagină

```graphql
query GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            dimensiunePagină: 2
        }
    ) {
        yieldDatasets {
            uuid
            nume
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            număr
        }
        ultimaCheieEvaluată {
            CheiePartiție
            CheieSortare
            ȘirEtichetă
        }
    }
}
```

### Răspunsul primei pagini

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

### Solicită pagina următoare

Parametrii de paginare sunt transmiși prin `ultimaCheieEvaluată`, folosind valoarea returnată în răspunsul primei pagini de mai sus.

```graphql
query GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            dimensiunePagină: 2
            ultimaCheieEvaluată: {
                PartitionKey: "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
                SortKey: "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380",
                TagString: null
            }
        }
    ) {
        yieldDatasets {
            uuid
            nume
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            număr
        }
        ultimaCheieEvaluată {
            CheiePartiție
            CheieSortare
            ȘirEtichetă
        }
    }
}
```

### Răspunsul paginii următoare

```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/ro/documentatia-api/prezentarea-generala-a-solicitarilor-api-geopard/16.-query-obtine-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.