Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Coming soon.
Coming soon.
You can create data sources (DS) from five types of support:
Vector or raster data files: Various formats are supported (SHP, CSV, GML, GeoJSON, FileGeoDB, GeoPackage, DWG, TAB, GeoTIFF)
Non-spatial tabular data files
WMS/WMTS services
Vector tile services
Feature services
The Data sources tab allows you to create and manage the data sources you will use in your projects.
This section displays a table listing the data sources you own, as well as those you have permission to access. For more details on access and resource management, see the section.
Each data source appears as a row in the table. The columns provide the following information:
Name of the data source
Source type
Status
CRS (Coordinate Reference System)
To create a new data source, click the Create a data source button. A dropdown menu will allow you to select the source type:
Vector/Raster data file
Tabular data file (non-spatial)
WMS/WMTS service
Vector tile service
The following steps will vary depending on the selected source type.
The first step in the map‑publishing workflow is to connect JMap Cloud to your data by creating data sources (DS).
A data source is any service or file that provides information to JMap Cloud, including:
Spatial data (vector or raster)
Non‑spatial tabular data
JMap Cloud supports several types of data sources:
You can update the data of a vector/raster spatial data source or a non-spatial data source. This process allows you to replace the file that provides data to the data source (DS).
1. Open the Update Interface
Select the Update Data function to access the interface where you can:
upload a new file,
select an existing file already stored in JMap Cloud.
Spatial DS
Vector files (GeoJSON, Shapefile, etc.)
Raster files (e.g., GeoTIFF)
WMS / WMTS services
Vector tile services
Feature services (OGC)
Non‑spatial DS
CSV files
Synchronization with JMap Server A JMap Server administrator can synchronize data sources, layers, or even entire projects from a JMap Server instance into JMap Cloud. For more details, see the JMap Server Administrator Manual.
In the Data Sources section of JMap Cloud Portal, you have tools to:
Upload files (vector, raster, or CSV) to create new data sources.
Configure direct connections to external data services (WMS, WMTS, vector tiles, feature services).
Once created, these data sources are immediately available for creating map layers and tables within your projects.
If the selected file is not compatible with the existing data source, an error message will appear.
2. View and Edit Information
The interface displays the current properties of the data source:
Name,
Coordinate Reference System (CRS) (for spatial DS),
Description,
Tags.
You can keep these values as they are or update them as needed.
3. Review and Configure Attributes
The attributes of the new file are shown. You can index specific attributes to facilitate searches. Depending on the file format, some additional parameters must be completed. These are explained in the spatial data file and tabular data file sections.
A new table is created in JMap Cloud with the updated data. The previous table is automatically deleted.
4. Finalize the Update
Click Save. Once the changes are applied, the status of the data source is updated to Ready.
If the CRS of the new file is different from the one configured for the data source, the data will not be displayed on the map when using the View Information function.
5. Impact on Map Layers
The new file may differ from the original in terms of format, CRS, geometries, or attributes. In such cases, you will need to update the configuration of the map layers that use this data source.
Number of features (for vector and tabular data sources)
Tags
Last modified date
To delete a data source:
Select the Delete option from the DS menu.
A confirmation message will appear, listing any map layers or project tables that use this data source.
Click OK to confirm and delete the data source.
The original data file used to create the DS is not deleted. It will remain available in the Files tab for 10 days, after which it will be automatically removed from JMap Cloud.
Web Map Service (WMS) and Web Map Tile Service (WMTS) are two standards defined by the Open Geospatial Consortium (OGC). They specify how applications should send requests to obtain maps from compatible servers.
WMS servers use the HTTP protocol to return map images in common raster formats such as PNG, JPEG, or GIF.
Server capabilities are described in an XML document that outlines the supported request types, available layers, supported projections, and other metadata.
WMTS servers, on the other hand, deliver maps as predefined tiles, enabling faster and more efficient rendering, particularly for large-scale navigation.
JMap Cloud can query servers that comply with either the WMS or WMTS standard to create spatial data sources, allowing you to integrate external map layers into your projects.
The settings you need to complete are as follows:
You can access several functions from a data source's menu : view its information, edit its configuration, update the data, manage permissions, or delete the source.
The following sections provide detailed descriptions of each function.
The table presents the different statuses that can have a spatial data source.
Name
Give the DS a name. There are no restrictions for the name of resources (DS, projects, map layers) in JMap Cloud.
GetCapabilities URL
Enter the GetCapabilities URL which will return the capabilities of the WMS or WMTS server. The URL must use the https:// protocol, otherwise an error message is displayed. The URL should look like this: For a WMS compatible server: https://www.server.com/wms?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities
For a WMTS compatible server: https://www.server.com/wmts?SERVICE=WMTS&VERSION=1.0.0&REQUEST=GetCapabilities
Description
Optional. You can add a description of the data source.
Tags
Optional. You can add labels that can be used to sort or filter DS. You can create them by writing text in the box. Tags are available for use with all resources (DS, projects, layers).
Ready
The spatial data source is ready to use.
Error
Indicates an error in one of the steps of creating or updating the DS. Through the menu you can update the SD to fix the error.
Uploading
Files only. The file is being uploaded to JMap Cloud.
Analyzing
Files only. The file is being analyzed. JMap Cloud detects file characteristics such as file type, CRS, attributes, etc.
Analyzed
Files only. The file has been analyzed and its characteristics must be validated by you.
Preparing
Files only. Once the file characteristics have been validated and the data source parameters have been completed, the data is loaded into the JMap Cloud databases.
Processing
The data source is being updated.
Creating a data source is done in several steps:
1. File selection
In the Data Sources tab, click on Create a data source.
Select the Tabular data file (non spatial) option.
Choose between:
New File: to upload a file from your local device.
Existing File: to select a file already stored on JMap Cloud. For more details, refer to the section.
If you choose New File, go to the corresponding tab and select the file to upload. Only one CSV file, compressed as a .zip, can be uploaded.
If you select Existing File, choose the desired file from those already available in JMap Cloud.
2. Uploading
When uploading a new file, JMap Cloud automatically analyzes its metadata (format, structure, data types, etc.) before displaying the configuration window.
If you choose an existing file, the analysis has already been completed and the configuration window opens immediately.
3. Configuring DS Parameters
For details on the configurable options, refer to the File settings section.
You may also add a description and tags to help filter and organize your data sources. To create new tags, simply type them into the Tags field.
4. Finalizing the DS
Click Create to launch the process. The new data source will appear in the list. Its status will first display as Preparing, then switch to Ready once the process is complete.
Once a data source is created for a file, the file is no longer required as the data is transferred to the JMap Cloud databases. All uploaded files are automatically deleted after 10 days.
The table shows the general settings to configure when creating an DS from tabular data files.
Name
Give the DS a name. There are no restrictions for the name of resources (DS, projects, map layers) in JMap Cloud.
Description
Optional. You can add a description of the data source.
Unique identifier
Optional. Select the field that contains the unique identifier of each table register. This identifier is necessary when you want to establish links with other data sources.
Tags
Optional. You can add labels that can be used to sort or filter DS. Tags are available for use with all resources (DS, projects, layers).
Fields
The fields in the file are presented in a table that contains the name and data type of each field.
To view the information for a data source (DS), open the menu associated with the desired DS and select View Information. The interface consists of two tabs: Information and Attributes.
This tab displays general details about the data source:
Name and description
References: projects, layers, and/or tables using this data source
Associated tags
For spatial DS, an interactive map is displayed:
A dotted outline indicates the geographic extent of the DS
The base map is provided by OpenStreetMap
Digital Elevation Models (DEM) from GeoTIFF files are shown in grayscale
Additional technical information is also displayed:
DS identifier (click to copy to clipboard)
Unique identifier within JMap Cloud
Coordinate Reference System (CRS)
Total number of elements in the DS
For tabular DS, a navigable data table is shown, along with:
The number of loaded rows
The total number of records in the table
This tab lists all attributes (or fields) of the DS. For each attribute, three sections are available:
Settings: title, data type, and indexing status for quick search
Statistics: value statistics (depending on the attribute type)
Value Domain: displays the current domain (if any), or allows you to create one
A value domain defines the valid set (finite or infinite) of values that an attribute can take—typically for text or numeric fields.
To create a value domain:
Click Create Value Domain. The Value and Label columns appear. All values present in the data are automatically added.
Click + to add a row.
Enter the value and its label.
Click to save or to cancel.
You can:
Remove a value that is not present in the data by clicking the icon
Delete the entire domain by clicking Delete Value Domain
You can modify some parameters:
If you have edit permissions for the DS, when you hover over the Description, Labels, and Unique identifier (SDS) parameters, the icon appears, allowing you to edit the parameter.
Also, if you have edit permissions, you can edit attribute/field titles, index them (by checking the box Indexed), and create, modify, or delete a value domain for text or quantitative attributes.
Press or to save or discard changes.
If you have editing permissions on the DS, you can modify certain parameters directly in the interface:
Hovering over the Description, Tags, or Unique Identifier (for spatial DS) displays the icon, allowing you to make edits
You can also:
Edit attribute titles
Click to save or to cancel your changes.
You can upload files to JMap Cloud to use them later when creating data sources. The Files tab, located in the Data Sources section, provides tools to upload and manage your files.
The content of uploaded files is stored in JMap Cloud’s databases. However, files listed in the Files table are automatically deleted after 10 days.
This tab displays a table of all the files you’ve uploaded. A button is available to let you upload new files.
The table includes the following information for each file:
Repeat to add additional values.
Create, modify, or delete value domains (for text or numeric attributes)
Select Vector/Raster data file.
Choose between:
New File: to upload a file from your device.
Existing File: to select a file already uploaded to JMap Cloud. See Uploading Files for more information.
For vector datasets, you must combine all associated files into a single .zip file before uploading.
For raster datasets, compression is not required unless you are uploading multiple files to create a mosaic—in which case they must also be combined into a .zip archive.
2. Analysing the file
If uploading a new file, JMap Cloud automatically analyzes the file’s metadata (format, type, coordinate system, geographic extent, etc.) before displaying the configuration window.
If selecting an existing file, the analysis (and conversion, in the case of raster files) has already been completed, and the configuration window is shown immediately.
3. Configuring SDS Parameters
The configuration parameters vary depending on the data type and format. See the File Settings section for detailed information.
You can also add a description and tags to help filter and organize your data sources. To create new tags, simply enter text in the Tags field.
4. Finalizing the SDS creation
Click Create to finalize the SDS. It will appear in the data source table. Its status will show as In Preparation during processing, then Ready once the creation is complete.
Once a data source is created for a file, the file is no longer required as the data is transferred to the JMap Cloud databases. All uploaded files are automatically deleted after 10 days.
The table shows the general settings to configure when creating a DS from vector/raster data files.
Name
Give the DS a name. There are no restrictions for the name of resources (DS, projects, map layers) in JMap Cloud.
Layer
Vector data only. This setting is specific to files that contain multiple data layers (GML, DWG, GeoJSON, etc.). Select the layer from which you are creating the SDS.
CRS
If JMap Cloud has correctly identified the CRS, this field cannot be modified. Otherwise, select the data projection system.
X
Vector data only. This setting is specific to CSV format files. Select the field (numeric values) that contains the longitude coordinates.
Y
Vector data only. This setting is specific to CSV format files. Select the field (numeric values) that contains the latitude coordinates.
Unique identifier
Optional. Vector data only. Select the field that contains the unique identifier of each map element. This identifier is necessary when you want to establish links with other data sources.
File name
Data type (vector, raster, or tabular)
Format
Size
Status
Upload date
Supported file formats:
Vector data (compressed .zip file): GeoJSON, SHP, File GeoDatabase, GML, TAB, CSV, DWG, GeoPackage
Raster data (uncompressed file): GeoTIFF
Tabular data (compressed .zip file): CSV
You can select one or more files in the table using the checkboxes. When selected, the Delete option becomes available, allowing you to delete multiple files at once.
Since spatial vector datasets typically consist of multiple files, you must compress them into a single .zip archive before uploading. Non-spatial tabular data files must also be uploaded as compressed .zip archives.
Compression is not required for raster files, unless you are uploading multiple files to be used as a mosaic—then, they must be grouped into a single .zip archive.
Upload Methods:
Drag and drop one or more files directly into the table. The upload will start automatically.
Or click Upload a file to open the file browser and select your files. Uploading will start automatically.
The status of each file indicates which step of the process was completed by JMap Cloud.
Waiting
The file is waiting to be uploaded.
Processing
The file is being analyzed.
Analyzed
The file has been analyzed by JMap Cloud which identifies properties such as file type, CRS, attributes, etc. It is available to create a spatial data source.
Uploading
The file is being uploaded. A line in the Status column indicates the progress of the upload. A circle in the header bar indicates the progress of the upload as well as the number of files being uploaded. A message indicates whether the upload was successful or failed.
Uploaded
The file has been uploaded. It needs to be analyzed to be available for creating a spatial data source.
Error
There is an error in the file loading process.
As with other JMap Cloud resources, you can manage a file by clicking the icon that appears when hovering over the row. Available actions depend on the file’s status:
Create Data Source
Delete
Cancel Upload
View Info
If the file’s status is Analyzed, the Create source option becomes available. Click it to open the data source creation interface.
Enter the necessary details based on the file type. For more information, refer to the sections:
Click Create to generate the data source. It will then appear in the Data Sources tab.
This option is available when the file is still uploading or being analyzed. It lets you stop the process.
Click Display informations to see the following details:
File name, size, format, and status
The ID of the user who uploaded it
Upload date and time
Metadata, which includes:
Unique file, organization, and task identifiers
Data layer names
Attribute names and types
Number of features or records
Click Delete. A confirmation prompt will appear.
Deleting the file does not remove any data source that may have been created from it. Only the file itself is deleted from the table.
As the owner of a data source (DS), you can grant access permissions to other users within your organization.
Permissions can be assigned to:
Groups;
API keys.
Each role has different levels of access.
Permissions follow a hierarchical structure:
Owner includes both Edit and View permissions;
Edit automatically includes View;
Viewer role-based permissions are at the base of the hierarchy and always include View.
Steps to grant permissions:
Click the icon next to a DS, then select Permissions. The permissions management interface will open, displaying:
the name of the DS;
the list of members, groups, and API keys with their current permissions.
To add a new user:
Groups cannot be assigned the Owner permission.
You can at any time:
change existing permissions;
add new users;
remove all permissions from one or more members, groups, or API keys.
Steps to manage permissions:
Click , then select Permissions to open the configuration interface.
Check or uncheck the relevant boxes to update permissions.
A DS must always have at least one user with Owner permission.
To remove all permissions:
Start by unchecking the highest-level permission (e.g., Owner). The next level (e.g., Edit) becomes the highest active permission.
For Viewer-type permissions, you must first uncheck the specific sub-permissions before removing the general View right.
To delete members, groups, or API keys from the permissions list:
Check the box next to each name;
Click the icon to remove them from the list.
Attributes
Vector data only. File attributes are presented in a table that contains the attribute name and type as well as a box to check which attributes should be indexed for quick search.
Description
Optional. You can add a description of the data source.
Tags
Optional. You can add labels that can be used to sort or filter SDS. Tags are available for use with all resources (DS, projects, layers).
Edit Attributes (Spatial DS) This permission allows the user to edit the attributes of SDS features in a cartographic application (such as JMap NG). Update data (Non spatial DS) This permission allows the user to modify the values of DS fields in a cartographic application (such as JMap NG).
Viewer
Delete Features (Spatial DS) This permission allows the user to delete features from the SDS in a cartographic application (such as JMap NG). Delete data (Non spatial DS) This permission allows the user to delete data from the DS in a cartographic application (such as JMap NG).
Open the dropdown list in the Add a member field;
Select a member, group, or API key (one at a time). The selected name appears with a letter indicating their role. You can clear a selection using the ✕ icon if needed.
Click to include the user in the permissions list.
Check the boxes to assign the appropriate permissions to each user.
Editor
Owner
This permission, the broadest, allows the user to:
grant access permissions to members of the organization,
delete the DS.
The SDS must have at least one owner.
Editor
Modify
This permission allows the user to modify the DS settings.
Viewer
View
For the user with the VIEWER role, this permission, combined with the Extract Features permission, allows the user to view SDS data in a cartographic application (such as JMap NG). For a user with the EDITOR role, this permission allows the use to view the DS in JMap Cloud Portal and use it in projects.
Viewer
Extract Features (Spatial DS) This permission allows the user to extract features from the SDS and, combined with the View permission, allows to view SDS features in a cartographic application (such as JMap NG). Extract Data (Non spatial DS) This permission allows the user to extract data from the DS and, combined with the View permission, allows to view DS data in a cartographic application (such as JMap NG).
Viewer
Create Features (Spatial DS) This permission allows the user to create features in the SDS in a cartographic application (such as JMap NG). Insert Data (Non spatial DS) This permission allows the user to insert data to the DS in a cartographic application (such as JMap NG).
Viewer
Edit Geometries (Spatial DS) This permission allows the user to edit the geometry of SDS features in a cartographic application (such as JMap NG)
Viewer