# 16. الاستعلام: الحصول على YieldDatasets

## نظرة عامة

احصل على جميع مجموعات بيانات المحصول (YieldDatasets) للحقل المحدد. 

يمكن جلب مجموعات بيانات المحصول باستخدام استعلامات GraphQL العامة:

1. `getFarms` باستخدام التسلسل الهرمي الكامل المزرعة > الحقل > مجموعة بيانات المحصول مع عوامل التصفية الخاصة بها
2.  `getFields` من الحقل المرتبط والتسلسل الهرمي الحقل > مجموعة بيانات المحصول
3. getYieldDatasets مع مجموعة واسعة من عوامل التصفية وتقطيع الصفحات

{% hint style="warning" %}
يجب رفع "مجموعة بيانات المحصول" مسبقًا.
{% endhint %}

## كيان مجموعة بيانات المحصول

تتضمن مجموعة بيانات المحصول العديد من السمات. يتيح لك GraphQL جلب الحقول المطلوبة فقط، مما يقلل بشكل كبير من حجم الطلب والاستجابة. يتم توفير تفسيرات مفصلة لكل سمة موضحة أدناه.

{% hint style="info" %}
السمات في "مجموعة بيانات المحصول" المشار إليها أدناه كـ *مأخوذة من معلومات التعريف (metainformation)* هي اختيارية. تُشتق من معلومات التعريف الخاصة بالمجموعة، والتي قد لا تكون موجودة بطبيعتها في كل مجموعة بيانات محصول.
{% endhint %}

{% hint style="success" %}
تفاصيل حول `geoMaps`  السمة لمجموعة بيانات المحصول متاحة [هنا](/geopard-tutorials/ar/mstndat-wajhh-brmjh-alttbyqat/nqat-nhayh-jghrafyh-llwswl-ila-albyanat-almkanyh/wms-jlb-alswr-alnqtyh-ltbqat-albyanat-almkanyh/12.-yielddatasetsmap.md).
{% endhint %}

{% hint style="success" %}
تفاصيل حول كيفية تشغيل عملية التنظيف والمعايرة (Clean and Calibration) لمجموعة بيانات المحصول متاحة [هنا](/geopard-tutorials/ar/mstndat-wajhh-brmjh-alttbyqat/nzrh-aamh-ala-tlbat-wajhh-brmjh-ttbyqat-geopard/84.-althwyr-maayrh-wtnzyf-yielddataset.md).
{% endhint %}

```graphql
{
  uuid
  name #النمط "<OperationType> <YYYY-mm-DD>" الحرث/العمل الأرضي
  number #إجمالي عدد المعالم الجغرافية
  geometryType #مضلعات أو نقاط
  totalCoveredArea(unit: HECTARES) #المساحة الإجمالية لجميع الهندسات (ذات صلة بالمضلعات)
  fieldCoverage #نسبة الحقل المغطاة بالمجموعة
  fieldCoveredArea(unit: HECTARES) #اتحاد الهندسات (دون تكرار)

  السمات (attributes)
  fullAttributes { #تفاصيل كاملة لكل سمة
    name #رابط لإحصاءات >> السمة
    transliteratedName
    fullName #الاسم الكامل المقروء من قبل الإنسان
    unit#وحدات القياس
  }

  usedMachines { #الآلات المستخدمة، والتي تأتي من معلومات التعريف
    معرّف
    serial
    operatorId
  } 

  createdDate #تاريخ ووقت إنشاء الكيان في GeoPard
  updatedDate #تاريخ ووقت آخر تحديث
  operationId
  operationType
  operationFileDate #تاريخ ووقت إنشاء الملف يأتي من معلومات التعريف 
  operationStartDate #بداية العملية تأتي من معلومات التعريف
  
  statistics { #توزيع الإحصاءات لكل سمة
    attribute
    min
    max
    avg
    mdn
    var
    std
    sum
  }
  
  cropName #اسم المحصول يأتي من معلومات التعريف
  cropToken #رمز المحصول (بالأحرف الكبيرة) يأتي من معلومات التعريف

  appliedCorrections #قائمة التصحيحات المطبقة بالترتيب المذكور
  appliedCorrectionsVersion #إصدار خوارزمية التصحيح المستخدمة

  خرائط_جغرافية {
    رابط
    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
    الاسم
    fields (fieldUuids: ["a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"]) {
      uuid
      yieldDatasets {
        uuid
        الاسم
        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
        الاسم
        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
            الاسم
            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
      }
    }
  }
}
```

### طلب الصفحة التالية

يتم تمرير معلمات الترقيم عبر `المفتاح_المقيَّم_الأخير`، باستخدام القيمة المعادة في استجابة الصفحة الأولى أعلاه.

```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
            الاسم
            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/ar/mstndat-wajhh-brmjh-alttbyqat/nzrh-aamh-ala-tlbat-wajhh-brmjh-ttbyqat-geopard/16.-alastalam-alhswl-ala-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.