The first step in the workflow that leads to map distribution is connecting JMap Cloud to spatial data through the creation of Spatial Data Sources (SDS).

In the context of JMap Cloud, a spatial data source is any source that provides spatially referenced data.

JMap Cloud allows you to create SDS from vector or raster data files, WMS/WMTS services, vector tile services and feature services.

Vector and raster SDS can also be created from JMap Server when a JMap Server administrator synchronizes data sources, layers, or entire projects from a JMap Server to JMap Cloud. The details of this synchronization are presented in the JMap Server Administrator Manual.

The Spatial data sources section of JMap Cloud Portal provides functionality for uploading files to create data sources as well as directly creating spatial data sources from new files and data services.

These spatial data sources are subsequently available to create project map layers.

You can create spatial data sources (SDS) from four types of data sources:

• Vector or raster data files: different formats are supported (SHP, CSV, GML, GeoJSON, FileGeoDB, GeoPackage, DWG, Tab, GeoTIFF).

• WMS/WMTS Services

• Vector Tiling Services

• Feature Services

The Data sources tab contains functions for creating and managing spatial data sources that you will use in your projects.

This section presents a table of the SDS of which you are the owner and the sources of the data for which you have access permissions. See the Permissions section for details on access and management of resources.

Each data source is a row in the table, and the columns show the attributes: source type, status, CRS (coordinate reference system), labels, and last modification date.

Creating a spatial data source

To create a SDS click on Create a spatial data source. The drop-down menu allows you to select the source type: Data File, WMS/WMTS Service, Vector Tile Service, Feature Service.

The following steps depend on the type of data source.

You can edit data from a vector spatial data source. The procedure allows you to modify the file or web service that provides spatial data to the SDS.

1. Select Update data to open the interface which allows you to select a new file or an already existing file in JMap Cloud or, in the case of a web service, to reconfigure the connection request to the service. If the file is not a recognized vector file, the file is refused and this message is displayed: This file is not compatible with the data source. The current SDS name, SCR, description and labels are displayed in the interface and you can keep them as is or change them. The attributes of the new file are displayed, and you can index attributes for easier searches. You must complete certain settings, depending on the file format. The settings are detailed in the Data Files section. A new spatial table is created with the new data, and the new table is associated with the existing data source. The old spatial table is deleted.

2. Save. When the changes are completed the status of the SDS becomes Ready. If the SCR of the new file is not the same as the SCR you selected for the SDS, the data is not displayed in the map when you press Display Info.

JMap Cloud creates spatial data sources (SDS) from multiple vector and raster data file formats: CSV, KML, DXF, DWG, SHP, TAB, GeoPackage, FileGeoDatabase, GeoJSON, GeoTIFF.

Files can be uploaded when creating a spatial data source or uploaded in advance. For more information, see the Upload Files section.

An SDS can include multiple vector or raster data files that form a continuous map. For example, a common CAD practice is to separate the territory into rectangular tiles. By reading all tile files together, JMap Cloud can recreate continuous maps as long as the files contain the same data structure (geometry, layers and attribute types). In these cases, the different files that will be used to create the SDS must be combined in the same .zip format file.

Creating an SDS from vector data files involves the steps of uploading the files to JMap Cloud, analyzing the metadata, validating and completing the SDS parameters. When you complete the creation of the SDS, the data and its configuration are copied into the JMap Cloud databases.

In the case of creating an SDS from raster data files, these are uploaded to JMap Cloud, their characteristics are analyzed and validated and when you complete the creation of the SDS several processes are carried out:

• Data is reprojected to the reference coordinate system EPSG:3857

• Data is converted to COG optimized format

• A pyramid of internal resolution images is created to optimize the display of data

This image, optimized for easy display and navigation, is stored in JMap Cloud.

Creating a SDS from files

1. On the Data sources tab, click on Create a spatial data source.

2. Select Data file. The selection interface offers two choices: New File, to upload a data file to JMap Cloud and Existing File, to select files that are already on JMap Cloud. See Uploading Files for more information.

3. If you are creating the data source from a new file, in the New File tab select the data file to upload. Because typically a vector spatial dataset is made up of multiple files, you must combine them into a single .zip format file. Compression is not necessary for uploading raster data files unless you want to upload multiple files that will make up a mosaic dataset. In this case you must combine them in a single .zip format file. If you are creating the data source from files that already exist on JMap Cloud, select them in the Existing File tab.

4. Configure the SDS settings. When you select a new file, before displaying the settings configuration window JMap Cloud analyzes the file's metadata in order to identify the format, the type of data it contains, it coordinate reference system (CRS), geographic extent and other metadata. When you select an existing file, JMap Cloud has already performed this analysis (and the conversion in the case of raster type files) and the configuration window is displayed directly. The settings to configure vary depending on the data type format. The File settings section details them.

5. Add a description of the SDS and tags that may be useful for filtering data sources. You can create new labels by entering the text in the Tags field.

6. Click on Create. The new SDS is displayed in the table. Its status is Preparing while the creation is completed. Subsequently the status is Ready.

The files that you upload when creating an SDS are displayed in the table in the Files tab. After a period of 10 days the files are automatically deleted from JMap Cloud.

