16. Kysely: Hae satoaineistot

Yleiskatsaus

Hae kaikki valitun lohkon sadonkorjuuaineistot.

Sadonkorjuuaineistot voidaan hakea yleisillä GraphQL-kyselyillä:

1. getFarms käyttäen täydellistä hierarkiaa Tila > Lohko > Sadonkorjuuaineisto ja sen suodattimia

2. getFields liitetystä lohkosta ja hierarkiasta Lohko > Sadonkorjuuaineisto

3. getYieldDatasets monipuolisilla suodattimilla ja sivutuksella

”YieldDataset” on ladattava etukäteen.

Sadonkorjuuaineiston entiteetti

YieldDataset sisältää monia attribuutteja. GraphQL:n avulla voit hakea vain tarvittavat kentät, mikä pienentää merkittävästi pyynnön ja vastauksen kokoa. Yksityiskohtaiset selitykset kustakin attribuutista on annettu alla rivittäin.

Attribuutit ”YieldDataset”-kohdassa, jotka on merkitty alla tulevat metatiedoista ovat valinnaisia. Ne johdetaan aineiston metatiedoista, joita ei ole automaattisesti läsnä jokaisessa YieldDatasetissä.

Tiedot geoMaps attribuutista YieldDatasetille ovat saatavilla tässä.

Tiedot siitä, miten käynnistää Puhdistus ja Kalibrointi YieldDatasetille, ovat saatavilla tässä.

{
  uuid
  nimi #malli "<OperationType> <YYYY-mm-DD>" Muokkaus
  number #geopiirteiden kokonaismäärä
  geometriatyyppi #Monikulmiot tai Pisteet
  kokonaispeittoala(unit: HECTARES) #kaikkien geometrioiden kokonaisala (merkityksellinen monikulmioille)
  lohkonPeitto #prosenttiosuus lohkosta, jonka aineisto kattaa
  lohkonPeittoala(unit: HECTARES) #geometrioiden yhdiste (ilman duplikaatteja)

  attributes
  fullAttributes { #täydelliset tiedot per attribuutti
    name #linkki tilastoon >> attribuutti
    transliteratedName
    täydellinenNimi #oikea ihmisluettava nimi
    yksikkö#mittayksikkö
  }

  käytetytKoneet { #käytetyt koneet, jotka tulevat metatiedoista
    id
    sarjanumero
    kuljettajaId
  } 

  createdDate #entiteetin luontiaika GeoPardissa
  updatedDate #viimeisin päivitysaika
  operationId
  operationType
  toimintotiedostoPäivämäärä #tiedoston luomisen aikaleima tulee metatiedoista 
  toiminnanAlkamispäivä #toiminnon alkamisaika tulee metatiedoista
  
  tilastot { #tilastojen jakauma jokaiselle attribuutille
    attribute
    min
    max
    avg
    mdn
    var
    std
    sum
  }
  
  kasvinNimi #kasvin nimi tulee metatiedoista
  kasviToken #kasvin tunniste (ISOISO) tulee metatiedoista

  sovellettuKorjaukset #lista sovelletuista korjauksista mainitussa järjestyksessä
  sovellettuKorjausVersio #käytetyn korjausalgoritmin versio

  geoKartat {
    url
    lyhytNimi #etulihemma vaihtoehdot: raw, thumbnail_raw, processed, thumbnail_processed
    hexVärikoodit
    luokat
  } 
}

1. Kysely getFarms

Pyydä

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

Vastaus

