# 16. क्वेरी: YieldDatasets प्राप्त करें

## अवलोकन

चयनित खेत के लिए सभी YieldDatasets प्राप्त करें। 

YieldDatasets को सामान्य GraphQL क्वेरीज़ का उपयोग करके प्राप्त किया जा सकता है:

1. `getFarms` पूर्ण पदानुक्रम Farm > Field > YieldDataset और इसके फिल्टर का उपयोग करते हुए
2.  `getFields` लिंक किए गए खेत से और पदानुक्रम Field > YieldDataset से
3. getYieldDatasets कई प्रकार के फिल्टर और पेजिनेशन के साथ प्राप्त करें

{% hint style="warning" %}
एक "YieldDataset" को पहले से अपलोड किया जाना चाहिए।
{% endhint %}

## Yield Dataset इकाई

YieldDataset में कई गुण होते हैं। GraphQL आपको केवल आवश्यक फ़ील्ड ही प्राप्त करने देता है, जिससे अनुरोध और प्रतिक्रिया का आकार काफी कम हो जाता है। प्रत्येक गुण के लिए विस्तृत व्याख्याएँ नीचे इनलाइन दी गई हैं।

{% hint style="info" %}
"YieldDataset" में नीचे दर्शाए गए गुण जिन्हें चिह्नित किया गया है *मेटाइनफ़ॉर्मेशन से आ रहा है* वैकल्पिक हैं। ये dataset के मेटाइनफ़ॉर्मेशन से व्युत्पन्न होते हैं, जो हर YieldDataset में स्वाभाविक रूप से मौजूद नहीं होते।
{% endhint %}

{% hint style="success" %}
के बारे में विवरण `geoMaps`  YieldDataset के गुण के लिए उपलब्ध हैं [यहाँ](/geopard-tutorials/in/api/geo-endpoints-for-spatial-data-access/wms/12.-yielddatasetsmap.md).
{% endhint %}

{% hint style="success" %}
YieldDataset के लिए Clean और Calibration कैसे ट्रिगर करें, इसके बारे में विवरण उपलब्ध हैं [यहाँ](/geopard-tutorials/in/api/geopard-api-3/84.-yielddataset.md).
{% endhint %}

```graphql
{
  uuid
  name #pattern "<OperationType> <YYYY-mm-DD>" जुताई (Tillage)
  number #भू-विशेषताओं की कुल संख्या
  geometryType #Polygons या Points
  totalCoveredArea(unit: HECTARES) #सभी ज्यामितियों का कुल क्षेत्रफल (Polygons के लिए प्रासंगिक)
  fieldCoverage #डेटासेट द्वारा कवर किए गए खेत का प्रतिशत
  fieldCoveredArea(unit: HECTARES) #ज्यामितियों का संघ (डुप्लिकेट के बिना)

  attributes
  fullAttributes { #प्रति गुण का पूरा विवरण
    name #आँकड़ों से लिंक >> attribute
    transliteratedName
    fullName #सही मानव-पठनीय नाम
    unit#माप की एकाइयाँ
  }

  usedMachines { #उपयोग की गई मशीनें, जो मेटाइनफ़ॉर्मेशन से आती हैं
    id
    serial
    operatorId
  } 

  createdDate #GeoPard में इकाई का निर्माण तिथि-समय
  updatedDate #अंतिम अपडेट तिथि-समय
  operationId
  operationType
  operationFileDate #फ़ाइल निर्माण तिथि-समय मेटाइनफ़ॉर्मेशन से आती है 
  operationStartDate #ऑपरेशन की शुरुआत मेटाइनफ़ॉर्मेशन से आती है
  
  statistics { #हर गुण के लिए सांख्यिकी वितरण
    attribute
    min
    max
    avg
    mdn
    var
    std
    sum
  }
  
  cropName #फ़सल का नाम मेटाइनफ़ॉर्मेशन से आता है
  cropToken #फ़सल टोकन (अपरकेस में) मेटाइनफ़ॉर्मेशन से आता है

  appliedCorrections #उपरोक्त क्रम में लागू सुधारों की सूची
  appliedCorrectionsVersion #उपयोग किए गए सुधार एल्गोरिथ्म का संस्करण

  geoMaps {
    url
    shortName #प्रिफिक्स विकल्प: raw, thumbnail_raw, processed, thumbnail_processed
    hexColorCodes
    classes
  } 
}
```

## 1. क्वेरी getFarms

### अनुरोध करें

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

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

{% endcode %}

### प्रतिक्रिया

```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. क्वेरी getFields

### अनुरोध करें

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

{% endcode %}

### प्रतिक्रिया

```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. क्वेरी getYieldDatasets

### पहला पृष्ठ अनुरोध करें

```graphql
query GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            pageSize: 2
        }
    ) {
        yieldDatasets {
            uuid
            name
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            number
        }
        lastEvaluatedKey {
            PartitionKey
            SortKey
            TagString
        }
    }
}
```

### पहले पृष्ठ की प्रतिक्रिया

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

### अगला पृष्ठ अनुरोध करें

पेजिनेशन पैरामीटर को द्वारा पास किया जाता है `lastEvaluatedKey`, पहले पृष्ठ प्रतिक्रिया में ऊपर दिए गए मान का उपयोग करते हुए।

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

### अगले पृष्ठ की प्रतिक्रिया

```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/in/api/geopard-api-3/16.-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.