File settings

The table shows the general settings to configure when creating an SDS from files.

Web Map Service (WMS) and Web Map Tile Service (WMTS) are two standards proposed by the Open Geospatial Consortium (OGC) that determine how client applications should make requests to obtain maps from a server compatible with WMS or WMTS respectively.

WMS-compatible servers use the HTTP protocol and the returned maps are usually images in popular formats (PNG, GIF, JPEG, etc.). WMS server capabilities are published in an XML document that specifies the types of queries supported as well as metadata (lists of layers, supported projections, etc.).

WMTS-compatible servers allow you to obtain map data in the form of predefined tiles from a data server.

JMap Cloud can query servers compatible with both standards in order to create spatial data sources.

The settings you need to complete are as follows:

The table presents the different statuses that can have a spatial data source.

To delete an SDS:

1. Click on Delete. A message asks you to validate your choice.

2. Press OK to delete the spatial data source. All the SDS configuration is deleted.

Coming soon.

Coming soon.

You can upload files to JMap Cloud to later use them to create spatial data sources. The Files tab in the Spatial data Sources section provides functionality for uploading and managing files.

Data from the files you upload is stored in JMap Cloud databases. Files in the Files table are automatically deleted after a period of 10 days.

Files tab

This tab shows a table of files you have uploaded. A button allows you to upload new files.

The table contains the file name, file data type (vector or raster), format (CSV, KML, DXF, DWG, SHP, TAB, GeoPackage, FileGeoDatabase, GeoJSON, GeoTIFF), size, status and the date of upload. Multiple files can have the same name.

You can select one or more files in the table by checking them and the Delete function becomes available. This allows you to delete multiple files at once.

Uploading a new file

Since a vector spatial dataset typically consists of multiple files, you must combine them into a single file in compressed .zip format.

Compression is not necessary for uploading raster data files, unless you want to upload multiple files that will make up a mosaic, in which case you must combine them into a single .zip format file.

1. Drag and drop one or more files to upload directly into the board. The upload begins automatically.

OR

1. Click on Upload file to open the file explorer.

2. Select the files to upload. The upload begins automatically.

In both cases, the files are displayed in the table and messages indicate the upload progress.

Status of a file

The status of each file indicates which step of the process was completed by JMap Cloud.

Managing a file

Like other resources, to manage a file:

Create a spatial data source

1. Click on Create source. This function is available when the file status is Analyzed. The interface for creating a data source opens.

2. Enter the information to create the data source. Details are offered in the Data Files section.

3. Click on Create. The data source is created and displayed in the table on the Data Sources tab.

Pause upload

This function is available when the file is being uploaded or analyzed and allows you to stop the current process.

Display information

1. Click on Display informations. The interface displays the following information: file name, size, format, status, user ID of the user who uploaded it, date and time of upload and metadata. Metadata includes in addition to the above information, the unique identifier of the file, organization and task; the name of the data layers, the name and type of each attribute, the number of elements.

Delete a file

1. Click on Delete. A message asks you to validate your choice.

The deleted file disappears from the table. The spatial data source created from the file is not affected.

You can access several functions from the menu of a spatial data source: view information, modify its configuration, update the data or delete it.

To display and edit SDS information:

1. Select Display information. The interface displays SDS data in a map that you can navigate. The dotted box indicates the extent of the data source. The base map comes from OpenStreetMap. The elements of the SDS are progressively loaded into the map up to a maximum of 50,000 elements. When the maximum number is reached, the other elements are not loaded. Digital elevation models (DEMs) from geoTIFF files are displayed in shades of gray. Other parameters displayed are: the unique identifier of the SDS in JMap Cloud, the coordinate reference system (CRS), the number of elements loaded, tags, description and a table with attributes.
2. Click on to copy the unique identifier of the data source to the clipboard.

3. When you hover over the Description, Tags, Unique identifier settings as well as Indexed heading of the attribute table , the icon is displayed allowing setting edition.

4. Click on or on to save or discard changes.

You can add access permissions to vector and raster spatial data sources (SDS) that you own.

You can grant permissions to members of your organization who hold the Editor and Viewer roles. Each role has different permissions.

Granting permissions

To grant permissions to a SDS:

1. Click on and then on Permissions. The permissions configuration interface opens displaying the members with the permissions each has.

2. To grant permissions to a member, open the Add member drop-down list.

3. Select the member you are interested in. Their name along with a letter that indicates their role appears in the Add member field. You can clear the selection by clicking .

4. Select the other members you want to add, one at a time. Their names appear in the Add member field. You can clear the selection by pressing .

5. Once members are selected, click on to add the members. These are displayed in the permissions table.

6. Check the permissions you want to grant to each member.

Modifying permissions

You can modify the permissions granted to members, grant permissions to new members, or remove all permissions from one or more members.

2. Change the permissions by checking or unchecking the relevant boxes. Résultat de traduction

   To remove all permissions from a member, you must first uncheck the permissions at the top of the hierarchy. When you uncheck the Owner permission box, Modify automatically becomes the most important permission. To remove the View permission when associated with Viewer type permissions, you must uncheck those first.