# 16. Query: ottieni YieldDatasets ## Panoramica Recupera tutti i YieldDataset per il Campo selezionato. I YieldDataset possono essere recuperati usando query GraphQL generiche: 1. `getFarms` usando la gerarchia completa Azienda agricola > Campo > YieldDataset con i suoi filtri 2. `getFields` dal Campo collegato e la gerarchia Campo > YieldDataset 3. getYieldDatasets con un'ampia gamma di filtri e paginazione {% hint style="warning" %} Un "YieldDataset" deve essere caricato in anticipo. {% endhint %} ## Entità Yield Dataset YieldDataset include molti attributi. GraphQL ti permette di recuperare solo i campi necessari, riducendo significativamente la dimensione della richiesta e della risposta. Spiegazioni dettagliate per ogni attributo sono fornite inline di seguito. {% hint style="info" %} Attributi nel "YieldDataset" contrassegnati sotto come *provenienti dalla metainformazione* sono opzionali. Sono derivati dalle metainformazioni del dataset, che non sono necessariamente presenti in ogni YieldDataset. {% endhint %} {% hint style="success" %} Dettagli sul `geoMaps` attributo per lo YieldDataset sono disponibili [qui](/geopard-tutorials/it/documentazione-api/endpoint-geo-per-laccesso-ai-dati-spaziali/wms-ottieni-immagini-raster-dei-layer-di-dati-spaziali/12.-yielddatasetsmap.md). {% endhint %} {% hint style="success" %} Dettagli su come attivare Clean e Calibration per lo YieldDataset sono disponibili [qui](/geopard-tutorials/it/documentazione-api/panoramica-delle-richieste-api-geopard/84.-mutation-calibra-e-pulisci-yielddataset.md). {% endhint %} ```graphql { uuid nome #pattern " " Lavorazione del terreno number #numero totale di geofeature geometryType #Poligoni o Punti totalCoveredArea(unit: HECTARES) #area totale di tutte le geometrie (rilevante per Poligoni) fieldCoverage #percentuale del campo coperta dal dataset fieldCoveredArea(unit: HECTARES) #unione delle geometrie (senza duplicati) attributes fullAttributes { #dettagli completi per attributo name #collegamento a statistiche >> attributo transliteratedName fullName #nome leggibile corretto unit#unità di misura } usedMachines { #macchine utilizzate, che provengono dalle metainformazioni id serial operatorId } createdDate #data e ora di creazione dell'entità in GeoPard updatedDate #data e ora dell'ultimo aggiornamento operationId operationType operationFileDate #data e ora di creazione del file provengono dalle metainformazioni operationStartDate #inizio dell'operazione proviene dalle metainformazioni statistics { #distribuzione statistica per ogni attributo attribute min max avg mdn var std sum } cropName #nome della coltura proviene dalle metainformazioni cropToken #token della coltura (in maiuscolo) proviene dalle metainformazioni appliedCorrections #elenco delle correzioni applicate nell'ordine menzionato appliedCorrectionsVersion #versione dell'algoritmo di correzione utilizzato geoMaps { url shortName #opzioni di prefisso: raw, thumbnail_raw, processed, thumbnail_processed hexColorCodes classes } } ``` ## 1. Query getFarms ### Richiedi {% code overflow="wrap" lineNumbers="true" %} ```graphql query GetYieldDatasetsViaGetFarms { getFarms (farmUuids: ["9eecef55-f74f-4099-991a-05cbd976d50a"]) { uuid nome fields (fieldUuids: ["a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"]) { uuid yieldDatasets { uuid nome number geometryType totalCoveredArea(unit: HECTARES) fieldCoverage fieldCoveredArea(unit: HECTARES) } } } } ``` {% endcode %} ### Risposta ```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. Query getFields ### Richiedi {% code overflow="wrap" lineNumbers="true" %} ```graphql query GetYieldDatasetsViaGetFields { getFields (filter: {fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"}) { fields { uuid area(unit: HECTARES) yieldDatasets(yieldDatasetUuids: ["8a97fc98-d6a5-4fb0-bd8d-d50c50b1adb8"]) { uuid nome number geometryType totalCoveredArea(unit: HECTARES) fieldCoverage fieldCoveredArea(unit: HECTARES) } } } } ``` {% endcode %} ### Risposta ```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. Query getYieldDatasets ### Richiedi la Prima Pagina ```graphql query GetPaginatedYieldDatasets { getYieldDatasets( filter:{ fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba" dimensionePagina: 2 } ) { yieldDatasets { uuid nome fieldCoverage fieldCoveredArea(unit: HECTARES) number } ultimaChiaveValutata { ChiavePartizione ChiaveOrdinamento StringaTag } } } ``` ### Risposta della Prima Pagina ```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 } } } } ``` ### Richiedi la Pagina Successiva I parametri di paginazione vengono passati tramite `ultimaChiaveValutata`, usando il valore restituito nella risposta della Prima Pagina sopra. ```graphql query GetPaginatedYieldDatasets { getYieldDatasets( filter:{ fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba" dimensionePagina: 2 ultimaChiaveValutata: { PartitionKey: "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba", SortKey: "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380", TagString: null } } ) { yieldDatasets { uuid nome fieldCoverage fieldCoveredArea(unit: HECTARES) number } ultimaChiaveValutata { ChiavePartizione ChiaveOrdinamento StringaTag } } } ``` ### Risposta della Pagina Successiva ```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/it/documentazione-api/panoramica-delle-richieste-api-geopard/16.-query-ottieni-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.