# 16. Kysely: hae YieldDatasets ## 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 {% hint style="warning" %} ”YieldDataset” on ladattava etukäteen. {% endhint %} ## 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. {% hint style="info" %} Attribuutit ”YieldDataset”-kohdassa, jotka on merkitty alla *tulevat metatiedoista* ovat valinnaisia. Ne johdetaan aineiston metatiedoista, joita ei ole automaattisesti läsnä jokaisessa YieldDatasetissä. {% endhint %} {% hint style="success" %} Tiedot `geoMaps` attribuutista YieldDatasetille ovat saatavilla [tässä](/geopard-tutorials/fin/api-dokumentaatio/paikkatietodatan-geo-paatepisteet/wms-hae-paikkatietokerrosten-rasterikuvia/12.-yielddatasetsmap.md). {% endhint %} {% hint style="success" %} Tiedot siitä, miten käynnistää Puhdistus ja Kalibrointi YieldDatasetille, ovat saatavilla [tässä](/geopard-tutorials/fin/api-dokumentaatio/geopard-api-pyyntojen-yleiskatsaus/84.-muutos-kalibroi-ja-puhdista-satotietoaineisto.md). {% endhint %} ```graphql { uuid nimi #malli " " 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ä {% code overflow="wrap" lineNumbers="true" %} ```graphql 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) } } } } ``` {% endcode %} ### Vastaus ```json { "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ä {% code overflow="wrap" lineNumbers="true" %} ```graphql 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) } } } } ``` {% endcode %} ### Vastaus ```json { "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 ```graphql 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 ```json { "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. ```graphql 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 ```json { "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 } } } } ``` --- # 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/fin/api-dokumentaatio/geopard-api-pyyntojen-yleiskatsaus/16.-kysely-hae-yielddatasets.md?ask= ``` 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.