# 16. Poizvedba: pridobi YieldDatasets ## 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 {% hint style="warning" %} Niz podatkov "YieldDataset" mora biti naložen vnaprej. {% endhint %} ## 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. {% hint style="info" %} 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. {% endhint %} {% hint style="success" %} Podrobnosti o `geoMaps` attributu za YieldDataset so na voljo [tukaj](/geopard-tutorials/svn/api-dokumentacija/geo-koncne-tocke-za-dostop-do-prostorskih-podatkov/wms-pridobi-rastrske-slike-slojev-prostorskih-podatkov/12.-yielddatasetsmap.md). {% endhint %} {% hint style="success" %} Podrobnosti o tem, kako sprožiti Čiščenje in Kalibracijo za YieldDataset, so na voljo [tukaj](/geopard-tutorials/svn/api-dokumentacija/pregled-zahtevkov-geopard-api/84.-mutacija-umeri-in-ocisti-yielddataset.md). {% endhint %} ```graphql { uuid ime #vzorec " " 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 {% code overflow="wrap" lineNumbers="true" %} ```graphql 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) } } } } ``` {% endcode %} ### Odgovor ```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. Poizvedba getFields ### Zahtevaj {% code overflow="wrap" lineNumbers="true" %} ```graphql 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) } } } } ``` {% endcode %} ### Odgovor ```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. Poizvedba getYieldDatasets ### Zahtevek za prvo stran ```graphql 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 ```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 } } } } ``` ### Zahtevek za naslednjo stran Parametri paginacije se posredujejo preko `zadnjiOcenjeniKljuč`, z uporabo vrednosti, vrnjene v odgovoru prve strani zgoraj. ```graphql 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 ```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/svn/api-dokumentacija/pregled-zahtevkov-geopard-api/16.-poizvedba-pridobi-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.