{
  "data": {
    "getFarms": [
      {
        "uuid": "9eecef55-f74f-4099-991a-05cbd976d50a",
        "nimi": "TEST VECTOR DATA",
        "fields": [
          {
            "uuid": "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
            "yieldDatasets": [
              {
                "uuid": "08f0fee4-daf4-4a98-97e5-660b7b6cfbeb",
                "nimi": "CALIBRATE-CLEAN-YieldCORN2017",
                "numero": 14657,
                "geometriatyyppi": "POINTS",
                "kokonaispeittoala": -1.0,
                "lohkonPeitto": 0.97578,
                "lohkonPeittoala": 21.024173
              },
              {
                "uuid": "2b4fbd15-c961-49c8-8cc2-3031397d0380",
                "nimi": "CALIBRATE-YieldCORN2017",
                "numero": 16200,
                "geometriatyyppi": "POINTS",
                "kokonaispeittoala": -1.0,
                "lohkonPeitto": 0.98791,
                "lohkonPeittoala": 21.285677
              },
              {
                "uuid": "465769d3-14dd-419f-9740-fb230c0505fd",
                "nimi": "YieldSbean2018_reupload",
                "numero": 9073,
                "geometriatyyppi": "POINTS",
                "kokonaispeittoala": -1.0,
                "lohkonPeitto": 0.92874,
                "lohkonPeittoala": 20.0107663
              },
              {
                "uuid": "73d247ad-c45b-47a5-b94d-a2eb502857fe",
                "nimi": "CLEAN-YieldCORN2017 before build",
                "numero": 14709,
                "geometriatyyppi": "POINTS",
                "kokonaispeittoala": -1.0,
                "lohkonPeitto": 0.98305,
                "lohkonPeittoala": 21.1808419
              },
              {
                "uuid": "74f06214-1051-47a2-a560-696d9290245a",
                "nimi": "YieldSbean2018",
                "numero": 10179,
                "geometriatyyppi": "POINTS",
                "kokonaispeittoala": -1.0,
                "lohkonPeitto": 0.92874,
                "lohkonPeittoala": 20.0107663
              },
              {
                "uuid": "7e2bc706-2da4-43ae-beaa-240300d20c53",
                "nimi": "YieldSbean2015",
                "numero": 10293,
                "geometriatyyppi": "POINTS",
                "kokonaispeittoala": -1.0,
                "lohkonPeitto": 0.96217,
                "lohkonPeittoala": 20.730980600000002
              },
              {
                "uuid": "7fb9fb1f-c4df-4146-892c-ba672dab9cd7",
                "nimi": "CALIBRATE-CLEAN-YieldSbean2018",
                "numero": 9026,
                "geometriatyyppi": "POINTS",
                "kokonaispeittoala": -1.0,
                "lohkonPeitto": 0.92426,
                "lohkonPeittoala": 19.914270300000002
              },
              {
                "uuid": "8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8",
                "nimi": "CLEAN-YieldCORN2017 after build",
                "numero": 14709,
                "geometriatyyppi": "POINTS",
                "kokonaispeittoala": -1.0,
                "lohkonPeitto": 0.98305,
                "lohkonPeittoala": 21.1808419
              },
              {
                "uuid": "a7f9d7cc-e1e1-46ff-b13d-468518749ba9",
                "nimi": "CALIBRATE-YieldSbean2015",
                "numero": 9310,
                "geometriatyyppi": "POINTS",
                "kokonaispeittoala": -1.0,
                "lohkonPeitto": 0.95482,
                "lohkonPeittoala": 20.5726658
              },
              {
                "uuid": "cbd0c66b-21e3-4997-96a7-f1179da18c36",
                "nimi": "CLEAN-CALIBRATE-YieldSbean2015",
                "numero": 9183,
                "geometriatyyppi": "POINTS",
                "kokonaispeittoala": -1.0,
                "lohkonPeitto": 0.90674,
                "lohkonPeittoala": 19.5366444
              },
              {
                "uuid": "fdfd701f-6529-4f4e-8027-e831fb557fe2",
                "nimi": "YieldCORN2017",
                "numero": 16334,
                "geometriatyyppi": "POINTS",
                "kokonaispeittoala": -1.0,
                "lohkonPeitto": 0.97947,
                "lohkonPeittoala": 21.103661199999998
              }
            ]
          }
        ]
      }
    ]
  }
}

