Administrative functions for the organization, including subscription management, are exclusively reserved for administrators.

These tasks are performed in the Organization section of the JMap Cloud Portal, which is organized into the following tabs:

• General

• API Keys

• Extensions

• Members

• Groups

• Invitations

Each tab provides the tools and settings required to effectively manage the organization’s resources and members.

Coming soon.

To add data to the project, you must select a data source, drag it, and drop it onto the map.

Spatial data appears in the project Layers section.

Tabular data is displayed in the Tabular data section.

Coming soon.

JMap Cloud is a cloud-based geospatial platform designed for developers and system integrators who need to add advanced mapping capabilities to their applications. It offers cloud services and robust APIs that simplify the integration, visualization, and querying of heterogeneous geospatial data from various formats (vector, raster, web services) and sources (OGC services, local files, etc.).

The platform is built around containerized, interoperable, and scalable microservices, ensuring high availability, dynamic scalability, and smooth integration into existing technology ecosystems. It complies with geospatial industry standards (OGC, GeoJSON, WMS/WFS, etc.), making it easily interoperable with existing GIS systems or business applications.

The following figure illustrates the architecture of JMap Cloud, including its main services (authentication, data management, map rendering, etc.), possible interconnections with the organization’s information systems (databases, internal web services), as well as front-end interfaces used by end-users via mapping applications.

JMap Cloud Portal serves as the web management interface for the platform. It provides administrators and authorized users with advanced visual tools to:

• Import geospatial and non-spatial datasets;

• Create, configure, and publish mapping projects;

• Manage users, roles, and access rights;

• Monitor the technical ecosystem connected to JMap Cloud.

In summary, JMap Cloud Portal enables centralized governance of an organization’s geospatial data and mapping services in a secure, flexible, and scalable cloud environment.

This section introduces extensions, also known as modules, which add specific features to JMap Cloud.

Each extension is displayed as a card showing the following details:

• Extension name

• Publishing organization

• Version

• Description of available features

• Representative image

• Link to more information

A toggle switch allows you to enable or disable the extension.

Extensions can be added to .

Projects that you have created (and of which you are then the owner) as well as projects for which you have access permissions appear in the Projects section.

Two display modes are available in this section: table mode, similar to the display mode of other JMap Cloud Portal resources, and card mode. You can switch between modes by pressing the and icons respectively.

When projects are displayed in list mode you can sort and filter them based on their name or modification date.

The name, number of layers, and visibility (public or private) settings are displayed for each project.

The menu icon available in both display modes offers functions for managing each project: , , , , , , . The following sections describe these functions in detail.

To open the project to explore it and fine-tune the configuration before making it available to users:

1. Click and then on Open in JMap NG. A JMap NG application displaying the project opens in a new tab.

2. Log in to the application with your JMap Cloud Portal login information.

3. Navigate the map and explore the app. The functions offered by JMap NG are available (see details in the ). It is the cartographic application that disseminates the project to members whose role is Viewer.

4. In JMap NG, click and then Logout to close the application.

To display and/or edit project settings:

1. Click and then Settings. The project configuration interface appears.

2. Edit project settings. You can edit all settings.

3. Click Update to save changes. The edit date is displayed in the Modification column when the project is viewed in List mode.

The layer order in the map is the order in which the layers are drawn on the map. The bottom layer is drawn first, followed by the layer above, which is drawn on top of the first, and so on until the last layer, the one at the top of the layer stack, is drawn.

The order in which the layers are drawn on the map is important because, depending on the layer's transparency, images (raster layers) could, for example, obscure lower-positioned layers, just as polygon layers could obscure point or line layers.

To determine the map layer order:

1. Activate the tool by clicking the Layer ordering icon.

2. In the Layer ordering window, select the layer you want to move. You can select the layer by clicking its name or the arrow icon that appears to the left of the layer name.

3. Move the layer to the desired position and drop it. The map reflects the change in real time.

You can delete a project for which you have Owner permission. Deleting the project deletes the project's map layers and tables as well as these configurations.

To delete a project:

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

The project disappears from the Projects section.

Layer groups allow you to better organize layers based on different criteria such as the layer's theme (sewer network, transportation, regulations, etc.), production date (current year, etc.), etc.

To add a group to the project:

1. Click Add Group. The new group, Layer group, appears in the Layers section.

2. Double-click the new group to edit its name. By clicking on the labels for each language, you can enter the group name in each language.

3. Select a layer to add it to the group.

4. With the cursor over the layer icon , drag and drop it into the group.

This function allows you to return to the map display as established by enabling or disabling the display of each layer.

You can therefore enable or disable the display of layers while you configure the map and project. When you press Reset display, the map returns to the default layer display.

Once the data is connected, the next step is to organize it into projects that can be disseminated to end users through mapping applications.

A project is composed of an ordered list of layers and non spatial data tables. A JMap Cloud mapping application opens projects and displays their layers and data tables. You can create as many projects as you want.

Each layer of a project is associated with a . The data source provides the layer data. Different projects can contain layers sharing the same data sources, allowing for a variety of styles and information for displaying the same data. It is also possible for several layers of the same project to share the same data source, using filters.

A project is a secure resource, which means that it has permissions associated with it to control access by end users. It is therefore possible to exercise precise control over which users will be authorized to open each project.

The Projects section of JMap Cloud Portal allows you to create and manage projects. You can also create projects directly from the .

The following sections describe the steps for creating a new project as well as managing the projects you have access to.

Some map elements will display a tooltip when you touch them or when you click on them. The tooltip contains information on the element's attributes, and it can include text, hyperlinks to open documents or videos in their native applications, photos, etc.

Sometimes elements from several overlaying layers have tooltips. In this case, when you open the tooltip of an element, it displays the contents corresponding to each overlaying element, being that of the upper layer displayed first, followed by the contents of the elements of the lower layers. The order of display of the content in the tooltip follows the order of overlay of the layers.

Tooltips are displayed temporarily for one element at a time.

To display a tooltip:

1. Click on an element whose tooltip you wish to display. The tooltip automatically appears.
2. Click on to close the tooltip or click on another map object to open its tooltip.

First-time login

A JMap Cloud administrator from your organization will send you an invitation email to join JMap Cloud Portal. This email, sent from JMap Cloud, includes a link that takes you to the account creation page.

The account setup interface displays your email address and a field to create your password, following the listed password requirements.

Once you've set your password, click Continue to proceed with the login steps described in the next section.

If you already have an account, you can simply click Login to access the platform directly.

Logging into JMap Cloud Portal

Once your account is created, you can access JMap Cloud Portal in one of two ways:

• By visiting the main website https://www.jmapcloud.io and clicking the Login button;

• Or directly via the portal URL: https://portal.jmapcloud.io/login.

To complete the login process:

1. Click Login to open the authentication page.

2. Enter your email address and password, then click Continue. Once authenticated, a screen will prompt you to select your organization.

3. Click the button corresponding to the organization you want to connect to. Another authentication step is performed, after which you’ll gain access to that organization’s JMap Cloud Portal.

The home interface displays the dashboard, which summarizes the JMap Cloud resources available to you based on your permissions.

The Layers section offers several tools to organize the project's layers, making it easier for end users to work with the applications.

In addition, each layer and layer group offers tools to control its display and therefore the map content.

Specifically, you can:

• Establish the order of the map layers

• Establish the order of the layers in the Layers panel in Studio and JMap NG

• Focus the map on a layer by displaying only that layer

• Add layer groups

• Remove a layer or layer group from the project

• Control the display of a layer or layer group in the map

You can update the data of a vector spatial data source or a non-spatial data source. This process allows you to replace the file or web service 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,

• or, in the case of a web service, reconfigure the connection query.

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.

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.

To delete a data source:

1. Select the Delete option from the DS menu.

2. A confirmation message will appear, listing any map layers or project tables that use this data source.

3. Click OK to confirm and delete the data source.

JMap NG is an online cartographic application that offers users an interactive tool for navigation, querying and editing spatial and descriptive data from JMap Cloud

Users of JMap NG applications are required to create, view, update, and delete data as part of their tasks. These operations are carried out using forms configured in JMap Cloud Portal for both spatial and non-spatial data sources.

The Forms section displays a table listing the configured forms associated with the data sources you have access to.

