16. Poizvedba: pridobi nabore podatkov prinosov

Pregled

Pridobite vse nize podatkov o pridelku (YieldDatasets) za izbrano polje.

Nize podatkov o pridelku lahko pridobite z uporabo generičnih GraphQL poizvedb:

1. getFarms uporaba celotne hierarhije Farma > Polje > YieldDataset z njegovimi filtri

2. getFields iz povezanega Polja in hierarhije Polje > YieldDataset

3. getYieldDatasets z nizom filtrov in paginacijo

Niz podatkov "YieldDataset" mora biti naložen vnaprej.

Entiteta niza podatkov o pridelku (Yield Dataset)

YieldDataset vključuje številne atribute. GraphQL omogoča, da pridobite le potrebna polja, kar bistveno zmanjša velikost zahtevka in odgovora. Podrobna pojasnila za vsak atribut so navedena spodaj.

Atributi v "YieldDataset" označeni spodaj kot izhajajo iz metapodatkov so neobvezni. Izvedeni so iz metapodatkov niza podatkov, ki niso nujno prisotni v vsakem YieldDatasetu.

Podrobnosti o geoMaps attributu za YieldDataset so na voljo tukaj.

Podrobnosti o tem, kako sprožiti Čiščenje in Kalibracijo za YieldDataset, so na voljo tukaj.

{
  uuid
  ime #vzorec "<OperationType> <YYYY-mm-DD>" Obdelava tal (Tillage)
  number #skupno število geofunkcij
  vrstaGeometrije #Poligoni ali Točke
  skupnaPokritaPovršina(enota: HECTARI) #skupna površina vseh geometrij (pomembno za poligone)
  pokritostPolja #delež polja, pokrit s podatkovnim nizom
  pokritaPovršinaPolja(enota: HECTARI) #unija geometrij (brez podvajanj)

  attributes
  fullAttributes { #popolni podatki za vsak atribut
    name #povezava do statistike >> atribut
    transliteratedName
    polnoIme #pravilno berljivo ime
    enota#mere
  }

  uporabljeneStroje { #uporabljeni stroji, izhaja iz metapodatkov
    id
    serijska
    idOperaterja
  } 

  createdDate #čas in datum ustvarjanja entitete v GeoPard
  updatedDate #čas in datum zadnje posodobitve
  operationId
  operationType
  datumDatotekeOperacije #čas ustvarjanja datoteke izhaja iz metapodatkov 
  začetekOperacijeDatum #začetek operacije izhaja iz metapodatkov
  
  statistika { #porazdelitev statistike za vsak atribut
    attribute
    min
    max
    avg
    mdn
    var
    std
    sum
  }
  
  imeKulture #ime kulture izhaja iz metapodatkov
  tokenKulture #token kulture (z velikimi črkami) izhaja iz metapodatkov

  uporabljeneKorekcije #seznam uporabljenih korekcij v omenjenem vrstnem redu
  verzijaUporabljenihKorekcij #verzija uporabljenega korekcijskega algoritma

  geoMaps {
    url
    kratkoIme #možnosti predpone: raw, thumbnail_raw, processed, thumbnail_processed
    hexBarvneKode
    razredi
  } 
}

1. Poizvedba getFarms

Zahtevaj

poizvedba GetYieldDatasetsViaGetFarms {
  getFarms (farmUuids: ["9eecef55-f74f-4099-991a-05cbd976d50a"]) {
    uuid
    ime
    polja (fieldUuids: ["a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"]) {
      uuid
      yieldDatasets {
        uuid
        ime
        številka
        geometryType
        totalCoveredArea(unit: HECTARES)
        fieldCoverage
        fieldCoveredArea(unit: HECTARES)
      }
    }
  }
}

Odgovor

{
  "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. Poizvedba getFields

Zahtevaj

poizvedba GetYieldDatasetsViaGetFields {
  getFields (filter: {fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"}) {
    polja {
      uuid
      površina(enota: HEKTARJI)
      yieldDatasets(yieldDatasetUuids: ["8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8"]) {
        uuid
        ime
        številka
        geometryType
        totalCoveredArea(unit: HECTARES)
        fieldCoverage
        fieldCoveredArea(unit: HECTARES)
      }
    }
  }
}

Odgovor

{
  "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. Poizvedba getYieldDatasets

Zahtevek za prvo stran

poizvedba GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            velikostStrani: 2
        }
    ) {
        yieldDatasets {
            uuid
            ime
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            številka
        }
        zadnjiOcenjeniKljuč {
            PartitionKey
            SortKey
            TagString
        }
    }
}

Odgovor prve strani

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

Zahtevek za naslednjo stran

Parametri paginacije se posredujejo preko zadnjiOcenjeniKljuč, z uporabo vrednosti, vrnjene v odgovoru prve strani zgoraj.

poizvedba GetPaginatedYieldDatasets {
    getYieldDatasets(
        filter:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            velikostStrani: 2
            zadnjiOcenjeniKljuč: {
                PartitionKey: "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
                SortKey: "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380",
                TagString: null
            }
        }
    ) {
        yieldDatasets {
            uuid
            ime
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            številka
        }
        zadnjiOcenjeniKljuč {
            PartitionKey
            SortKey
            TagString
        }
    }
}

Odgovor naslednje strani

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