# 16. Vaicājums: iegūt ražas datu kopas

## Pārskats

Iegūt visus YieldDataset datus izvēlētajam laukumam.&#x20;

YieldDataset datus var iegūt, izmantojot vispārīgus GraphQL vaicājumus:

1. `getFarms` izmantojot pilnu hierarhiju saimniecība > lauks > YieldDataset ar tā filtriem
2. &#x20;`getFields` no saistītā lauka un hierarhijas lauks > YieldDataset
3. getYieldDatasets ar plašu filtru un lapošanas parametru klāstu

{% hint style="warning" %}
Yield Dataset (ražas datu kopu) ir jāaugšupielādē iepriekš.
{% endhint %}

## Yield Dataset entītija

YieldDataset iekļauj daudz atribūtu. GraphQL ļauj pieprasīt tikai nepieciešamās laukas, būtiski samazinot pieprasījuma un atbildes lielumu. Katram atribūtam detalizēti paskaidrojumi ir sniegti zemāk.

{% hint style="info" %}
Atribūti "YieldDataset" iezīmēti zemāk kā *izriet no metainformācijas* ir izvēles. Tie tiek iegūti no datu kopas metainformācijas, kas nav obligāti pieejama katrā YieldDataset.
{% endhint %}

{% hint style="success" %}
Sīkāka informācija par `geoMaps`  atribūtu YieldDataset ir pieejama [šeit](/geopard-tutorials/lva/api-dokumentacija/geo-galapunkti-telpisko-datu-piekluvei/wms-iegut-telpisko-datu-slanu-rastra-attelus/12.-razas-datu-karte.md).
{% endhint %}

{% hint style="success" %}
Sīkāka informācija par to, kā izsaukt tīrīšanu (Clean) un kalibrēšanu (Calibration) YieldDataset, ir pieejama [šeit](/geopard-tutorials/lva/api-dokumentacija/geopard-api-pieprasijumu-parskats/84.-mutacija-kalibret-un-notirit-razas-datu-kopu.md).
{% endhint %}

```graphql
{
  uuid
  nosaukums #paraugs "<OperationType> <YYYY-mm-DD>" Aršanas/Strādāšanas operācija
  number #kopējais ģeofašu skaits
  ģeometrijasTips #poligoni vai punkti
  kopējāPārklātāPlatība(unit: HECTARES) #kopējā visu ģeometriju platība (relevants poligoniem)
  laukumaPārklājums #procenti no lauka, ko sedz datu kopa
  laukumaPārklātāPlatība(unit: HECTARES) #ģeometriju apvienojums (bez dublēšanās)

  attributes
  fullAttributes { #pilnīga informācija par katru atribūtu
    name #saite uz statistiku >> atribūts
    transliteratedName
    pilnaisNosaukums #parezs cilvēkam saprotams nosaukums
    vienība#mērvienības
  }

  izmantotāsMašīnas { #izmantotās mašīnas, kas iegūtas no metainformācijas
    id
    sērijasNumurs
    operatoraId
  } 

  createdDate #entītijas izveides datums un laiks GeoPard
  updatedDate #pēdējā atjauninājuma datums un laiks
  operationId
  operationType
  operācijasFailaDatums #faila izveides datums un laiks, iegūts no metainformācijas 
  operācijasSākumaDatums #operācijas sākums, iegūts no metainformācijas
  
  statistika { #statistikas sadalījums katram atribūtam
    attribute
    min
    max
    avg
    mdn
    var
    std
    sum
  }
  
  kultūraNosaukums #kultūras nosaukums iegūts no metainformācijas
  kultūraTokens #kultūras tokens (Lielajiem burtiem) iegūts no metainformācijas

  piemērotāsKorekcijas #piemēroto korekciju saraksts norādītajā secībā
  piemērotāsKorekcijasVersija #lietotā korekcijas algoritma versija

  geoMaps {
    url
    īsaisNosaukums #prefiksa opcijas: raw, thumbnail_raw, processed, thumbnail_processed
    hexKrāsuKodes
    klases
  } 
}
```

## 1. Vaicājums getFarms

### Pieprasīt

{% code overflow="wrap" lineNumbers="true" %}

```graphql
query GetYieldDatasetsViaGetFarms {
  getFarms (farmUuids: ["9eecef55-f74f-4099-991a-05cbd976d50a"]) {
    uuid
    nosaukums
    fields (fieldUuids: ["a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"]) {
      uuid
      yieldDatasets {
        uuid
        nosaukums
        numurs
        geometryType
        totalCoveredArea(unit: HECTARES)
        fieldCoverage
        fieldCoveredArea(unit: HECTARES)
      }
    }
  }
}
```

{% endcode %}

### Atbilde

```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. Vaicājums getFields

### Pieprasīt

{% 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
        nosaukums
        numurs
        geometryType
        totalCoveredArea(unit: HECTARES)
        fieldCoverage
        fieldCoveredArea(unit: HECTARES)
      }
    }
  }
}
```

{% endcode %}

### Atbilde

```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. Vaicājums getYieldDatasets

### Pieprasīt pirmo lapu

```graphql
query GetPaginatedYieldDatasets {
    getYieldDatasets(
        filtrs:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            lappušuIzmērs: 2
        }
    ) {
        yieldDatasets {
            uuid
            nosaukums
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            numurs
        }
        pēdējāNovērtētāAtslēga {
            SadalījumaAtslēga
            KārtošanasAtslēga
            BirkuVirkne
        }
    }
}
```

### Pirmās lapas atbilde

```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
      }
    }
  }
}
```

### Pieprasīt nākamo lapu

Lapošanas parametrus nodod, izmantojot `pēdējāNovērtētāAtslēga`, izmantojot vērtību, kas atgriezta pirmās lapas atbildē iepriekš.

```graphql
query GetPaginatedYieldDatasets {
    getYieldDatasets(
        filtrs:{
            fieldUuid: "a050fc6f-1df8-4997-ae5b-5d0afa03a1ba"
            lappušuIzmērs: 2
            pēdējāNovērtētāAtslēga: {
                PartitionKey: "FIELD-a050fc6f-1df8-4997-ae5b-5d0afa03a1ba",
                SortKey: "YVDATA-2b4fbd15-c961-49c8-8cc2-3031397d0380",
                TagString: null
            }
        }
    ) {
        yieldDatasets {
            uuid
            nosaukums
            fieldCoverage
            fieldCoveredArea(unit: HECTARES)
            numurs
        }
        pēdējāNovērtētāAtslēga {
            SadalījumaAtslēga
            KārtošanasAtslēga
            BirkuVirkne
        }
    }
}
```

### Nākamās lapas atbilde

```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/lva/api-dokumentacija/geopard-api-pieprasijumu-parskats/16.-vaicajums-iegut-razas-datu-kopas.md?ask=<question>
```

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.