The Create a new form button opens an interface that allows you to:

• select a data source,

• assign a name to the form,

• and add tags.

Clicking Create takes you to the form design interface, which is described in detail in the following section.

Each form includes a menu that provides the following options:

• Settings: View the associated data source and modify the form’s title and tags;

• Edit form: Opens the form design interface (see the next section for more information);

• Delete: Permanently removes the form.

The Layout tab provides tools to visually arrange the components of your form.

By default, components are stacked vertically. The layout tools allow you to customize this structure by using containers that define flexible layouts. These containers can hold other containers or components, enabling highly customizable form designs.

To add a container, drag it from the panel and drop it into the Design tab interface at the desired location. Guide lines will appear to help you place the container in valid positions.

This approach allows you to create an infinite variety of simple or complex layouts.

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:

• 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.

This section displays the tasks that your organization runs on JMap Cloud. Its purpose is to provide information on problems that may appear when performing some functions.

A table displays a task in each row and the following attributes in columns:

Members with the Administrator role view all of the organization's jobs in the table.

Members with the Editor role view only the jobs they have started.

A job can only be canceled by the member who started it.

This section displays a table of the organization's member groups, along with a button to create new groups. When an organization has many members, organizing them into groups based on various criteria can greatly simplify tasks such as assigning resource access permissions.

The table shows the name of each group and the number of members it contains.

A menu in the header of each column allows you to sort, filter, hide, or display attributes.

Another menu , available when hovering over a group, gives access to options to edit or delete the group.

Creating a group

To create a group:

1. Click Create a group.

2. Enter a name for the group (between 2 and 250 characters), then click Create. Group names must be unique within the organization. The new group will then appear in the table.

Editing a group

You can edit a group's name and its composition (i.e., add or remove members):

1. Hover over the group's name, click the menu, and select Edit.

2. To change the group’s name, enter the new name and click to save or to cancel.

3. To add a member, use the Member name or email field to select a member from the dropdown list or type their name or email directly.

4. Once the members are selected, click to include the members. The members will be listed with their name, email, and role.

5. To remove members, check the boxes next to the members you wish to remove, then click .

Deleting a group

To delete a group:

1. Click the menu next to the group name.

2. Select Delete.

3. Confirm the deletion when prompted.

Studio is the section of JMap Cloud that allows you to configure a project, adding spatial or tabular data, and organizing and configuring layers.

The Studio interface is accessible through a project's menu when you select Open in Studio.

The following sections detail the features offered.

Two tools allow you to control the display of layers and layer groups. One allows you to enable and disable the display of the layer or group, while the other allows you to enable and disable the visibility settings configured for the layer or group. These are explained in detail in the Properties section.

To access the functions:

1. Hover over the layer or group to display their function icons.

2. Click or to disable or enable the display of the layer or group.

3. Click or to disable or enable the application of the visibility setting for the layer or group.

This section allows you to name your organization and copy its unique identifier, which is required to access JMap Cloud Portal from external systems or platforms.

• Enter the organization's name in the Name field.

• To copy the organization's unique identifier to the clipboard (for example, to use it in an external configuration), click the icon.

The unique identifier is used to establish connections between JMap Cloud and other systems, such as JMap Server, which relies on it to authenticate its connection to JMap Cloud.

For more details, refer to the JMap Server Administrator Manual.

When the visibility of a project is Public, users access the project without the need for authentication.

When visibility is Private, users must have at least View permission to access the project.

To obtain the sharing link to share a Public project:

1. Click and then on Get the public link. This function is inactive for projects with Private visibility type.

You can copy this link also from the project configuration interface. This is relevant when you make a project Public:

1. Click and then on Edit to open the project configuration interface.

2. If you have Owner permission, check the Public box to make the project public. The icon appears next to the box.

3. Click to copy the project share link to the clipboard.

The configuration panel of each non-spatial data table provides tools to configure the general properties of the table that will be accessible through the JMap NG application.

Each form is linked to a data source, whether spatial or non-spatial.

Forms are built using components arranged in either simple or complex layouts, depending on the requirements. In most cases, each form component is directly associated with a field or attribute from the data source, which is accessed through the layer or table connected to that source in JMap NG.

The form design interface allows you to define both the content and the layout of the components.

The illustration below shows the main sections of the form design interface.

When the project contains many layers with enabled display, the map may be less easily readable.

To make it easier to view a particular layer without having to disable the display of other layers, focus mode is a useful option. When you enable this mode and select a layer, the other layers in the project are not displayed in the map. You can quickly change the layer to be displayed, and simply disable the function to return to the map as configured.

To use focus mode:

1. Click to enable the Focus mode.

2. Click the name of the layer you want to display alone in the map. The layer configuration panel appears, and the map displays only that layer.

3. Click the arrow to return to the Layers panel. The map displays all layers with enabled display. The Focus mode tool remains active.

4. Select another layer by clicking on its name. The configuration panel opens, and the map displays only that layer.

5. In the layer control panel, click to disable Focus mode. The map displays all layers whose display is enabled.

The order of layers in the Layers panel of Studio and JMap NG is intended to make work easier for users, especially when projects contain many layers.

To set the layer order in the panel:

1. In the Layers panel, hover over the layer you want to move until the icon appears.

2. Click and drag the layer to the desired location and drop it. The map remains unchanged. The Layers panel displays the new order.

This section allows you to configure the layer properties, through the following parameters:

The language button allows you to select the available languages ​​to provide the information in each language.

Each layer's control panel offers tools for configuring general layer properties, styles, labels, and tooltips. The available tools vary depending on the layer type (vector or raster).

Icons provide access to each section.

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)

• Number of features (for vector and tabular data sources)

• Tags

• Last modified date

Creating a data source

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

• Feature service

The following steps will vary depending on the selected source type.

This guide outlines the main steps involved in publishing data from JMap Cloud through a web mapping application, either public or restricted.

Within an organization, each user is assigned one of three roles in JMap Cloud: Administrator, Editor, or Viewer. The section provides detailed descriptions of the responsibilities associated with each.

Only Administrators and Editors have access to JMap Cloud Portal, the management interface for the platform. Viewers access data exclusively through web mapping applications.

While Administrators and Editors can see all sections of the portal, only the features corresponding to their role are enabled.

The diagram below summarizes the general workflow, indicating which roles are involved at each stage.

Connecting Data

In this step, the Editor connects data to JMap Cloud by creating data sources. These may include GIS files, spatial data servers, satellite imagery, or non-spatial tabular data.

There are two main ways to connect data:

• Upload files, which are then copied to JMap Cloud’s internal databases;

• Create connections to external web data services to make the data accessible for project configuration.

For more information, see the section .

Organizing Data into Projects

Data in JMap Cloud is organized into projects. A project contains:

• the definition of map layers,

• access control settings (security),

• unit preferences,

• and other display parameters.

By creating a project, the Editor defines the visual appearance of the map, the data it will include, and the users who will be granted access.

For details, refer to .

Configuring Project Data

At this stage, the Editor creates map layers using spatial data and adds non-spatial tabular data to the project. Each layer or table is linked to a specific data source.

For each map layer, the Editor configures:

• style (how the features are drawn),

• labels,

• tooltips,

• visibility thresholds, and more.

See the section for additional details.

Publishing the Data

Once the project is complete, it is published through web mapping applications for end users.

Depending on the access control settings defined by the Editor, the applications may be:

• publicly accessible, or

• restricted to authenticated users with the Viewer role.

For more information on these applications, refer to the .

You can select the layers to display in the map.

To display a layer, you must display the group and the subgroups in which the layer is found.

1. Slide the switch on the group's card from to in order to enable the display of the group.

2. Click on to open the group card and display the layers and subgroups it contains.

3. Slide the switch on the subgroup's card to enable its display. The icon of the subgroup will change color .

   The icon appears in the layers' cards whose display is disabled. No icon appears in layers' cards whose display is enabled.

4. Click on to display the layer. The icon disappears, and the layer is displayed in the map.
5. To disable the display of a layer, bring the mouse pointer to the card of that layer. The icon appears.
6. Click on the icon, which turns to . The layer will no longer be displayed in the map. Its symbol will turn gray.