2. Kysely getFields

Pyydä

kysely GetYieldDatasetsViaGetFields {
  getFields (filter: {fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"}) {
    fields {
      uuid
      area(unit: HECTARES)
      yieldDatasets(yieldDatasetUuids: ["8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8"]) {
        uuid
        nimi
        numero
        geometryType
        totalCoveredArea(unit: HECTARES)
        fieldCoverage
        fieldCoveredArea(unit: HECTARES)
      }
    }
  }
}

Vastaus

{
  "data": {
    "getFields": {
      "fields": [
        {
          "uuid": "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
          "ala": 21.541909393943847,
          "yieldDatasets": [
            {
              "uuid": "8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8",
              "nimi": "CLEAN-YieldCORN2017 after build",
              "numero": 14709,
              "geometriatyyppi": "POINTS",
              "kokonaispeittoala": -1.0,
              "lohkonPeitto": 0.98305,
              "lohkonPeittoala": 21.1808419
            }
          ]
        }
      ]
    }
  }
}

3. Kysely getYieldDatasets

Pyydä ensimmäinen sivu

kysely GetPaginatedYieldDatasets {
    getYieldDatasets(
        suodatin:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            sivunKoko: 2
        }
    ) {
        yieldDatasets {
            uuid
            nimi
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            numero
        }
        viimeinenArvioituAvain {
            OsioAvain
            LajittelunAvain
            TunnisteMerkkijono
        }
    }
}

Ensimmäisen sivun vastaus

{
  "data": {
    "getYieldDatasets": {
      "yieldDatasets": [
        {
          "uuid": "08f0fee4-daf4-4a98-97e5-660b7b6cfbeb",
          "nimi": "CALIBRATE-CLEAN-YieldCORN2017",
          "lohkonPeitto": 0.97578,
          "lohkonPeittoala": 21.024173,
          "numero": 14657
        },
        {
          "uuid": "2b4fbd15-c961-49c8-8cc2-3031397d0380",
          "nimi": "CALIBRATE-YieldCORN2017",
          "lohkonPeitto": 0.98791,
          "lohkonPeittoala": 21.285677,
          "numero": 16200
        }
      ],
      "viimeinenArvioituAvain": {
        "PartitionKey": "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
        "SortKey": "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380",
        "TagString": null
      }
    }
  }
}

Pyydä seuraava sivu

Sivutusparametrit välitetään kautta viimeinenArvioituAvain, käyttäen yllä ensimmäisen sivun vastauksessa palautettua arvoa.

kysely GetPaginatedYieldDatasets {
    getYieldDatasets(
        suodatin:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            sivunKoko: 2
            viimeinenArvioituAvain: {
                PartitionKey: "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
                SortKey: "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380",
                TagString: null
            }
        }
    ) {
        yieldDatasets {
            uuid
            nimi
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            numero
        }
        viimeinenArvioituAvain {
            OsioAvain
            LajittelunAvain
            TunnisteMerkkijono
        }
    }
}

Seuraavan sivun vastaus

{
  "data": {
    "getYieldDatasets": {
      "yieldDatasets": [
        {
          "uuid": "465769d3-14dd-419f-9740-fb230c0505fd",
          "nimi": "YieldSbean2018_reupload",
          "lohkonPeitto": 0.92874,
          "lohkonPeittoala": 20.0107663,
          "numero": 9073
        },
        {
          "uuid": "73d247ad-c45b-47a5-b94d-a2eb502857fe",
          "nimi": "CLEAN-YieldCORN2017 before build",
          "lohkonPeitto": 0.98305,
          "lohkonPeittoala": 21.1808419,
          "numero": 14709
        }
      ],
      "viimeinenArvioituAvain": {
        "PartitionKey": "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
        "SortKey": "YVDATA-73d247ad-c45b-47a5-b94d-a2eb502857fe",
        "TagString": null
      }
    }
  }
}