16. استعلام: الحصول على مجموعات بيانات الغلة

نظرة عامة

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

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

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

2. getFields من الحقل المرتبط والتسلسل الهرمي الحقل > مجموعة بيانات المحصول

3. getYieldDatasets مع مجموعة واسعة من عوامل التصفية وتقطيع الصفحات

يجب رفع "مجموعة بيانات المحصول" مسبقًا.

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

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

السمات في "مجموعة بيانات المحصول" المشار إليها أدناه كـ مأخوذة من معلومات التعريف (metainformation) هي اختيارية. تُشتق من معلومات التعريف الخاصة بالمجموعة، والتي قد لا تكون موجودة بطبيعتها في كل مجموعة بيانات محصول.

تفاصيل حول geoMaps السمة لمجموعة بيانات المحصول متاحة هنا.

تفاصيل حول كيفية تشغيل عملية التنظيف والمعايرة (Clean and Calibration) لمجموعة بيانات المحصول متاحة هنا.

{
  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

طلب

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

الاستجابة

{
  "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

طلب

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

الاستجابة

{
  "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

طلب الصفحة الأولى

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

استجابة الصفحة الأولى

{
  "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
      }
    }
  }
}

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

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

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

استجابة الصفحة التالية

{
  "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
      }
    }
  }
}