7. Slide the display switch of the group to this position if you wish to disable the display of all layers comprising this group. Even the layers whose display is enabled will no longer be shown.

Displaying layers based on the map scale

Some layers are configured to be displayed within a given scale interval. Displaying an abundance of small map elements when a small scale is selected (i.e. when the map displays a large territory with few details) can make it very difficult to read the map. Layers that have elements with these characteristics are usually displayed at a larger scale, when the map contains more details on a limited territory.

When a layer is not visible because of the map scale, its name and symbol will appear in very light gray. When you change the scale, these colors will become darker, indicating that the layer appears in the map if its display is enabled.

JMap NG Developer Manual

This manual is for developers who want to use JMap NG to create map visualization applications for the web, integrate mapping capabilities into their web applications or extend existing JMap NG tools. JMap NG connects to your instance of JMap Server and opens JMap projects.

Depending on the needs, one of two different approaches may be selected: using JMap NG Core or using JMap NG App.

Both JMap NG Core and JMap NG App can be easily embedded in you web applications or web sites. This manual explains how to do it and provides running examples that you can use to get started.

JMap NG Core

JMap NG Core is a library for building map visualization applications for the web. It connects to a JMap Server instance to load and display a map project. It is based on the open source project. It does not include any UI except for the mouseover popups and basic map controls. It is useful when you need only the map but want to build your own UI around it.

JMap NG Core provides a JavaScript API to perform simple tasks and JMap related tasks like getting a JMap Project, managing layers and accessing feature attributes. It also exposes the full MapLibre GL JS API for other tasks.

The latest version of the JMap NG Core Javascript API documentation is available .

JMap NG App

JMap NG App is a complete map visualization application based on JMap NG Core. It provides a complete UI with many ready to use tools such as measuring, selecting, editing features, printing. It does not require any programming but provides a JavaScript API and can be extended by writing JMap NG extensions. JMap NG extensions are modules that plug easily into JMap NG to extend its capabilities, perform custom tasks or to support the integration of JMap NG into another web application.

The latest version JMap NG App Javascript API documentation is available .

This function allows you to filter the data source elements that are part of the layer. This allows you to create multiple different data layers using the same data source.

SQL conditions are used to filter the data source elements. Only elements that meet the SQL conditions will appear on the layer.

The Filters section, accessible by clicking on , allows you to configure the SQL conditions.

Filter operators

equals: This operator filters DS elements to conserve in the layer the elements whose attribute value (regardless of its type) is equal to one of the selected values.

does not equal: This operator filters DS elements to conserve in the layer the elements whose attribute value (regardless of its type) is different from the selected values.

greater than: This operator filters DS elements to conserve in the layer the elements whose attribute value (numeric or date) is greater than the selected value.

greater or equal to: This operator filters DS elements to conserve in the layer the elements whose attribute value (numeric or date) is greater than or equal to the selected value.

less than: This operator filters DS elements to conserve in the layer the elements whose attribute value (numeric or date) is less than the selected value.

less or equal to: This operator filters DS elements to conserve in the layer the elements whose attribute value (numeric or date) is less than or equal to the selected value.

contains: This operator filters DS elements to conserve in the layer the elements whose attribute value (text) contains the selected value.

does not contain: This operator filters DS elements to conserve in the layer the elements whose attribute value (text) does not contain the selected value. This is the same as making a query with the WHERE clause attribute_name NOT LIKE '%value%'.

is null: This operator filters DS elements to conserve in the layer the elements whose attribute value (regardless of its type) is null.

is not null: This operator filters DS elements to conserve in the layer the elements whose attribute value (regardless of its type) is not null.

is between: This operator filters DS elements to conserve in the layer the elements whose attribute value (numeric or date) is within the range defined by the two entered values.

is not between: This operator filters DS elements to conserve in the layer the elements whose attribute value (numeric or date) is not within the range defined by the two entered values.

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.

JMap Cloud allows you to create data sources (DS) from CSV files containing tabular data without spatial components. These datasets can later be linked to spatial data if needed.

Files can be uploaded during the data source creation process, or uploaded in advance via the file management interface. For more information, refer to the Uploading Files section.

Steps to Create a DS from a Tabular File

1. Upload the CSV file to JMap Cloud.

2. Metadata analysis (structure, data types, etc.).

3. Validation and configuration of the DS parameters.

4. Once the process is complete, both the data and its configuration are stored in JMap Cloud’s databases.

Creating a DS from tabular data files

1. In the Data Sources tab, click on Create a data source.

2. Select the Tabular data file (non spatial) option.

3. 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 Uploading Files section.

Uploading

• 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.

Configuring DS Parameters

• 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.

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.

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.

The uploaded files appear in the Files tab. These files are automatically deleted from JMap Cloud after 10 days.

File settings

The table shows the general settings to configure when creating an DS from tabular data files.

The following pages contain source code examples that you can run or modifiy in Codepen.io.

In all examples, you must import the JMap NG core or app library from our CDN with a command like this:

<script defer type="text/javascript" src="https://cdn.jsdelivr.net/npm/jmap-core-js@7_Kathmandu_HF3"></script>

or

<script defer type="text/javascript" src="https://cdn.jsdelivr.net/npm/jmap-app-js@7_Kathmandu_HF3"></script>

The specific version of the library that you import must match the version of your backend. For JMap Cloud, always use version 'jmapcloud'. For JMap Server, use the version that matches your setup (for instance, 7_Jakarta_HF6 or 7_Kathmandu_HF3). New versions of JMap NG libraries are published for each release of JMap Server.

Project data is organized into layers. Each layer contains data related to a specific theme. Layers are superimposed on one another to form the map that is displayed in the interface.

Some layers are comprised of objects or elements that are represented using a type of geometry (points, lines, polygons) and descriptive attributes. For example, a layer can represent trees using points, and the attributes associated with them can include the species of tree, diameter, height, and state of health. Thus, each object (tree) of the layer has a geometry that is located in space and attributes that describe it.

Other layers are comprised of raster data (pixels) that form images, such as aerial photographs, satellite images or digital elevation models.

Layers can be grouped hierarchically based on themes, such as urban planning, the environment, transportation, etc. A multi-level hierarchical structure makes it easier to work with projects when they contain many layers and different themes.

Some layers are called base maps because they provide a context to display the data layers. Interaction with base maps is limited to selecting the base map to be displayed in the application.

Roles in JMap Cloud Portal define user categories, each associated with a set of access and editing privileges for an organization's resources.

Each member of an organization is assigned a single role, chosen from the following:

• Administrator

• Editor

• Viewer

These roles determine which functions and sections of JMap Cloud Portal a user can access.

Only Administrators and Editors can log in to JMap Cloud Portal. Viewers interact solely with applications that display the data configured in the portal.

The following diagram illustrates the relationship between the roles:

• The Administrator has full access to all functions in the portal and applications.

• The Editor manages data and projects but has no administrative access.

• The Viewer only uses the applications to view or interact with data, depending on granted permissions.

Administrator

The Administrator is responsible for the administrative management of the organization within JMap Cloud Portal, including user management, API keys, and organizational settings.

The Administrator can:

• Create, modify, and delete API keys

• Configure organization settings

• Invite new members

• Assign and modify user roles

• Create, edit, and remove organization members

• Manage the organization’s extensions

These functions are accessed through the Organization section. The chapter Managing the Organization provides further details.

From the Dashboard, the Administrator can also quickly create API keys.

Additionally, the Administrator has all the privileges of the Editor role.

Editor

The Editor is the default role for organization members.

Editors do not have access to administrative functions but are responsible for setting up and configuring projects that are shared through JMap Cloud applications.

The Editor can:

• Create, configure, modify, and delete the following resources:

  • Data sources

  • Projects

  • Map layers and non-spatial data tables

These tasks are performed through the Dashboard, Data Sources, and Projects sections of the portal.

Viewer

The Viewer is an end user who accesses project data via JMap Cloud applications. This user does not access JMap Cloud Portal.

The Viewer can:

• Access a project and its data

• Navigate the map and interact with data (e.g., selecting features, viewing details, etc.)

• If granted appropriate permissions, edit geometries and/or attribute values of a layer or table

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

Web Map Service (WMS) and Web Map Tile Service (WMTS) are two standards defined by the Open Geospatial Consortium (OGC). They specify how client 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:

This section allows you to create and send invitations to individuals so they can join your organization on JMap Cloud Portal.

A table lists all invitations sent from this tab or from the Members tab. For each invitation, the following details are displayed:

• Invitation ID

• Sender’s email address

• Recipient’s email address

• Creation date

• Expiration date

A menu at the far right of each row allows you to view details or delete the invitation.

A second menu in each column header allows you to sort, filter, hide, or show attributes as needed.

Inviting a member

This feature is also available from the Members tab.

To invite a new member to the organization:

1. Click + Invite member.

2. Enter the recipient’s email address.

3. Select the role to assign (Administrator, Editor, or Viewer) and, if needed, the groups the member will belong to.

4. Choose the correspondence language (the language of the invitation email).

5. Click Create.

A confirmation window will appear. You may copy the invitation link to your clipboard by clicking the icon.

Close the window. The invitation will now appear in the invitations table.

Displaying or removing an invitation

To access these actions:

1. Click the menu at the right of the desired row.

2. Select Display info to open a window showing:

   • The invitee’s email address

   • The sender’s email address

   • The creation and expiration dates

   • The correspondence language

   • The assigned role and groups

   • The invitation link, which can be copied

3. Select Delete to invalidate the invitation. The invitee will no longer be able to use the link to join JMap Cloud Portal.

Invited members

The invited member receives an email from JMap Cloud inviting them to join your organization. The email includes:

• The name of the person who sent the invitation

• The email address of the invitee

• The name of the organization

• A clickable invitation link

• A call-to-action link titled Accept the invitation

By clicking either the link or the Accept the invitation button, the invitee is taken to the Accept invitation to register | Porta page, where they can set a password and log in for the first time to JMap Cloud Portal.

• If the member is assigned the Administrator or Editor role, they will have access to JMap Cloud Portal.

• If they are assigned the Viewer role, once logged in, they will access the projects for which they have permission via the JMap NG mapping application.

This section displays a table of the organization's members, along with a button to invite new members to JMap Cloud Portal.

For each member, the table shows the following information:

• Name

• Identifier

• Email address

• Role

• Groups the member belongs to

A contextual menu appears when hovering over a member’s name. It provides options such as viewing details, editing, or deleting the member.

Another menu , located in the header of each column, allows you to sort, filter, hide, or show table attributes.

Adding a member

To invite someone to join your organization on JMap Cloud Portal:

1. Click Invite Member.

2. Enter the person's email address.

3. Select the role and groups from the dropdown lists.

4. Choose the language for the invitation email.

5. Click Create. A confirmation message will indicate that an invitation email has been sent.

6. To copy the invitation link, click the icon.

7. Close the window. The invitation will appear under the Invitations tab.

Displaying and editing member information

1. Hover over the member's name and click the contextual menu .

2. Select Display info to open a window displaying the member’s name, email, role, and groups.

3. Click Edit to change the member’s role or groups.

4. Save the changes — the updates will take effect immediately.

Removing a member

Members with the Administrator or Editor role may own resources such as files, data sources, projects, and map layers.

When such a member is deleted, an administrator must decide what to do with their resources.

Steps to delete a member:

1. Click Delete, the following message is displayed.
2. To keep the member’s resources, check Transfer ownership to, then choose another member from the dropdown list.

3. Click Delete to confirm.

   • The deleted member’s access permissions (ACL entries) will be removed.

   • The selected member will become the new owner of the resources.

You may also choose to delete the member without transferring ownership:

• The member and their resources (including any dependencies) will be permanently deleted.

• All associated access permissions will be removed.

To display the geographic extent of a layer, even if it is not displayed in the map:

1. Click on and then on Zoom to layer extent. The map automatically displays the area corresponding to the extent of the layer. A rectangle delimiting the extent of the data is displayed for a few moments.

2. Click on if you wish to return to the previous geographic extent.

JMap NG is accessible from a web browser (Edge, Google Chrome, Firefox, Safari, etc.) through an invitation link sent by your organization.

The following image shows JMap NG's login interface.

The login interface and the application itself are displayed in the language you configured for your web browser.

1. Click on located at the bottom of the interface to display the available languages and change the display language of JMap NG.

   The version of JMap NG as well as the JMap product to which the application is connected are also displayed at the bottom of the interface.

   If access to the application is controlled, sign in with the username given by your organization and choose a password.

   Once you are logged into the application, the following interface allows you to select the project you wish to access. The projects you have permission to access will be displayed.

2. Use the filter to more quickly identify the project that interests you.

3. Click on a project to access it.

4. Click on to open the menu providing access to the documentation and allowing you to log out of your JMap NG session.

You can delete a layer or group of layers from the project:

1. Hover over the group or layer you want to delete until its icons appear.

2. Click the Delete icon. The layer disappears from the Layers section and the map. The group disappears from the Layers section, and its component layers appear in the same location as the group in the Layers section.

To perform some functions such as interactively selecting elements of a layer using the selection tools, you must first make the elements of the layer selectable.

1. Pass the cursor over the card of the layer you are interested in to display the icon .

2. Click on to make the layer elements selectable. The icon is permanently displayed in the form.

3. Click on to make the elements of the layer non-selectable. The icon stops displaying and when you pass the cursor over the card, the icon appears.

Labels are text elements attached to map features. They are used to display information about it. For example, you can use labels to display city names for a point layer representing cities.

The Labels section, accessible via the icon, allows you to configure the content, style, and display of labels for the layer's elements.

Label Content

Labeling is configured by specifying text that defines the label's content. Label text can span multiple lines.

The text can contain static and variable parts, such as functions. When displayed, the functions are executed and replaced with the result. Labels don't support HTML formatting or hyperlinks.

The following functions are available:

The available attributes are displayed in the Attributes section.

To enter the label content:

1. Write the text for static content.

2. If you want to include dynamic content, position the cursor at the desired location within the content area and click to select the function you want to use. It is instantly added to the content area, and a menu of available attributes for the function is also displayed.

3. Select the attribute and add a value if applicable.

4. Click to save the label content.

Displaying Data Source Information

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.

Information Tab

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

• Features are loaded progressively, up to a maximum of 50,000 elements. Any elements beyond this limit are not displayed

• 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

Attributes Tab

This tab lists all attributes (or fields) of the DS. For each attribute, three sections are available:

• Settings: title, data type, and indexing status

• Statistics: value statistics (depending on the attribute type)

• Value Domain: displays the current domain (if any), or allows you to create one

Value Domain

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:

1. Click Create Value Domain

2. The Value and Label columns appear

3. Click + to add a row

4. Enter the value and its label

5. Click to save or to cancel

6. Repeat to add additional values

You can:

• Remove individual values by clicking the icon

• Delete the entire domain by clicking Delete Value Domain

Editing Parameter Values

You can modify some parameters:

1. 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.

2. 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.

3. Press or to save or discard changes.

Editing Parameters

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

  • Toggle indexing

  • Create, modify, or delete value domains (for text or numeric attributes)

Click to save or to cancel your changes.

The JMap Cloud Portal user interface looks like this:

Sections

The JMap Cloud Portal interface organizes information into sections, typically displayed in table view, and occasionally in card view, depending on the resource type.

Table View

In table view:

• Each row represents a resource, such as an organization member, API key, file, task, spatial data source, etc.

• You can choose to display 25, 50, or 100 rows per page.

• If the number of entries exceeds the selected limit, the table is paginated.

• The footer displays the number of rows shown on the current page, as well as the total number of entries in the table.

Table Columns and Attributes

Each column in the table represents a resource attribute, with the column header showing the attribute name.

A column options menu (⋮ icon) is available by hovering over each header, providing actions such as:

• Sort rows (ascending or descending)

• Filter rows based on a specific attribute value. When a filter is active, a icon appears next to the attribute name.

• Hide column

• Show hidden columns

• And other attribute-specific options

Card View

Some sections, such as Projects, also offer a card view, providing a more visual layout of the resources and their key information.

Resource Action Menu

A contextual menu ( icon) is available:

• In the Name column when hovering over a row in table view.

• Or directly on each card in card view.

Menu options vary depending on the resource but may include:

• View information

• Edit information

• Create data source

• Interrupt

