> 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/tr/urun-turu-web-uygulamasi/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-import.md).

# Toprak Laboratuvarı sonuçları (CSV/Excel) - Akıllı İçe Aktarma

GeoPard Agriculture, otomatik akıllı içe aktarma ile toprak laboratuvarı sonuç formatı karmaşasını gerçekten “çözen” ilk platformdur.

## Genel Bakış

Toprak laboratuvarı dosyalarında farklı şablonlar, diller, sütun adları ve birimler kullanılabilir. Smart Import, analiz sonuç tablosunu belirler ve analiz için örnekleme noktalarıyla eşleştirir.

<figure><img src="https://4027984477-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fq4l9jRvhxTwmgtYiLmLe%2Fsoil_lab_results_import.jpeg?alt=media&amp;token=836b5fde-4943-473d-b13a-321e5b9c1fd6" alt="Automated parsing of csv/excel soil lab results"><figcaption><p>CSV/Excel toprak laboratuvarı sonuçlarının otomatik ayrıştırılması</p></figcaption></figure>

## Desteklenen dosyalar

* CSV (`.csv`)
* Excel (`.xls`, `.xlsx`), birden fazla sayfa içeren çalışma kitapları dâhil
* Yükleme başına birden fazla dosya; dosya başına en fazla 40 MB

### Toprak laboratuvarı sonuçları için Excel şablonları

{% file src="/files/3815849a47075769b9eb1bbd40a13ccd8e70c8f6" %}

{% file src="/files/80cd15fb5eddc3ae953bc25c71a82968b4459dca" %}

{% file src="/files/a9e31f6d631aee51ce2e47d078e6d4ca5705a7fa" %}

{% file src="/files/0326dca695a855f46ae23f473f4ee44b4fb07ad8" %}

Bu çalışma kitaplarını kullanarak **yönetim bölgesine göre bileşik sonuçlar hazırlayın**. Her satır bir bölge sonucunu temsil eder. Değerler örnek amaçlıdır ve gübre önerisi değildir.

* `geopard-lab-results-zones-plan-id-en.xlsx`: İngilizce başlıklar; bölgeleri şu alanlar üzerinden eşleştirir: **Plan ID** ve **Zone ID**.
* `geopard-lab-results-zones-plan-id-ua.xlsx`: Ukraynaca başlıklar; bölgeleri şu alanlar üzerinden eşleştirir: **ID плану** ve **ID зони**.
* `geopard-lab-results-zones-field-name-en.xlsx`: İngilizce başlıklar; bölgeleri şu alanlar üzerinden eşleştirir: **Field name** ve **Zone ID**.
* `geopard-lab-results-zones-field-name-ua.xlsx`: Ukraynaca başlıklar; bölgeleri şu alanlar üzerinden eşleştirir: **Назва поля** ve **ID зони**.

#### Doğru şablonu seçin

Numuneler bir GeoPard örnekleme planından alındıysa **Plan ID** şablonunu kullanın. Bu, en güvenilir seçenektir. Plan tanımlayıcısını ve bölge veya nokta tanımlayıcısını planda kullanıldığı biçimiyle aynen girin.

GeoPard plan tanımlayıcısı yoksa **Field name** şablonunu kullanın. Tarla adını GeoPard'da göründüğü biçimiyle aynen girin. Bölge tanımlayıcıları o tarladaki bölgelerle eşleşmelidir.

Aynı dosyada Plan ID ve Field name eşleştirmelerini birlikte kullanmayın. Bölge sonuçlarını ve nokta sonuçlarını ayrı dosyalarda tutun. Laboratuvar numuneleri teslim aldıktan sonra anahtar sütunlardaki değerleri değiştirmeyin.

#### Çalışma kitabını doldurun

1. İlk satırı sütun başlıkları olarak koruyun. Başlık hücrelerini birleştirmeyin.
2. Örneklenen her bölge veya nokta için bir satır ekleyin. Birden fazla bölgeyi veya noktayı tek satırda birleştirmeyin.
3. Plan ID **Zone ID** + **Point ID**, **Zone ID** + **, veya**Field name **, ayrı sütunlarda bulunmalıdır.** + **Point ID**Her sonucu kendi besin öğesi veya toprak özelliği sütununa girin. Bildirilen birimleri sütun başlığında koruyun.
4. pH, organik madde, azot, fosfor, potasyum, kükürt, çinko ve bor değerlerini ilgili sütunlarda tutun. Laboratuvarın bildirmediği sonuçları boş bırakın.
5. Çalışma kitabındaki sonuç tablosunun yapısını koruyun. Tabloya toplamlar, yorumlar veya ek tablolar eklemeyin.
6. Şablonlardaki değerler yalnızca örnektir. İçe aktarılan sonuçları agronomik bir kararda kullanmadan önce laboratuvar yöntemini, örnekleme derinliğini, özellikleri ve birimleri doğrulayın.

