> For the complete documentation index, see [llms.txt](https://docs.geopard.tech/geopard-tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geopard.tech/geopard-tutorials/cze/api-dokumentace/prehled-pozadavku-geopard-api/16.-query-ziskat-datove-sady-vynosu.md). # 16. Query: Získat datové sady výnosů ## Přehled Získejte všechna YieldDataset pro vybrané pole. YieldDataset lze načíst pomocí obecných GraphQL dotazů: 1. `getFarms` použitím kompletní hierarchie Farma > Pole > YieldDataset s jejich filtry 2. `getFields` ze propojeného Pole a hierarchie Pole > YieldDataset 3. getYieldDatasets s širokou škálou filtrů a stránkováním {% hint style="warning" %} Soubory typu "YieldDataset" musí být nahrány předem. {% endhint %} ## Entita Yield Dataset YieldDataset obsahuje mnoho atributů. GraphQL umožňuje načíst pouze požadovaná pole, což významně snižuje velikost požadavku a odpovědi. Podrobné vysvětlení každého atributu je uvedeno níže přímo v textu. {% hint style="info" %} Atributy v "YieldDataset" označené níže jako *pocházející z metainformací* jsou volitelné. Jsou odvozené z metainformací datasetu, které nejsou automaticky obsaženy v každém YieldDataset. {% endhint %} {% hint style="success" %} Podrobnosti o `geoMaps` atributu pro YieldDataset jsou k dispozici [zde](/geopard-tutorials/cze/api-dokumentace/geo-koncove-body-pro-pristup-ke-prostorovym-datum/wms-ziskat-rastrove-obrazky-vrstev-prostorovych-dat/12.-mapa-datovych-sad-vynosu.md). {% endhint %} {% hint style="success" %} Podrobnosti o tom, jak spustit Čištění a Kalibraci pro YieldDataset, jsou k dispozici [zde](/geopard-tutorials/cze/api-dokumentace/prehled-pozadavku-geopard-api/84.-mutation-kalibrovat-a-vycistit-datovou-sadu-vynosu.md). {% endhint %} ```graphql { uuid název #vzor " " Orba number #celkový počet geofeatures geometryType #Polygony nebo Body totalCoveredArea(unit: HECTARES) #celková plocha všech geometrií (relevantní pro polygony) fieldCoverage #procento pole pokryté datasetem fieldCoveredArea(unit: HECTARES) #sjednocení geometrií (bez duplicit) atributů fullAttributes { #úplné informace pro každý atribut name #odkaz na statistiky >> atribut transliteratedName fullName #správný čitelný název unit#jednotky měření } usedMachines { #použité stroje, které pocházejí z metainformací id serial operatorId } createdDate #datum a čas vytvoření entity v GeoPard updatedDate #datum a čas poslední aktualizace operationId operationType operationFileDate #datum a čas vytvoření souboru pocházejí z metainformací operationStartDate #začátek operace pochází z metainformací statistics { #rozdělení statistik pro každý atribut attribute min max avg mdn var std sum } cropName #název plodiny pochází z metainformací cropToken #token plodiny (VELKÝMI PÍSMENY) pochází z metainformací appliedCorrections #seznam použitých korekcí v uvedeném pořadí appliedCorrectionsVersion #verze použitého korekčního algoritmu geoMaps { url shortName #možnosti prefixu: raw, thumbnail_raw, processed, thumbnail_processed hexColorCodes classes } } ``` ## 1. Dotaz getFarms ### Požádat {% code overflow="wrap" lineNumbers="true" %} ```graphql dotaz GetYieldDatasetsViaGetFarms { getFarms (farmUuids: ["9eecef55-f74f-4099-991a-05cbd976d50a"]) { uuid název fields (fieldUuids: ["a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"]) { uuid yieldDatasets { uuid název number geometryType totalCoveredArea(unit: HECTARES) fieldCoverage fieldCoveredArea(unit: HECTARES) } } } } ``` {% endcode %} ### Odpověď ```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. Dotaz getFields ### Požádat {% code overflow="wrap" lineNumbers="true" %} ```graphql dotaz GetYieldDatasetsViaGetFields { getFields (filter: {fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"}) { fields { uuid area(unit: HECTARES) yieldDatasets(yieldDatasetUuids: ["8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8"]) { uuid název number geometryType totalCoveredArea(unit: HECTARES) fieldCoverage fieldCoveredArea(unit: HECTARES) } } } } ``` {% endcode %} ### Odpověď ```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. Dotaz getYieldDatasets ### Požádejte o první stránku ```graphql dotaz GetPaginatedYieldDatasets { getYieldDatasets( filter:{ fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba" velikostStránky: 2 } ) { yieldDatasets { uuid název fieldCoverage fieldCoveredArea(unit: HECTARES) number } posledníVyhodnocenýKlíč { OddílKlíče TřídicíKlíč ŘetězecŠtítku } } } ``` ### Odpověď první stránky ```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 } } } } ``` ### Požádejte o následující stránku Parametry stránkování se předávají přes `posledníVyhodnocenýKlíč`, použitím hodnoty vrácené v odpovědi první stránky výše. ```graphql dotaz GetPaginatedYieldDatasets { getYieldDatasets( filter:{ fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba" velikostStránky: 2 posledníVyhodnocenýKlíč: { PartitionKey: "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba", SortKey: "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380", TagString: null } } ) { yieldDatasets { uuid název fieldCoverage fieldCoveredArea(unit: HECTARES) number } posledníVyhodnocenýKlíč { OddílKlíče TřídicíKlíč ŘetězecŠtítku } } } ``` ### Odpověď následující stránky ```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 This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.geopard.tech/geopard-tutorials/cze/api-dokumentace/prehled-pozadavku-geopard-api/16.-query-ziskat-datove-sady-vynosu.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.