• Delete

• And other relevant actions

Adding Resources

Each section—except for Jobs—includes a button to add new resources.

Date Format

All dates are displayed using the ISO 8601 format (e.g., 2025-06-18T14:30:00Z).

Form components are typically associated with an attribute or field from the data source, except for the Label component, which is not data-bound.

The following sections describe:

• the types of components available in JMap Cloud Portal,

• the parameters specific to each component type,

• and the various features for managing components within a form.

Component Types

JMap Cloud Portal offers a variety of component types to meet different functional and visual requirements within forms.

Component Parameters

Each component type includes specific parameters that control its behavior and appearance (e.g., default text, formatting, style, constraints, etc.).

Working with Components

Adding a Component

To add a component to a form, drag it from the palette and drop it into the Design tab interface. Components can be placed within .

Configuring a Component

To configure a component already placed in the form, click on it in the Design tab. Its editable parameters will appear in the Properties section.

You can adjust the spatial arrangement of components using the layout tools described in the following section.

Deleting a Component

To delete a component, click on it in the Design tab, then click the delete icon .

Popups are used to display information about the highlighted elements. This information includes text, attribute values, hyperlinks, images, etc.

You determine the information displayed in the popups for each layer.

The Popups section, accessible via the icon, allows you to configure the content and display of the popups.

Popup content

The popup content is configured by specifying text that can contain static and variable parts, such as functions. When displayed, the functions are executed and replaced with the result.

Follow the available functions for popups:

The available attributes are displayed in the Attributes section.

To enter the popup content:

1. Enter the text for the static content.

2. If you want to integrate dynamic content, position the cursor at the desired location within the content area and click to select the function you want to use. It is instantly added to the content area, and a menu of available attributes for the function is displayed.

3. Select the attribute and add a value if applicable.

4. Click to save the popup content.

Several tools allow you to navigate the map.

Looking for a place

This feature is only available when a Mapbox API key is configured. Contact your JMap administrator for more details.

You can search for a specific place in the map:

1. Press to open the box and write location information.

2. Enter search terms. You can enter an address, a postal code, a city name, a place, etc. JMap NG uses the Mapbox Geocoding service to find the location. As you enter information, places with matching information are displayed.

3. Select the desired location by clicking on it. The map zooms and centers on the place identified by a mark . Location information is displayed in a tooltip.

   When you search for another location, the mark of the previously selected location disappears.
4. Press to close the place search and clear the last place information.

5. Press to close the search and erase the information of the last location.

Searching features on the project

You can search for an feature in the project based on the value of one of its attributes.

1. Press or press / to open the Search on the project box.

2. Enter the search terms. As you enter terms in a list, elements in the project layers whose attribute value matches the terms you enter are displayed.

3. Click the list the element you want to find. The map centers on the element which is selected.
4. Click the layer name to select all features in the layer whose attribute value matches the terms you enter. The map centers on them.

Navigating the map using fingers or the pointer

You can navigate on the map using your fingers or the pointer:

1. Using your fingers you can zoom in and out, move the map, and tilt it to navigate on it in 3D, as shown in the figure below.
2. Click on the icon to display map rotation information (in degrees, with North as a reference) and map inclination information (in degrees, based on the horizontal plane).

3. Click on the icon to straighten the map, eliminating the rotation and tilting of the map. The icon turns gray and indicates the North on the horizontal plane .

Centering the map at a coordinate and changing the scale

You can center the map at a specific coordinate and change the map scale:

1. Press to open the geographic information window.

2. Press Scale to open the Change the map scale window.

3. Enter the new scale or select it using the arrows. The scale of the map changes as you change the numbers.

4. Press OK to close the window. The map is displayed at the scale you have chosen.

5. Press the Latitude and Longitude (Lat Lon) data to open the Recenter the map window.

6. Enter the new Latitude and / or Longitude or select them using the arrows. The map automatically recenters at the chosen coordinate.

7. Press OK to close the window.

Dashboard is the home section of JMap Cloud Portal. As its name implies, it provides a real‑time overview of key resources—such as projects and data sources—and even lets you create new ones directly from this view.

Extensions are plug-ins for JMap NG App that extend its functionalities. With the JMap NG API, you can develop your own extensions.

Extensions can add their own UI, typically an icon and a side panel. It is possible to have extensions with a different UI and even with no UI at all.

NG Extensions are javascript objects that respect an interface (either or ) and that are loaded by NG at application startup or project load, depending on the type of the extension. Every extension must have a unique id property, a initFn implementation, if implementing , and a onPanelCreation implementation if implementing .

Extension life cycle

Extensions are being "registered" by NG in 2 different ways:

• if included in the JMap NG , they will be automatically registered by NG.

• If loaded from a javascript <script> tag or via a project load, the extension must register itself. This is typically done in the extension "entry point" by calling the method, for a Core extension, or method, for an Application extension.

The registering process most importantly includes incorporating your extension's redux reducers, if provided, your translation bundle, if provided, and the extension service to expose, if provided.

When NG registers your extension, it automatically calls your extension's initFn and onPanelCreation methods. In your initFn or onPanelCreation method, you can handle all your extension's initializing process. Once the initFn method is called, you can start calling NG's API to communicate with it.

Extension unique ID

The Extension Unique ID serves a dual purpose for NG: it used by NG to identifiy and manage the loading process of extensions, while also establishing a connection with a server-side extension. This connection can link your extension to specific JMap projects, optionally allowing for the transmission of configuration data to your extension during project loading. The nature of your unique id thus depends on your way of deploying it.

How to deploy your extension

Once your extension is ready to deploy, you can compile it and host it on any CDN of your choice. If your extension is loaded via a project, the URL of your CDN will be configured in the server-side part of your extension. If you include your extension as a <script> tag in an HTML page, you will be able to use the CDN's url. In all cases, this url should always be accessible from the location where NG will run.

You can see a full extension example .

You can open the project in Studio, the section of the JMap Cloud Portal that provides tools for creating and configuring project layers and data:

1. Click and then Open in Studio. The section provides topic details.

You can set the initial extent of the project, that is, the geographic extent of the project that appears when opened in an application such as JMap NG as well as in Studio.

1. Activate the tool by clicking the icon in the Define an initial extent section.

2. Click once to begin, draw the rectangle, and click a second time to finish.

3. Click the accept icon to save the rectangle.

In this example, we will show how to add an event on move end in JMap NG.

Example

We add an event to display the current center of the map. The value is updated each time the move ends.

Try it out in Codepen.io

<html>
<head>
  <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
  <meta charset="UTF-8">
  <style>
    #my-custom-map {
      width: 600px;
      height: 600px;
      border: 1px solid grey;
      margin-top: 1rem;
    }
  </style>
</head>
<body>
  <label><b>Center of the displayed map:&nbsp;</b></label>
  <br/>
  <label>Latitude:&nbsp;</label>
  <span id="latitude"></span>
  <br/>
  <label>Longitude:&nbsp;</label>
  <span id="longitude"></span>
  <div id="my-custom-map" class="jmap_wrapper"></div>
  <script type="text/javascript">
    window.JMAP_OPTIONS = {
      projectId: 1,
      restBaseUrl: "https://jmapdoc.jmaponline.net/services/rest/v2.0",
      anonymous: true,
      map: {
        containerId: "my-custom-map",
        zoom: 13.797865986918877,
        center: {
          x: -73.48063889179525,
          y: 45.664231577062765
        },
        onStartupMapReadyFn: () => {
          const initialCenter = JMap.Map.getMap().getCenter()
          document.getElementById("latitude").textContent = initialCenter.lat
          document.getElementById("longitude").textContent = initialCenter.lng
          JMap.Event.Map.on.moveEnd("move-end", (params) => {
            const center = params.map.getCenter()
            document.getElementById("latitude").textContent = center.lat
            document.getElementById("longitude").textContent = center.lng
          })
        }
      },
    };
  </script>
  <script defer type="text/javascript" src="https://cdn.jsdelivr.net/npm/jmap-core-js@jmap-ng-doc"></script>
</body>
</html>

As the owner of a data source (DS), you can grant access permissions to other users within your organization.

Permissions can be assigned to:

• Members with the Editor or Viewer role;

• Groups;

• API keys.

