> 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/it/tour-del-prodotto-app-web/import-precision-agriculture-data/soil-data-shp-with-coordinates.md).

# Dati del suolo (shp, con coordinate)

Importa dati del suolo georeferenziati in formato shapefile per mappatura e analisi agronomica.

## Panoramica

L’analisi chimica del suolo è uno dei livelli di dati più importanti nell’agricoltura. In genere, le informazioni sul suolo provengono da laboratori agrochimici che analizzano campioni di terreno raccolti in campo secondo un approccio a griglia o per zone. Il numero di caratteristiche del suolo presenti in un singolo file può variare da 5-10 macronutrienti, come azoto (N), fosforo (P), potassio (K), capacità di scambio cationico (CEC) e contenuto di sostanza organica del suolo (OM), fino a 40-50 proprietà comprendenti tutti i micronutrienti.

Puoi caricare i file di campionamento del suolo in GeoPard Agriculture e ottenere una mappa di calore facilmente consultabile per ogni attributo contenuto nel file. Inoltre, puoi delineare zone di gestione in base a qualsiasi attributo, confrontarle con altri livelli, come la produttività storica delle colture, e creare file di prescrizione per la fertilizzazione a dose variabile.

## Caricare i dati del suolo

Per caricare i file dei dati del suolo, scegli il menu **Import Data** e la voce **Upload Files** .\
Quindi seleziona **Soil Data**.

Tieni presente che si applicano alcune restrizioni:

* Sono supportati solo shapefile WGS84 (EPSG:4326) con dati basati su punti o poligoni.
* Gli attributi devono essere di tipo numerico (intero o reale, non stringa).
* La dimensione massima del file è 100 MB.
* Cerca di evitare simboli speciali come %+@ nei titoli degli attributi.
* Il numero massimo di attributi è 20.
* Ogni archivio viene trattato come un singolo dataset (i file \*.shp e \*.dbf sono obbligatori).

<figure><img src="https://1371939954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FGKU31qoqUmAk8bQcGMFd%2Fimage.png?alt=media&amp;token=2612d80b-f5e5-4d55-ab2c-ba1a9794d82f" alt=""><figcaption><p>Caricare i dati del suolo come shapefile</p></figcaption></figure>

1. Puoi trascinare uno o più dataset del suolo nel pannello oppure fare clic sul pulsante **Sfoglia** e selezionare un dataset dal tuo computer.
2. Fai clic sul pulsante **Carica** . GeoPard verificherà che il file soddisfi i requisiti e salverà i dati.

Attendi la finestra di conferma per verificare che il dataset sia stato caricato correttamente:

<figure><img src="https://lh6.googleusercontent.com/GUuMs3oG97HGoZZQ2YI3c5Yxzu1b_FmnlCB-7sA7rpcqwn_qam1Bh1chsF0SVKzTHotYU1AT-wg1cfB8OLJbpwXuKn9Y_opGwBGhiuWGHBrHHyPVfxUnpf6B8-h9GFmvfFTghzJ8" alt=""><figcaption><p>Conferma del caricamento</p></figcaption></figure>

Il dataset del suolo sarà disponibile nell’albero, nella sezione Soil Data, per ulteriori operazioni, inclusa la creazione di ZoneMaps.

<figure><img src="https://1371939954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FXZ0IqnhCyWcabxcrwOtS%2Fimage.png?alt=media&amp;token=a55fd0ee-1ad8-49e5-aefa-17122e7573e6" alt=""><figcaption><p>Dataset di campionamento del suolo caricato</p></figcaption></figure>

## Attributi e unità descrittivi

GeoPard supporta <mark style="background-color:yellow;">nomi descrittivi e unità per gli attributi dei dataset del suolo</mark>. Per attivare questa funzionalità, l’archivio caricato deve includere un file aggiuntivo <mark style="background-color:yellow;">JSON</mark> contenente i metadati, denominato `<shapefile_name>-Metadata.json`. Questo file fornisce informazioni su come interpretare le colonne dello shapefile.

<figure><img src="https://1371939954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FTwpgxC8zmNHLwzmvVCp4%2Fimage.png?alt=media&amp;token=ccb28676-8996-4c86-a8e4-cd9b12ef957b" alt="" width="312"><figcaption><p>Struttura dell’archivio: shapefile e file JSON dei metadati</p></figcaption></figure>

### Esempio di file JSON

```json
{
  "Version": "1.0",
  "FarmName": "Farm Name",
  "FieldName": "Field Name",
  "Operation": "SoilSampling",
  "CropSeason": 2022,
  "FieldOperationDate": "2022-08-15T12:58:32.76Z",
  "DataAttributes": [
    {
      "Name": "Id",
      "Description": "Sample Number"
    },
    {
      "Name": "N",
      "Unit": "mg1kg-1",
      "Description": "Mineral Nitrogen"
    },
    {
      "Name": "K2O",
      "Unit": "mg1kg-1",
      "Description": "Exchangeable Potassium"
    },
    {
      "Name": "P2O5",
      "Unit": "mg1kg-1",
      "Description": "Mobile Phosphorus"
    },
    {
      "Name": "pH",
      "Description": "Soil Acidity"
    }
  ]
}
```

Spiegazione della struttura del JSON dei metadati:

* `DataAttributes` contiene i metadati di ogni colonna dello shapefile.
  * `Name`è il nome di una colonna dello shapefile.
  * `Description` è il nome descrittivo dell’attributo.
  * `Unit` è l'unità di misura dell'attributo (vedere la tabella delle unità supportate qui sotto).
* `FieldOperationDate` è la data di raccolta dei dati del suolo.
* `CropSeason` è l'anno della stagione colturale.
* `Operation` è il nome dell'operazione, ad esempio `SoilSampling` oppure `SoilScanning`.

### Unità supportate

| Unità di misura | Descrizione dell'unità             |
| --------------- | ---------------------------------- |
| prcnt           | Percentuale                        |
| prcnt-1         | Per percentuale                    |
| ppm             | Parti per milione                  |
| points          | Punti                              |
| in              | Pollici                            |
| ft              | Piedi                              |
| mm              | Millimetri                         |
| cm              | Centimetri                         |
| m               | Metri                              |
| yd              | Iarde                              |
| mi              | Miglia                             |
| km              | Chilometri                         |
| m2              | Metri quadrati                     |
| ac              | Acri                               |
| ha              | Ettari                             |
| ft2             | Piedi quadrati                     |
| ac-1            | Per acro                           |
| ha-1            | Per ettaro                         |
| kg              | Chilogrammi                        |
| lb              | Libbre                             |
| ton             | Tonnellate                         |
| t               | Tonnellate metriche                |
| cwt             | Quintali                           |
| dg              | Decigrammi                         |
| g               | Grammi                             |
| ozm             | Once (massa)                       |
| kg-1            | Per chilogrammo                    |
| lb-1            | Per libbra                         |
| ton-1           | Per tonnellata                     |
| t-1             | Per tonnellata metrica             |
| cwt-1           | Per quintale                       |
| dg-1            | Per decigrammo                     |
| g-1             | Per grammo                         |
| ozm-1           | Per oncia (massa)                  |
| gal             | Galloni                            |
| igal            | Galloni imperiali                  |
| thsndgal        | Migliaia di galloni                |
| floz            | Once liquide                       |
| pt              | Pinte                              |
| qt              | Quarti                             |
| l               | Litri                              |
| kl              | Chilolitri                         |
| hl              | Ettolitri                          |
| ml              | Millilitri                         |
| ul              | Microlitri                         |
| yd3             | Iarde cubiche                      |
| m3              | Metri cubi                         |
| gal-1           | Per gallone                        |
| igal-1          | Per gallone imperiale              |
| thsndgal-1      | Per mille galloni                  |
| floz-1          | Per oncia fluida                   |
| pt-1            | Per pinta                          |
| qt-1            | Per quarto di gallone              |
| l-1             | Per litro                          |
| kl-1            | Per chilolitro                     |
| hl-1            | Per ettolitro                      |
| ml-1            | Per millilitro                     |
| ul-1            | Per microlitro                     |
| sec             | Secondi                            |
| ms              | Millisecondi                       |
| min             | Minuti                             |
| hr              | Ore                                |
| day             | Giorni                             |
| hr-1            | Per ora                            |
| arcdeg          | Gradi d'arco (direzione)           |
| bu              | Bushel                             |
| bag             | Sacchi (quantità di seme caricata) |
| sack            | Sporte (quantità di seme caricata) |
| container       | Contenitori                        |
| container-1     | Per contenitore                    |
| bu-1            | Per bushel                         |
| bag-1           | Per sacco                          |
| sack-1          | Per sporta                         |
| hz              | Hertz                              |
| rapporto        | Rapporto                           |
| K               | Kelvin (temperatura)               |
| F               | Fahrenheit (temperatura)           |
| C               | Celsius (temperatura)              |

### Esempio di dataset del suolo

Di seguito sono riportate alcune schermate di GeoPard che mostrano come viene applicato il file Metadata.json condiviso in precedenza allo shapefile contenente il dataset del suolo.

<figure><img src="https://1371939954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FhN3CIGfvuhUT9b0wqit0%2Fimage.png?alt=media&amp;token=47631c3d-509e-4154-b257-d08ebc31b589" alt=""><figcaption><p>Dataset del suolo con nomi e unità degli attributi intuitivi</p></figcaption></figure>

<figure><img src="https://1371939954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2FbM2AxbWyHBv9zEoPHXP1%2Fimage.png?alt=media&amp;token=b8fa3206-a6c5-4d46-902d-754eafb14e20" alt=""><figcaption><p>Dataset del suolo con nomi e unità degli attributi intuitivi</p></figcaption></figure>

## Riferimenti aggiuntivi

Consulta [il capitolo Mappe delle zone](https://docs.geopard.tech/geopard-tutorials/it/tour-del-prodotto-app-web/zones-maps-and-analytics.md) per ulteriori dettagli su come creare una ZonesMap utilizzando i dati del suolo.

GeoPard aiuta anche a pianificare correttamente il campionamento zonale del suolo. Puoi pianificare i punti di campionamento del suolo e il percorso in base alle zone pluriennali di GeoPard, che riflettono gli andamenti storici di sviluppo delle colture.


---

# 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/it/tour-del-prodotto-app-web/import-precision-agriculture-data/soil-data-shp-with-coordinates.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.
