# Vector/Raster Data Files

JMap Cloud allows you to create spatial data sources from various vector and raster file formats.

Files can be:

* Uploaded during data source creation
* Selected from previously uploaded files

{% hint style="info" %}
All files must be compressed as `.zip`, except raster files. For more details, see the [Uploading Files](/en/jmap-cloud-portal/user-guide-for-jmap-cloud-portal/integrating-data-data-sources/creating-data-sources/uploading-files.md) section.
{% endhint %}

DS creation is done in several steps.

#### **File Selection**

1. Go to the **Data Sources** tab and click **Create Data Source**.
2. Select **Vector/Raster Data File**.
3. Choose one of the following options:
   * **New file**: to upload a file from your device.
   * **Existing file**: to select a file already present in JMap Cloud.

#### Configuring DS Parameters

The parameters to configure depend on the type and format of the data. See the [Data Source Settings](#file-settings) section for more details.

Then add a description and tags to the DS to facilitate classification and filtering. You can create new tags by typing text in the designated field.

#### Creating the Spatial Data Source

Click **Create** to launch the creation of the spatial data source. It will then appear in the data sources table. Its status will change to **Preparing** during processing, then to **Ready** once complete.

During DS creation, JMap Cloud automatically analyzes the file metadata (format, type, coordinate system, geographic extent, etc.).

For raster data files, the following automated processes are applied at this stage:

* Reprojection of the data to the [EPSG:3857](https://epsg.io/3857) coordinate system.
* Conversion to the optimized [COG](https://cogeo.org/) (Cloud Optimized GeoTIFF) format.
* Creation of a multi-resolution image pyramid for high-performance display and fast navigation.

Once a data source is created from a file, the file is no longer required since the data is transferred to JMap Cloud databases.

{% hint style="info" %}
All uploaded files are automatically deleted after **10 days**.
{% endhint %}

## Data Source Settings

This table details the general parameters to configure when creating a DS from files.

<table data-header-hidden><thead><tr><th width="168"></th><th width="546"></th></tr></thead><tbody><tr><td>Name </td><td>Give a name to the spatial data source. There are no naming restrictions for resources (DS, projects, map layers) in JMap Cloud.</td></tr><tr><td>Layer</td><td>Vector data only<br>Specific to files that contain multiple data layers (GeoPackage, GML, TAB, DWG). Select the layer from which you are creating the DS.</td></tr><tr><td>CRS</td><td>Coordinate Reference System. If JMap Cloud has correctly identified the CRS, this field cannot be modified. Otherwise, select the data's projection system.</td></tr><tr><td>X / Y</td><td><p>Vector data only<br>Specific to CSV format files. Select the field (numeric values) containing the coordinates:</p><ul><li><strong>X</strong>: Longitude field</li><li><strong>Y</strong>: Latitude field</li></ul></td></tr><tr><td>Linking Attribute</td><td>Optional<br>Vector data only<br>Select the attribute used to link the source's elements to documents or <a href="/pages/WWwDeCdThcthSzXHVmhL">attachments</a>, or to establish other types of links. It should generally be unique and non-null. <br><strong>Note:</strong> If the linking attribute is modified after attachments have been added, those attachments will be deleted.</td></tr><tr><td>Attributes</td><td>Vector data only<br>The file attributes are displayed in a table containing the attribute name and type, along with a checkbox to mark attributes to be indexed. <br>Attributes must be indexed to be used in simple searches in JMap NG. When the data source data is edited, indexes are updated automatically. When the data source is deleted, the indexes are deleted.</td></tr><tr><td>Description</td><td>Optional<br>You can add a description of the data source.</td></tr><tr><td>Tags</td><td>Optional<br>You can add tags that can be used to sort or filter DS. Tags are available for use with all resources (DS, projects, layers).</td></tr><tr><td>Share with My Organization</td><td>Optional<br>Check this option to automatically share your data source with organization members. Members will have <strong>View</strong> and <strong>Extract Data</strong> permissions. You can modify these in the Data Source <a href="/pages/HKcddfpuASlPKukD8et5">Permissions</a> section.</td></tr></tbody></table>

{% hint style="info" %}
Only indexed attributes can be used in simple searches (searching for features in project layers based on attribute values) in the JMap NG mapping application.
{% endhint %}


---

# 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.jmapcloud.io/en/jmap-cloud-portal/user-guide-for-jmap-cloud-portal/integrating-data-data-sources/creating-data-sources/vector-raster-data-files.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.