Each role has different levels of access.

Granting permissions

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:

1. 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.

2. To add a new recipient:

   • 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 recipient in the permissions list.

3. Check the boxes to assign the appropriate permissions to each recipient.

Modifying or removing permissions

You can at any time:

• change existing permissions;

• add new recipients;

• remove all permissions from one or more members, groups, or API keys.

Steps to manage permissions:

1. Click , then select Permissions to open the configuration interface.

2. Check or uncheck the relevant boxes to update permissions.

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:

• Check the box next to each name;

• Click the icon to remove them from the list.

You can create a new project from the Dashboard or from the Projects section.

To create a new project:

1. Click Create a new project.

2. Complete the project settings.

The project displays in the Projects section. In both display modes, cardboard or list, the menu offers functions for managing projects.

Project settings

Vector tiles are a very effective vector data format for web mapping. The principle consists of dividing all of the vector data of a project into tiles, in a manner analogous to raster data tiles (WMTS).

There are several standards for producing vector tiles. Mapbox proposed a standard based on the Protocol buffers ("Protobuf") encoding created by Google (https://developers.google.com/protocol-buffers). Mapbox vector tiles (mvt) are supported by a wide range of mapping products including JMap Cloud, JMap Server and JMap NG.

A grid that defines the tiling is applied to the vector data which is then cut into tiles. Each tile can contain vector data from multiple layers.

A set of tiles is produced for each scale level. In web cartography in general, 23 scale levels are considered, level 0 corresponding to the Earth and level 22 corresponding to the street. The vectors of the lower levels are simplified (generalized) to optimize the display of data while keeping tiles of an efficient volume.

The vectors (lines, polygons) of each layer are cut at the tile boundaries. When geometries cross the border between tiles, the tiles are cut and each tile contains part of the geometry. It is the mapping application that unifies the vectors to obtain the complete geometry.

Attributes of map elements are included in the tiles. This makes the data more dynamic and interactive, allowing for example to display thematics created on the fly or to display data based on the application of filters based on their attributes.

The vector tiles therefore contain the geometries and their attributes, the styles are not included in the tiles. The information defining the styles is stored and managed in a separate JSON file. This feature allows application users to define styles dynamically because the applications manage the styles. Additionally, when the data style changes it is not necessary to generate new tiles.

The tiles can be created in advance and cached, the server response being much faster to requests from the web mapping application, which gives a very fluid and efficient rendering.

Production of vector tiles by JMap Cloud

A JMap Cloud project generates three sets of data that are used by applications:

• A JSON file containing style. This file accompanies the vector tiles. It contains the definition of each layer contained in the vector tiles, their style settings, themes, etc.

• A set of vector tiles that contain the geometries and attributes of non-editable layers. JMap produces one mvt format file per tile. These tiles can be created on demand as users navigate JMap NG applications. They can also be created in advance and cached.

• Vector data in GeoJSON that corresponds to the geometries and attributes of the editable layers. This data is sent on-demand by region to apps.

Factors that affect the performance of vector tiles

In general vector tiles are lighter than raster tiles but certain factors can affect the size of the tiles and have an impact on the performance of JMap NG applications. The size of the tiles is associated with the time of their production, the storage volume, the volume of data exchanged with the applications and the dedicated memory of the applications.

Among the factors to consider we can cite:

• Number of attributes linked to layers: Attribute data influences the size of the tiles, which increases with the number of attributes.

• Layer visibility scales: Setting visibility thresholds for layer display is appropriate when layers have very dense data. Limiting the display of these layers to larger scales is a good strategy because tiles at smaller scales will not contain data from these layers and tile production time will be reduced.

• Caching: Producing and caching tiles in advance greatly improves application performance.

Managing the project's MVT cache

Pour gérer le cache de tuiles vectorielles du projet :

To manage the project's vector tile cache: Press to access functions. Tap MVT Cache to open the Manage MVT Tile Cache interface of the project. This interface has four sections:

1. Click and then on MVT Cache to open the Manage project's MVT tile cache interface. This interface has four sections:

   Cache state

   Indicates the cache status, if available.

   Fill

   This option allows you to indicate whether you want to create tiles for all 23 levels or for a specific range of levels. In this case, specify the minimum and maximum levels of the range. This option does not overwrite tiles that are already cached.

   Delete

   This option allows you to specify whether you want to remove tiles from all 23 levels or from a specific range of levels. In this case, indicate the minimum and maximum levels of the range.

   Running task

   Indicates the progress of the creation or deletion by cache level as well as the overall progress of the creation or deletion.

2. Indicate the task you want to perform.

3. Click Launch task. The Running task section displays task progress graphically and in percentage..

4. If you want to cancel the task, click . A message validates your choice.

You can grant permissions to other JMap Cloud members, groups or API keys in your organization for projects that you own.

Three permissions are offered. The permissions are hierarchical, in the sense that the broadest permission includes the other two permissions.

Granting permissions

To grant permissions to a project:

1. Click and then on Permissions. The permissions configuration interface opens displaying the members with the permissions each has. A letter indicates the member's role.

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

3. Select the members, groups or API keys you are interested in, one at a time. You can clear the selection by clicking . The names appear in the Add member field.

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

5. Check the permissions you want to grant to each member. The Owner permission automatically includes the other two permissions.

Modifying permissions

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

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

2. Change the permissions by checking or unchecking the relevant boxes. To remove all permissions from a member group or API key, you must uncheck all three permissions. When you uncheck the Owner permission box, Modify automatically becomes the most important permission.

3. If you want to remove members, groups or API keys select them by checking the box to the left of each name and press .

Layers can have thematics, the appearance of that layer's elements vary based on one or more attributes.

You can display more than one thematic for a layer at the same time.

To display the THEMATIC(S) panel of the layer:

1. Click the layer icon. The THEMATIC(S) panel displays the legend of the thematics.
2. Use the switch to enable or disable each thematic. The appearance of the icons representing the layer's objects will change according to your choice.

3. You can uncheck one or more classes or categories of the thematic so as not to display on the map the elements of these classes.

4. If the JMap administrator has configured it in this way, the thematic legend can be dynamic, i.e. the legend only shows the classes or categories of the elements displayed in the map. The classes of elements that are not displayed in the map are not shown in the legend. As you navigate the map, the legend changes depending on what is displayed there.

5. Click on or to close or open the thematic's card.

6. Click on Back to return to the Layers panel.

Thematics management

This option is only available for layers that have thematics configured.

1. Click on and then on Thematic management to open the THEMATIC(S) panel and use the functions described in the previous section.

To display layer information:

1. Click on and then on More information to open the GENERAL panel. Several information are presented there:

   • Number of layer features that are visible on the map. The number varies as you navigate the map.

   • Extent: X and Y indicate the position of the southwest point of the layer, width and height indicate the layer extent in meters from this point.

   • Metadata: information about the data in the layer such as quality indicators, the organization producing the data, update dates, etc. Metadata may be missing.

2. The Transparency function, available for raster data layers, allows you to adjust the transparency level between 0% (default) and 100%.
3. Click on the THEMATIC(S) and/or FILTER(S) tabs to display these panels.

4. Click Back to return to the Layers panel.

The Profile and user settings panel offers some basic functionality to customize JMap NG's interface.

1. Click on to open the Profile and user settings panel.

2. Click on if you want to edit your name.

3. If you want to change the app password, open the Modify password menu.

4. Enter your current password.

5. Enter the new password.

6. Confirm the new password.

7. Click Change to save the new password.

8. Select the Theme of the application.

9. In the Distance unit drop-down menu, select the unit that will apply to the scale and the distance and area measurements.

10. Click on to display the available languages and change the application's language. The change can take a few moments because it may involve changing the language of the application and data (layer titles, attribute names, tooltip content, etc.).

11. Click on Logout if you wish to log out of the session. You will return to the JMap NG login interface.

12. Click on to close the Profile and user settings panel or on another icon in the sidebar to open another panel.

You can export the map in different formats to print it or insert it in various documents. The tools to configure the map for this purpose are found in the Exportation / Print panel.

The Exportation / Print panel

The Exportation / Print panel contains the tools to configure the map.

1. Click on to open the Exportation / Print panel. The icon changes color .
2. Slide the map in order to have the area you wish to export displayed in the data frame.

3. Click Download to export the map into a file of the selected format. The name of the file is made up of the title of the map followed by the name of the project. The map image is high definition to ensure its high quality when printed.

JMap Cloud allows you to create spatial data sources (SDS) from various vector and raster file formats: CSV, KML, DXF, DWG, SHP, TAB, GeoPackage, FileGeoDatabase, GeoJSON, and GeoTIFF.

Files can be uploaded during the SDS creation process or uploaded in advance to JMap Cloud’s storage area. For more information, refer to the Uploading Files section.

Multiple Files and Continuous Maps

An SDS can include several vector or raster data files to form a seamless map. For instance, in CAD workflows, it is common to divide a territory into rectangular tiles. When all these files are read together, JMap Cloud can reconstruct a continuous map—as long as they share the same data structure (geometry, layers, and attribute types). In such cases, all files must be packaged into a single .zip archive.

Creating an SDS from Vector Files

1. Upload the files to JMap Cloud

2. Metadata analysis

3. Validation and configuration of SDS parameters

4. Once completed, the data and its configuration are stored in JMap Cloud’s databases.

Creating an SDS from Raster Files

1. Upload the raster file to JMap Cloud

2. The system analyzes and validates its characteristics

3. During SDS creation, the following processes are automatically applied:

   • Reprojection to EPSG:3857 coordinate system

   • Conversion to the optimized COG (Cloud Optimized GeoTIFF) format

   • Creation of a multi-resolution image pyramid for efficient display

The final image is optimized for fast navigation and stored in JMap Cloud.

Creating a spatial data source from files

Creating an SDS from Files

1. Go to the Data Sources tab and click Create a data source.

2. Select Vector/Raster data file.

3. 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.

Configuring SDS Parameters

• 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.

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.

Finalizing the SDS

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.

Files uploaded during SDS creation are listed in the Files tab. These files are automatically deleted from JMap Cloud after 10 days.

File settings

The table shows the general settings to configure when creating a DS from vector/raster data files.

You can start JMap NG App in a div of your website, or as a full page application.

Import library and application from CDN

You must import App js files from our CDN links (it will automatically load the JMap Core dependency).

  <script defer type="text/javascript" src="https://cdn.jsdelivr.net/npm/jmap-app-js@7_Kathmandu_HF3"></script>

Make sure the version of the library matches the version of your JMap backend (JMap Cloud or JMap Server).

Set library and application options

You have to provide required and optional parameters to the library and the app:

window.JMAP_OPTIONS = {
  projectId: 1,
  restBaseUrl: "https://jmapdoc.jmaponline.net/services/rest/v2.0",
  anonymous: true,
  map: {
    zoom: 8.468052241302663,
    center: {
      x: -74.049048172276,
      y: 45.53487085859891
    }
  },
  hideMainLayout: true,
  application: {
    containerId: "my-custom-app"
  }
}
}

