> 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/ukrainian/oglyad-produktu-vebdodatok/import-precision-agriculture-data/yield-data-import.md).

# Імпорт даних врожайності

Імпортуйте дані врожайності збирання в GeoPard для очищення, калібрування, аналітики та зонування.

Щоб завантажити файли даних про фактичне внесення, виберіть **Імпорт даних** і пункт меню **Завантажити файли** . Потім виберіть **Дані врожайності**.

Зверніть увагу на кілька обмежень:

* Підтримуються лише файли shape у системі координат WGS84 (EPSG:4326) із точковими даними або даними на основі полігонів.
* Атрибути мають бути числового типу (ціле число або дійсне число, не рядок).
* Максимальний розмір файлу — 100 МБ.
* Намагайтеся не використовувати спеціальні символи, як-от `%+@` у назвах атрибутів.
* Максимальна кількість атрибутів — 20.
* Кожен архів вважається окремим набором даних (файли \*.shp і \*.dbf обов’язкові).

<figure><img src="https://2650431644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FX8g6FckVhv6XIDCvpskF%2Fimage.png?alt=media&amp;token=857201a5-da76-41fa-9f05-43eb744cb438" alt=""><figcaption><p>Завантаження даних урожайності у форматі Shapefile</p></figcaption></figure>

1. Перетягніть один або кілька наборів даних про врожайність на панель або натисніть кнопку **Огляд** і виберіть набір даних на комп’ютері.
2. Натисніть кнопку **Завантажити** . GeoPard перевірить, чи відповідає файл вимогам, і збереже дані.

Дочекайтеся діалогового вікна підтвердження успішного завантаження набору даних:

<figure><img src="https://lh6.googleusercontent.com/8Dk9Poz900uimyYo-W8XuuMHeauRkDNo6-Klo8ejFsZt0Gd_ktEhXOxALfxZPV7kl86DfkQSJo1X3UvP6Vw9ib1RtSd--3dQ1ZC4gLLoV733quEp7YYbaJMXYrbLC7vZPa3ItCgA" alt=""><figcaption></figcaption></figure>

Набір даних про врожайність буде доступний у дереві в розділі «Дані врожайності» для подальшої роботи, зокрема для створення карт зон.

<figure><img src="https://lh5.googleusercontent.com/mDqfJIosDlhKNvM6JkSd7f6I4zZ_tDAYg2WoubwjEZU5SKh32FDwePQBJc-7zxIGR4wNtzME0Yzmqopdo6YM7zb6jP6Ex6annMrfjWr6ougD0V8hz2f3mn0e9QWFn1HoJKjoiiDM" alt=""><figcaption><p>Завантажений набір даних про врожайність</p></figcaption></figure>

## Врожайність — довідник метаданих і одиниць вимірювання

{% hint style="info" %}
Кожен архів Shapefile **може додатково містити** файл \<filename>-Metadata.json. Масив `DataAttributes` підказує GeoPard, як позначати стовпці та перетворювати їхні одиниці вимірювання. Одиниці вимірювання записують у складеному форматі: t1ha-1 = t·ha⁻¹, km1hr-1 = km·h⁻¹.
{% endhint %}

### Приклад JSON метаданих для файлу збирання врожаю

```json
{
  "Version": "1.0",
  "FarmName": "My Farm",
  "FieldName": "North Field",
  "Operation": "Harvest",
  "CropSeason": 2024,
  "CropToken": "CORN",
  "CropName": "Corn",
  "FieldOperationStartDate": "2024-10-15T07:00:00.000Z",
  "FileCreatedTimeStamp": "2024-10-16T12:00:00.000Z",
  "DataAttributes": [
    { "Name": "VRYIELDMAS", "Unit": "t1ha-1",   "Description": "Dry Mass Yield" },
    { "Name": "VRYIELDVOL", "Unit": "[m3]1ha-1", "Description": "Yield as Volume" },
    { "Name": "Moisture",   "Unit": "prcnt",    "Description": "Grain Moisture" },
    { "Name": "DRYMATTER",  "Unit": "prcnt",    "Description": "Dry Matter" },
    { "Name": "SWATHWIDTH", "Unit": "m",        "Description": "Swath Width" },
    { "Name": "DISTANCE",   "Unit": "m",        "Description": "Distance From Previous Point" },
    { "Name": "VEHICLSPEE", "Unit": "km1hr-1",  "Description": "Vehicle Speed" },
    { "Name": "Elevation",  "Unit": "m",        "Description": "Elevation" },
    { "Name": "Heading",    "Unit": "arcdeg",   "Description": "Machine Heading" }
  ]
}

```

