# 16. Užklausa: gauti DerliausDuomenųRinkinius ## Apžvalga Gaukite visus derliaus rinkinių (YieldDatasets) už pasirinktą lauką. Derliaus rinkinius galima gauti naudojant bendrąsias GraphQL užklausas: 1. `getFarms` naudojant visą hierarchiją Ferma > Laukas > YieldDataset su jo filtrais 2. `getFields` iš susieto Lauko ir hierarchijos Laukas > YieldDataset 3. getYieldDatasets su plačiu filtrų ir puslapiavimo spektru {% hint style="warning" %} „YieldDataset“ turi būti įkeltas iš anksto. {% endhint %} ## Derliaus rinkinio (Yield Dataset) subjektas YieldDataset turi daug atributų. GraphQL leidžia užklausti tik reikiamų laukų, reikšmingai sumažinant užklausos ir atsakymo dydį. Išsamūs kiekvieno atributo paaiškinimai pateikti toliau eilutėse. {% hint style="info" %} Žemiau pažymėti atributai „YieldDataset" yra *gaunami iš metainformacijos* yra neprivalomi. Jie išvedami iš rinkinio metainformacijos, kuri nėra savaime kiekviename YieldDataset. {% endhint %} {% hint style="success" %} Išsamiau apie `geoMaps` atributą YieldDataset galima rasti [čia](/geopard-tutorials/ltu/api-dokumentacija/geo-galiniai-taskai-erdviniu-duomenu-prieigai/wms-gauti-erdviniu-duomenu-sluoksniu-rastrinius-vaizdus/12.-yielddatasetsmap.md). {% endhint %} {% hint style="success" %} Išsamiau apie tai, kaip paleisti Valymą (Clean) ir Kalibravimą (Calibration) YieldDataset, galima rasti [čia](/geopard-tutorials/ltu/api-dokumentacija/geopard-api-uzklausu-apzvalga/84.-mutacija-sukalibruoti-ir-isvalyti-yielddataset.md). {% endhint %} ```graphql { uuid pavadinimas #šablonas „ " Dirbimas (Tillage) number #bendra geofunkcijų (geofeatures) skaičius geometryType #Poligonai arba Taškai totalCoveredArea(unit: HECTARES) #visas geometrijų užimtas plotas (aktualu poligonams) fieldCoverage #lauko procentas, kurį padengia duomenų rinkinys fieldCoveredArea(unit: HECTARES) #geometrijų sąjunga (be dublikatų) attributes fullAttributes { #išsamūs duomenys apie kiekvieną atributą name #nuoroda į statistikos >> atributą transliteratedName fullName #teisingas žmogui suprantamas pavadinimas unit#matavimo vienetai } usedMachines { #naudoti įrenginiai, kurie gaunami iš metainformacijos id serial operatorId } createdDate #objekto sukūrimo data ir laikas GeoPard updatedDate #paskutinio atnaujinimo data ir laikas operationId operationType operationFileDate #bylos sukūrimo data ir laikas gaunami iš metainformacijos operationStartDate #operacijos pradžia gaunama iš metainformacijos statistics { #statistikos pasiskirstymas kiekvienam atributui attribute min max avg mdn var std sum } cropName #pasėlio pavadinimas gaunamas iš metainformacijos cropToken #pasėlio žetonas (didžiosiomis raidėmis) gaunamas iš metainformacijos appliedCorrections #taikytų korekcijų sąrašas nurodyta tvarka appliedCorrectionsVersion #naudotos korekcijų algoritmo versija geoŽemėlapiai { url shortName #prefikso parinktys: raw, thumbnail_raw, processed, thumbnail_processed hexSpalvųKodai klasės } } ``` ## 1. Užklausa getFarms ### Užklausti {% code overflow="wrap" lineNumbers="true" %} ```graphql užklausa GetYieldDatasetsViaGetFarms { getFarms (farmUuids: ["9eecef55-f74f-4099-991a-05cbd976d50a"]) { uuid pavadinimas fields (fieldUuids: ["a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"]) { uuid yieldDatasets { uuid pavadinimas numeris geometryType totalCoveredArea(unit: HECTARES) fieldCoverage fieldCoveredArea(unit: HECTARES) } } } } ``` {% endcode %} ### Atsakymas ```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. Užklausa getFields ### Užklausti {% code overflow="wrap" lineNumbers="true" %} ```graphql užklausa GetYieldDatasetsViaGetFields { getFields (filter: {fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"}) { fields { uuid area(unit: HECTARES) yieldDatasets(yieldDatasetUuids: ["8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8"]) { uuid pavadinimas numeris geometryType totalCoveredArea(unit: HECTARES) fieldCoverage fieldCoveredArea(unit: HECTARES) } } } } ``` {% endcode %} ### Atsakymas ```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. Užklausa getYieldDatasets ### Užklauskite pirmo puslapio ```graphql užklausa GetPaginatedYieldDatasets { getYieldDatasets( filter:{ fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba" puslapioDydis: 2 } ) { yieldDatasets { uuid pavadinimas fieldCoverage fieldCoveredArea(unit: HECTARES) numeris } paskutinisĮvertintasRaktas { SkirsnioRaktas RikiavimoRaktas ŽymosEilutė } } } ``` ### Pirmo puslapio atsakymas ```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 } } } } ``` ### Užklauskite kito puslapio Puslapiavimo parametrus perduodami per `paskutinisĮvertintasRaktas`, naudojant Vertę grąžintą pirmo puslapio atsakyme aukščiau. ```graphql užklausa GetPaginatedYieldDatasets { getYieldDatasets( filter:{ fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba" puslapioDydis: 2 paskutinisĮvertintasRaktas: { PartitionKey: "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba", SortKey: "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380", TagString: null } } ) { yieldDatasets { uuid pavadinimas fieldCoverage fieldCoveredArea(unit: HECTARES) numeris } paskutinisĮvertintasRaktas { SkirsnioRaktas RikiavimoRaktas ŽymosEilutė } } } ``` ### Kito puslapio atsakymas ```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/ltu/api-dokumentacija/geopard-api-uzklausu-apzvalga/16.-uzklausa-gauti-derliausduomenurinkinius.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.