More information about startup options here

Display the app in a div

Try it out in Codepen.io

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
    <meta charset="UTF-8">
    <style>
      #my-custom-app {
        position: relative;
        overflow: hidden;
        margin-left: 50px;
        margin-top: 50px;
        width: 850px;
        height: 700px;
        border: 1px solid grey;
      }
    </style>
    <title>JMap NG</title>
  </head>
  <body>
  	<div id="my-custom-app"></div>
    <script type="text/javascript">
      window.JMAP_OPTIONS = {
        projectId: 1,
        restBaseUrl: "https://jmapdoc.jmaponline.net/services/rest/v2.0",
        anonymous: true,
        map: {
          zoom: 8.468052241302663,
          center: {
            x: -74.049048172276,
            y: 45.53583011032552
          }
        },
        hideMainLayout: true,
        application: {
          containerId: "my-custom-app"
        }
      }
    </script>
    <script defer type="text/javascript" src="https://cdn.jsdelivr.net/npm/jmap-app-js@7_Kathmandu_HF3"></script>
  </body>
</html>

Display the map full screen

Try it out in Codepen.io

<!DOCTYPE html>
<html class="jmap_wrapper">
  <head>
    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
    <meta charset="UTF-8">
    <style>
      html,
      body {
        height: 100%;
        width: 100%;
        margin: 0px;
        padding: 0px;
      }
    </style>
    <title>JMap NG</title>
  </head>
  <body>
    <script type="text/javascript">
      window.JMAP_OPTIONS = {
        projectId: 1,
        restBaseUrl: "https://jmapdoc.jmaponline.net/services/rest/v2.0",
        anonymous: true,
        map: {
          zoom: 8.035870457975536,
          center: {
            x: -74.18791345871016,
            y: 45.55343159305562
          }
        },
        hideMainLayout: true,
      }
    </script>
    <script defer type="text/javascript" src="https://cdn.jsdelivr.net/npm/jmap-app-js@7_Kathmandu_HF3"></script>
  </body>
</html

The card for each layer contains information such as the name of the layer, the presence of thematics, etc.

To access the available tools, pass the pointer over the card of the layer you are interested in.

The Layers panel contains the details of the project's layers and tools for different functions such as controlling the display or making the elements of a layer selectable.

1. Click on to open the Layers panel. The icon changes color .

   Within a project, groups of layers appear in the panel in the form of cards. A group can be opened to display its subgroups and layers, or it can be closed to show only its name.

2. Click on the arrow in the card of a group to open it. The subgroups and layers it contains will be displayed.

   Each subgroup and layer has a card that presents different functions and details of the subgroup or layer. A subgroup is displayed using the icon, and a layer is displayed using an icon representing its style.

3. Click on to open the subgroup card and display the layers it contains. The icon changes to , indicating that the subgroup has been deployed.

4. Click on to close the subgroup card.

5. Click on to close the group of layers card.

6. Pass the mouse over a layer to display the available tools. The section offers details on these tools.

7. Select a base map from the BASE MAP group. The name of the selected map is displayed with the name of the group.

   The base map attributions display at the bottom of the map.

Filtering layers

To speed up the identification of the layers that interest you, you can apply a filter.

1. Click on to open the function Layer filters.
2. Enter characters in the range Layer Name to filter the layers based on their name.

3. Click on to open the Add a filter card.

4. Select the attribute from the Filter by list, the operator from the Operator list, and the value by which you want to filter the layers.

5. Click Add. The filter is displayed in the Layer filters box. Only the layers that pass the filter are displayed in the Layers panel.
6. Click on to apply the filter to the map. Only the layers which pass the filter and whose display is activated are displayed in the map.
7. Click on to remove the layer filter. The layers appear in the Layers panel. You must turn on the display of layers to view them in the map.

In this example, we will locate and select a feature on the map for a given location and on any selectable layer.

The default coordinates will select a feature on layer "Places", id=6.

Example

Try it out in

In this example, we will create a custom layer that fetches GeoJSON data from a file. It will display on top of all other layers.

The GeoJSON file for this example is located at this URL: .

Example

Try it out in

In this example, we will show how to add one or multiple attributions on the map in JMap NG.

Note that attributions are available in both NG Core and NG App.

Add a single attribution example

In the example bellow, we add a single attribution composed of one hyperlink forwarding to k2geospatial website.

Try it out in Codepen.io

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
    <meta charset="UTF-8">
    <style>
      #my-custom-map {
        width: 600px;
        height: 600px;
        border: 1px solid grey;
        margin-top: 1rem;
      }
    </style>
  </head>
  <body>
    <div id="my-custom-map" class="jmap_wrapper"></div>
    <script type="text/javascript">
      window.JMAP_OPTIONS = {
        projectId: 1,
        restBaseUrl: "https://jmapdoc.jmaponline.net/services/rest/v2.0",
        anonymous: true,
        map: {
          containerId: "my-custom-map",
          zoom: 13.797865986918877,
          center: {
            x: -75.48063889179525,
            y: 45.664231577062765
          },
          onStartupMapReadyFn: () => {
            JMap.Map.Attribution.addSingle({
              id: "custom-attribution",
              text: "© My custom attribution",
              href: "https://k2geospatial.com/jmap-en/"
            })
          }
        },
      };
    </script>
    <script defer type="text/javascript" src="https://cdn.jsdelivr.net/npm/jmap-core-js@jmap-ng-doc"></script>  
  </body>