### Стандартні атрибути врожайності

| Назва атрибута         | Опис                                                      | Одиниця    |
| ---------------------- | --------------------------------------------------------- | ---------- |
| VRYIELDMAS             | Урожайність за сухою масою — основне значення урожайності | t1ha-1     |
| VRYIELDVOL             | Об’ємна урожайність (показання датчика комбайна)          | \[m3]1ha-1 |
| Вологість              | Вологість зерна під час збирання                          | prcnt      |
| DRYMATTER              | Вміст сухої речовини (100 − вологість)                    | prcnt      |
| SWATHWIDTH             | Ширина жатки / валка                                      | m          |
| DISTANCE               | Відстань від попередньої зареєстрованої точки             | m          |
| VEHICLSPEE             | Швидкість руху машини                                     | km1hr-1    |
| Висота над рівнем моря | Висота GPS над рівнем моря                                | m          |
| Курс                   | Напрямок руху машини                                      | arcdeg     |
| FUEL                   | Витрата пального                                          | l          |
|                        |                                                           |            |

### Приклади значень CropToken

* CORN
* SOYBEANS
* WHEAT
* SUNFLOWER\_OIL
* CANOLA
* BARLEY
* OATS
* SORGHUM
* COTTON

### Довідник рядків одиниць вимірювання

Рядки одиниць вимірювання для польових робіт

<table><thead><tr><th>Рядок одиниці вимірювання</th><th>Значення</th><th width="251.03369140625">Використовується для</th></tr></thead><tbody><tr><td>t1ha-1</td><td>метрична тонна на гектар</td><td>Урожайність за сухою масою, норма внесення вапна</td></tr><tr><td>[m3]1ha-1</td><td>кубічний метр на гектар</td><td>Об’ємна урожайність (комбайн)</td></tr><tr><td>l1ha-1</td><td>літр на гектар</td><td>Норма внесення рідких добрив / хімікатів</td></tr><tr><td>kg1ha-1</td><td>кілограм на гектар</td><td>Норма внесення сухих / гранульованих добрив</td></tr><tr><td>ha-1</td><td>на гектар</td><td>Норма висіву (насінин/га)</td></tr><tr><td>prcnt</td><td>відсоток (%)</td><td>Вологість, суха речовина</td></tr><tr><td>km1hr-1</td><td>кілометр на годину</td><td>Швидкість руху транспортного засобу, швидкість вітру</td></tr><tr><td>m</td><td>метр</td><td>Ширина захвату, відстань, висота</td></tr><tr><td>cm</td><td>сантиметр</td><td>Глибина садіння</td></tr><tr><td>in</td><td>дюйм</td><td>Глибина садіння (імперські одиниці США)</td></tr><tr><td>l</td><td>літр</td><td>Витрата пального</td></tr><tr><td>C</td><td>градус Цельсія</td><td>Температура повітря, температура ґрунту</td></tr><tr><td>arcdeg</td><td>кутові градуси</td><td>Курс / азимут машини</td></tr><tr><td>bu</td><td>бушелі</td><td>Об’єм урожаю в одиницях США</td></tr><tr><td>bu1ac-1</td><td>бушелі на акр (нестандартна одиниця)</td><td>Урожайність в одиницях США — краще використовувати t1ha-1</td></tr></tbody></table>

#### Правила запису складених одиниць

Множення позначається `1` між токенами: km1hr-1 = km × hr⁻¹

Ділення позначається суфіксом від’ємного степеня `-1`: t1ha-1 = t × ha⁻¹ = t/ha

Для кубічних метрів використовуються дужки: \[m3]1ha-1 = m³/haПроста одиниця (без чисельника): ha-1 = на гектар

Див. [розділ «Карти зон»](https://help.geopard.tech/zones-maps/#soil) щоб дізнатися більше про створення карти зон на основі даних про врожайність.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.geopard.tech/geopard-tutorials/ukrainian/oglyad-produktu-vebdodatok/import-precision-agriculture-data/yield-data-import.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