Nokta örnekleme sonuçları

#### GeoPard örnekleme planından alınan

{% file src="/files/47fdfaf2e49d2cfd2b06cf078b30616392da3721" %}

{% file src="/files/e8ebaccae40462e2dd3ca192f3d01038e7aa4a7e" %}

karot numuneleri **için bu çalışma kitaplarını kullanın**. Her satır, örneklenen bir noktayı temsil eder.

* `geopard-lab-results-points-plan-id-en.xlsx`: İngilizce başlıklar; noktalar şu alanlar üzerinden eşleştirilir: **Plan Kimliği** ve **Nokta Kimliği**.
* `geopard-lab-results-points-plan-id-ua.xlsx`: Ukraynaca başlıklar; noktalar şu alanlar üzerinden eşleştirilir: **Plan Kimliği** ve **Nokta Kimliği**.

Nokta Kimliğini, nokta etiketinde yazdığı şekilde tam olarak girin. Örnek:

```csv
Plan Kimliği,Nokta Kimliği,pH KCl,Organik madde (%),P2O5 (mg/kg),K2O (mg/kg)
Z7D2F58,1,6.5,3.4,183,148
Z7D2F58,2,6.2,3.4,195,77
Z7D2F58,3,6.4,2.4,149,112
```

GeoPard planı olmadan örneklenen noktalar için bunun yerine `Lon` ve `Lat` sütunlarını sağlayın. GeoPard, her noktayı tarla sınırları içinde kaldığında eşleştirir. Yüklemeden önce koordinat eşlemesini gözden geçirin.

{% hint style="warning" %}
İçe aktarılan toprak sonuçları ölçümlerdir; uygulama önerileri değildir. İçe aktarma önizlemesinde her özelliği ve ölçü birimini doğrulayın.
{% endhint %}

## Otomatik olarak neler yapılır?

* Standart dışı düzenler dâhil olmak üzere sonuç tablosunu ve başlıklarını bulur.
* Yaygın laboratuvar özellik adlarını farklı dillerde tanır.
* Makro ve mikro besin maddelerini algılar, ardından düzenlenebilir bir eşleme önizlemesi oluşturur.
* Birimleri algılar ve standartlaştırır; alışılmadık veya karışık birimleri işaretler.
* Örnekleri, GeoPard örnekleme planı veya dosyadaki konumsal veriler üzerinden eşleştirir.

## CSV veya Excel dosyası hazırlama

Her laboratuvar sonucu için bir satır kullanın. Bir başlık satırı ekleyin. Her ölçümü ayrı bir sütunda tutun.

Excel çalışma kitabındaki sonuç tablolarını birbirinden açıkça ayrılmış biçimde tutun. GeoPard, birden fazla sayfa içeren çalışma kitaplarını destekler. Yüklemeden önce algılanan başlıkları, eşlemeleri ve birimleri gözden geçirin.

### Örnek: bölgesel kompozit numuneler

Laboratuvarın GeoPard'da oluşturulmuş bir plan alması durumunda bu yapıyı kullanın. `Sampling Plan ID` ve `Zone ID` en güvenilir eşleşmeyi sağlar.

```csv
Sampling Plan ID,Zone ID,pH,Organic Matter,P,K
Z4B7C21,1,6.4,3.1,18,142
Z4B7C21,2,6.1,2.7,12,118
```

Yukarıdaki değerler ve özellikler örnektir. Laboratuvarın bildirdiği birimleri kullanın. Önizlemede eşlenen her birimi doğrulayın.

### Örnek: GeoPard planından alınan karot numuneleri

Laboratuvarın GeoPard'da oluşturulmuş bir plandan karot numuneleri alması durumunda bu yapıyı kullanın. `Sampling Plan ID` ve `Point ID` en güvenilir eşleşmeyi sağlar. Point ID, numune etiketinde yazan nokta adıdır.