</html>

Add multiple attributions example

You can add multiple attributions in one call.

In this example, we add two attributions, one composed of a hyperlink forwarding to stackoverflow website and the other composed of a random image forwading to an example domain.

Try it out in Codepen.io

<!DOCTYPE html>
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
  <meta charset="UTF-8">
</head>
<body class="jmap_wrapper">
  <script type="text/javascript">
    window.JMAP_OPTIONS = {
      projectId: 1,
      restBaseUrl: "https://jmapdoc.jmaponline.net/services/rest/v2.0",
      anonymous: true,
      map: {
        zoom: 9.573700695830425,
        center: {
          x: -75.48063889179525,
          y: 45.53690235213574
        },
        onStartupMapReadyFn: () => {
          JMap.Map.Attribution.addMultiple([{
              id: "custom-attribution-0",
              text: "© StackOverflow",
              href: "https://stackoverflow.com/"
            },
            {
              id: "custom-attribution-1",
              imageUrl: "https://picsum.photos/180/90",
              href: "https://example.com/"
            }
          ])
        }
      },
    };
  </script>
  <script defer type="text/javascript" src="https://cdn.jsdelivr.net/npm/jmap-core-js@jmap-ng-doc"></script>
</body>
</html>

This example shows how to toggle the visibility of a JMap layer on the map.

Try it out in Codepen.io

<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
    <meta charset="UTF-8">
    <style>
      #toggle-button {
        margin-bottom: 1rem;
      }
      #my-custom-map {
        width: 600px;
        height: 600px;
        border: 1px solid grey;
      }
    </style>
  </head>
  <body class="jmap_wrapper">
     <div>
       <span>Toggle layer visibility: </span>
       <button id="toggle-button">Wait the map is loading</button>
    </div>
  	<div id="my-custom-map"></div>
    <script type="text/javascript">
      window.JMAP_OPTIONS = {
        projectId: 1,
        restBaseUrl: "https://jmapdoc.jmaponline.net/services/rest/v2.0",
        anonymous: true,
        map: {
          onStartupMapReadyFn: function() {
            var button = document.getElementById("toggle-button");
            button.onclick = function () {
              const layerId = 4
              const currentLayerVisibility = JMap.Layer.isVisible(layerId);
              JMap.Layer.setVisible(layerId, !currentLayerVisibility);
            };
            button.innerHTML = "Toggle";
          },
          containerId: "my-custom-map",
          zoom: 8.794068040447577,
          center: {
            x: -73.66584749530894,
            y: 45.54275797936188
          },
          scaleControlVisible: true,
          scaleControlPosition: "top-right"
        }
      }
    </script>
    <script defer type="text/javascript" src="https://cdn.jsdelivr.net/npm/jmap-core-js@7_Kathmandu_HF3"></script>  
  </body>
</html>

A layer's style defines the graphical representation of spatial elements on the map. This representation can be unique for all elements or can vary depending on the values ​​of an attribute or the scale. Styles are defined by a set of rules, allowing for highly accurate and diverse representation of the layer's data.

Each layer can have different styles. For example, a layer can have one style for scales greater than 1:20,000 and another style for scales less than or equal to 1:20,000. It can also have a style that displays polygons representing city sectors, colored differently according to the crime rate in each sector.

You can enable or disable the configured styles so that they are displayed by default or not in JMap NG applications.

The Styles section, accessible by clicking on , provides tools to configure the layer's styles. The layer has a default style, of the Unique symbol type, which you can modify.

Unique Symbol

This style type represents map elements with the same symbology. The symbology can vary only depending on the scale.

Style name

The style displays a default name, which you can change by clicking on .

To the left of the style name, the checkbox allows you to enable or disable the style's display on the map. When the style display is enabled, it is displayed by default in the JMap NG application map.

Scales and zoom levels

These two components are associated and determine the scale range within which a symbology can be applied.

Scales are expressed in zoom levels. JMap Cloud offers 24 zoom levels: level 0 corresponds to the entire planet, while level 23, which is very detailed, corresponds to a specific point on the ground (part of a building, for example). Scales displays the values ​​0.0 → 23.0.

Zoom levels displays a bar with two points at the extremes of the range and two boxes displaying the zoom values ​​for those points, 0.0 and 23.0.

To set a scale threshold:

1. In Scales, hover over the values ​​0.0 → 23.0. The + icons appear over the numbers.

2. Click +. Scales calculates and displays the midpoint between the extremes, 0.0 → 11.5 → 23.0. Zoom levels adds a point 11.5 to the bar. You can adjust the value 11.5 by dragging the point on the bar or by typing the value in the box that displays it.

3. To add another interval, hover over the values ​​in Scales and click the + icon that appears near the value where you want to create the interval. Scales displays the new midpoint. For example, if you click on + near the value 23.0, Scales calculates and displays the midpoint between 11.5 and 23.0, which is 17.3, and then displayed intervals are 0.0 → 11.5 → 17.3 → 23.0. Zoom levels displays the same intervals on the bar.

4. In Scales, click one of the intervals to select it. The interval becomes active on the Zoom levels bar. The boxes display its extreme values.

5. Drag the points to change the interval thresholds or change the values ​​displayed in the boxes. The intervals update in Scales and Zoom levels.

6. To clear a threshold on Zoom levels, click . The information updates in both, Scales and Zoom levels.

Symbol

This section allows you to configure the symbol that represents the elements. As shown in the previous section, you can configure different symbols for each scale range.

Details on the composition of symbols are presented in the Vector features symbology section.

Unique Values

This style type represents map features with symbology that varies depending on the value of an attribute.

Style Name

The style displays a default name, which you can change by clicking on .

To the left of the style name, the checkbox allows you to enable or disable the style's display on the map. When the style display is enabled, it is displayed by default in the JMap NG application map.

Attribute

The drop-down list allows you to select the attribute to use in the style.

The attribute can be text, date, or quantitative and must have a maximum of 500 different values. Attributes exceeding this value are not available to define this style type.

Zoom levels

Zoom levels displays a bar with two points at the extremes of the range, along with two boxes displaying the zoom values ​​for these points: 0.0 and 23.0.

Select the zoom level threshold within which the style will be displayed in applications such as JMap NG.

You can drag the points on the bar or enter the values ​​in the boxes.

Conditions

Click the arrow to expand the Conditions section and display each of the attribute's conditions or unique values.

Click to display the available automatic color palettes. There are several palettes: miscellaneous, single hue, multi hues, divergent, and qualitative. Each palette maximizes the differences between the unique values. Click on the palette of your choice to apply it to the entire set of conditions.

Click the arrow for each condition to open its configuration interface. This varies depending on the geometry of the layer's elements. Details are presented in the Vector features symbology section. The symbology for each condition can be configured independently of the other conditions.

Click to edit the condition name and make the legend more understandable.

Click to clear the condition. The other conditions are not changed. The style does not display the cleared condition.

Vector features symbology

The components of the Symbol section vary depending on the layer's features.

Points

You can compose the symbol for point features by layering several different icons. Press + to add an icon to the symbol and to remove an icon from the symbol. Each icon adds a tab containing its parameters.

Lines

You can compose the symbol for linear features by layering several different line styles. Press + to add a line style to the symbol and to remove a line style from the symbol. Each line style adds a tab containing its settings.

Polygons

These are the parameters that define the symbology of polygonal elements:

Texts

The font is not editable. You can specify these parameters:

The tools found in the Measurements panel allow you to measure distances and surfaces (area and perimeter) on the map.

The Measurements panel

The Measurements panel contains the application's measurement tools.

1. Click on to open the Measurements panel. The icon changes color .

   1

   Tools to measure distances.

   2

   Tools to measure surfaces.

   3

   Tools to measure circular surfaces.

   4

   Tools to: - Indicate the number of measurements performed, - select measurements to edit or delete them, or - delete all measurements.

   5

   Instructions on how to make measurements.

2. Select the measurement tool you wish to use by clicking on its icon. The icon changes color. The Measurement tools section explains the features of these tools and how to use them.

3. Make your measurements. You can use the different tools; the measurements will all be added to the map, and the distances and/or areas measured will be displayed in the card of the corresponding tool. The total number of measurements made is displayed in the panel.