```csv
Sampling Plan ID,Point ID,pH,Organic Matter,P,K
Z7D2F58,1,6.5,3.4,24,148
Z7D2F58,2,6.2,3.4,27,77
Z7D2F58,3,6.4,2.4,19,112
```

Örneklenen her nokta için bir satır kullanın. Bir satırda birden fazla noktayı birleştirmeyin.

### Örnek: koordinatlı karot numuneleri

GeoPard planı olmadan alınan karot numuneleri için boylam ve enlem kullanın. GeoPard, her noktayı tarla sınırlarının içinde kalması durumunda eşleştirir.

```csv
Sample ID,Lon,Lat,pH,Organic Matter
CORE-001,10.123456,50.123456,6.4,3.1
CORE-002,10.124010,50.123780,6.2,2.8
```

Şunların sırasını değiştirmeyin: `Lon` ve `Lat`.

### Örnek: tarlaya göre sonuçlar

Kullanın `Tarla Adı` veya `Tarla Kimliği` laboratuvar dosyanız tarlayı tanımlıyorsa. Tarla adının GeoPard’daki tarla adıyla eşleştiğini kontrol edin.

```csv
Tarla Adı,Numune Kimliği,pH,Organik Madde
Kuzey Tarlası,LAB-1001,6.3,3.0
Kuzey Tarlası,LAB-1002,6.5,3.2
```

`Tarla Kimliği` GeoPard tarla UUID’sidir. Bunu tarla sayfasının URL’sinde bulabilirsiniz.

## GeoPard laboratuvar sonuçlarını tarlalarla nasıl eşleştirir?

GeoPard, laboratuvar sonuçlarını doğru tarla ile dört şekilde eşleştirebilir:

1. **Örnekleme Planı Kimliği ile Bölge Kimliği veya Nokta Kimliği**\
   Benzersiz Örnekleme Planı Kimliği için ayrı bir sütun ve Bölge Kimliği (bileşik numuneler) ya da Nokta Kimliği (karot numuneleri) için ayrı bir sütun kullanın. Bu, GeoPard’da oluşturulan tüm örnekleme planları için en güvenilir seçenektir.
2. **Nokta koordinatları (`Boylam` / `Enlem`)**\
   Boylam ve enlem için iki sütun kullanın. Nokta tarla sınırları içinde kaldığında GeoPard, noktayı konumsal olarak eşleştirir. Bu yöntemi GeoPard planı olmadan alınan karot numuneleri için kullanın.
3. **WKT geometrisi**\
   WKT geometrisi için tek bir sütun kullanın. GeoPard, geometriyi tarla sınırıyla konumsal olarak eşleştirir.
4. **Tarla Adı / Tarla Kimliği**\
   Tarla adı veya tarla kimliğini içeren bir metin sütunu kullanın. GeoPard, tarla adını tarla `Adı`.\
   `Tarla Kimliği` GeoPard tarla UUID’sidir. Bunu tarla sayfasının URL’sinde bulabilirsiniz.

## Dosyayı içe aktarın

1. Açın **Verileri İçe Aktar** → **Dosyaları Yükle** → **Laboratuvar Sonuçları**.
2. CSV, XLS veya XLSX dosyasını yükleyin.
3. Varsa bir tarla veya örnekleme planı seçin. İlgili tarihleri ekleyin.
4. Algılanan tabloyu, öznitelik eşlemesini ve birimleri gözden geçirin.
5. Laboratuvar raporuyla eşleşmeyen eşlemeleri veya birimleri düzeltin.
6. Seçin **Yükle**.

{% hint style="warning" %}
İçe aktarılan değerleri uygulama önerileri olarak değerlendirmeyin. Tarımsal bir karar vermeden önce eşlenen öznitelikleri, birimleri, numune alma derinliğini ve laboratuvar yöntemini gözden geçirin.
{% endhint %}

## Örnekleme planlarına bağlayın

Bölgesel bileşik numuneler için planı şu platformda oluşturun: [Toprak Örnekleme - Otomatik Planlama](https://docs.geopard.tech/geopard-tutorials/tr/urun-turu-web-uygulamasi/soil-sampling-automated-planning.md) ve plan ile bölge kimliklerini laboratuvar dosyasında koruyun. Karot numuneleri için plan ve nokta kimliklerini koruyun ya da koordinatları ekleyin.

Bu sayede laboratuvar sonucu, tarla konumu ve gelecekteki toprak eğilimi analizleri arasındaki bağlantı korunur.


---

# 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/tr/urun-turu-web-uygulamasi/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-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.
