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.

Coming soon.

Welcome to the Documentation Hub for:

• JMap Cloud Portal

• JMap NG

• JMap Cloud API

• JMap Cloud Extensions

Coming soon.

JMap NG is an interactive mapping application that allows you to visualize JMap Cloud projects, explore geographic data, and edit spatial and descriptive information.

JMap NG provides a range of tools that enable you to interact with and make full use of the application’s data.

A JMap Cloud administrator in your organization will send you an email invitation to join JMap Cloud Portal. This email contains a link directing you to the account creation page.

The account creation interface displays your email address and a field where you can define your password according to the specified requirements.

Once you have entered your password, click Continue to proceed with the login process described in the next section.

If you already have an account, simply click Sign in to access the platform directly.

After your account has been created, you can access JMap Cloud Portal in two ways:

• By visiting the main website: and clicking Sign in

• By going directly to:

Signing in to JMap Cloud Portal

1. Click Sign in to open the authentication page.

2. Enter your email address and password, then click Continue.

3. If you are a member of more than one organization, a window will prompt you to select the organization you want to connect to. Click the corresponding button to access that organization’s JMap Cloud Portal.

The home interface displays the , which summarizes the platform resources available to you according to your permissions.

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

Organization management is performed in the Organization section of JMap Cloud Portal, which is divided into several tabs:

• General

• API Keys

Each tab contains settings and tools that allow administrators to efficiently manage the organization’s resources and members.

This section allows you to define your organization’s name and copy its unique identifier.

• Enter the organization 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 copy icon .

The unique identifier is used, among other things, to establish connections between JMap Cloud and other systems within the organization, such as JMap Server. For more details, see the .

You can open the project in Studio, the section of JMap Cloud Portal that provides the tools needed to create and configure the project's layers and data.

To do so:

1. Click the menu icon , then select Open in Studio.

The Configure project data section opens, giving you access to all the settings related to the structure and content of the project.

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 provides robust cloud services and APIs that facilitate the integration, visualization, and querying of heterogeneous geospatial data from multiple formats (vector, raster, web services) and sources (OGC services, local files, etc.), as well as the various mapping applications that connect to the platform.

The platform is built on containerized microservices that are interoperable and scalable. It complies with industry standards in the geospatial domain (OGC, GeoJSON, WMS/WFS, etc.), ensuring seamless interoperability with existing GIS systems and business applications.

The following diagram illustrates the JMap Cloud architecture, including its main services (authentication, data management, map rendering, etc.), its possible connections with an organization’s information systems (databases, internal web services) through JMap Server, and the front-end interfaces used by end users through mapping applications. The architecture diagram on page 2 shows these components and their interactions.

JMap Cloud Portal is the platform’s web-based management interface. 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 permissions

• Monitor the technical ecosystem connected to JMap Cloud

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

You can delete a layer or a layer group from the project at any time.

To delete a layer or a group:

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

2. Click the Delete icon . If you delete a layer, it will immediately be removed from both the map and the Layers section. If you delete a group, it will disappear from the Layers section, and all layers it contained will be moved to its former position in the list, outside of the group.

This function restores the map to its default layer visibility settings.

While configuring a project, you may enable or disable certain layers to facilitate your work. When you click the Reset display icon , the map returns to its original display state based on the default visibility settings of each layer.

Sharing your organization’s data with other organizations can be useful when you want to use the same data without duplicating it.

If other organizations are also using JMap Cloud, you can identify them in JMap Cloud Portal and make them available for resource sharing.

This tab allows you to add organizations to your organization’s JMap Cloud environment.

Steps

1. Click Add Organization to open the configuration window.

2. Enter the organization’s ID. An administrator from that organization must provide this information.

Once the identifier is validated and the organization approved, its name appears in the tab.

Editors in your organization can then share their data sources with approved organizations. Sharing is configured in the section of the data source.

Data sources shared by approved organizations appear in the Data Sources section.

If an organization is removed from the list of approved organizations:

• All permissions granted to data sources are removed.

• Data sources shared by that organization are also removed.

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.

Layer groups help organize project layers in a clearer, more structured way, based on various criteria such as theme (sewer network, transportation, regulations, etc.), time period (current year, archive, etc.), or other organizational needs.

To add a layer group to the project:

1. Click the Add Group icon. A new group named Layer group will appear in the Layers section.

2. Double-click the group name to edit it. Click on each language label to enter the name in the supported languages.

3. Select the layer you want to add to the group.

4. Press the layer’s icon , then drag and drop it into the desired group.

You can open a project in the JMap NG application to explore its content and fine-tune its configuration before making it available to end users.

To do so:

1. Click the menu icon, then select Open in JMap NG. The JMap NG application will open in a new tab, displaying the selected project.

2. Log in using your JMap Cloud Portal credentials.

3. Navigate through the map and explore the available features.

   JMap NG is the map application used by users with the Viewer role to access shared projects. For more details, refer to the .

4. To close the application, click the icon and select Log out.

Two tools allow you to manage how layers and layer groups are displayed:

• One tool lets you turn the display on or off for a layer or group on the map.

• The other allows you to enable or disable the visibility settings configured for the layer or group. These settings are described in detail in the Properties section.

To access these functions:

1. Hover over the desired layer or group to reveal the action icons.

2. Click the or to turn the display on or off for the layer or group.

3. Click the or to enable or disable the application of visibility settings n the project layer configuration.

This guide describes the main steps involved in publishing data through a JMap Cloud mapping application, whether public or restricted.

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

Only Administrators and Editors can access JMap Cloud Portal, the platform’s data management interface. Some management operations, however, are restricted to administrators.

Viewers, on the other hand, access only the mapping applications that publish the data, such as JMap NG Cloud.

The diagram below illustrates the general workflow and highlights the roles involved at each step.

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

This section displays the extensions that add specific functionality to JMap Cloud projects.

Each extension is displayed as a card containing the following information:

• Extension name

• Publisher organization

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

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

When many layers are visible in a project, the map may become harder to read.

The Focus mode allows you to display only one layer at a time, without having to manually turn off the others. So you can configure the layer without interference from other layers.

Once this mode is enabled, only the selected layer is shown on the map. You can easily switch the focused layer or turn off Focus mode to return to the default view.

To use Focus mode:

1. Click the

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

A project consists of an ordered list of map layers and non-spatial tabular data. JMap Cloud mapping applications open these projects to display their content. You can create as many projects as needed to meet your requirements.

Each layer in a project is linked to a , which provides the data for the layer. It is possible to:

• reuse the same data source across multiple projects, each with different styles or filters,

Projects that you have created (and therefore own), as well as those for which you have access permissions, are displayed in the Projects section.

Two display modes are available:

• The table view, similar to the one used for other resources in JMap Cloud Portal

• The card view, which displays projects as tiles

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 update the data of a vector/raster spatial data source or a non-spatial data source. This process allows you to replace the file that provides data to the data source (DS).

1. Open the Update Interface

Select the Update Data function to access the interface where you can:

• upload a new file,

Each layer's configuration panel provides tools to define general properties, styling, labels, and tooltips. The available options vary depending on the type of layer—vector or raster.

Icons allow you to access each of these sections.

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.

This section displays a table of member groups and provides a button for creating new groups.

When an organization has many members, grouping them according to specific criteria simplifies permission management.

The table displays each group’s name and the number of members it contains.

The Dashboard is the home section of JMap Cloud Portal. As its name suggests, it provides an overview of resources such as projects and data sources, and also allows some resources to be created directly.

The dashboard interface presents several cards summarizing the organization’s resources.

The layer order on the map determines how layers are drawn on top of each other. The bottommost layer is rendered first, followed by the one above it, and so on, until the top layer, which is drawn last.

This order is important because it affects layer visibility, depending on the transparency or type of the layers. For example:

• A raster layer placed at the top may obscure those beneath it.

You can set the project’s initial extent, meaning the geographic area displayed by default when the project is opened in a JMap NG application or in Studio.

To set the initial extent:

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

2. Click once to start drawing the rectangle.

To view or modify a project's settings:

1. Click , then select Settings. The project configuration interface will appear.

2. Make the desired changes to the settings. All settings are editable.

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

Spatial data appears in the project’s Layers section.

Tabular data appears in the

The layer order in the Layers panel of Studio and JMap NG helps improve usability, especially in projects with a large number of layers.

To rearrange layers in the panel:

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

To display layer information:

1. Click the menu icon, then click More information to open the GENERAL panel. Displayed parameters:

• Number of features visible on the map (varies depending on navigation).

Get started with JMap NG by following these steps:

• Log in – Access the application using your credentials.

• Explore the Interface – Become familiar with the user interface.

The Layers section provides various tools to help organize the project’s layers, making it easier for end users to interact with the map in JMap applications.

Each layer and layer group also includes display controls, allowing you to manage what appears on the map.

Specifically, you can:

• Define the display order of layers on the map.

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

1. Click the menu icon, then click Show layer extent. The map automatically zooms to the layer’s geographic extent. A rectangle outlining the extent briefly appears.

2. Click the Back icon to return to the previous geographic extent.

Users of JMap NG applications can, depending on their permissions, create or modify data. 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,

You can delete a project if you have Ownership permission.

Deleting a project also removes its map layers and all related configurations.

To delete a project:

1. Click , then select Delete. A confirmation message will appear.

To use certain functions such as interactive selection, you must first make the layer features selectable.

1. Hover over the layer card to display the Selection icon .

2. Click the Selection icon to make the features selectable. The icon remains visible on the card.

You can edit data in map layers (spatial data) as well as in tables (non-spatial data).

Types of Editing – Map Layers

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:

or

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.

Filters can be applied to display only the layer features whose attributes match certain criteria.

Your organization’s administrators have configured filters to allow you to quickly display specific features of interest.

If a filter is applied to a layer by default, the Filter icon is displayed.

Managing Filters

JMap NG projects can contain two types of data: spatial data and non-spatial data.

Spatial Data

Spatial data is organized into map layers. Each layer contains data on a particular theme. These layers are overlaid to form the map displayed in the interface.

Types of Cartographic Layers

Vector Layers

Vector layers are composed of features represented by geometries (points, lines, polygons) and descriptive attributes.

Example: A tree layer represented by points, with attributes such as species, diameter, height, and health status. Each tree thus has a geographic position and characteristics that describe it.

Raster Layers

Raster layers are composed of pixel-based data forming images, such as aerial photographs, satellite imagery, and digital terrain models.

Hierarchical Organization

Layers can be grouped hierarchically by theme: urban planning, environment, transport, etc. This multi-level structure facilitates navigation when projects contain numerous layers.

Base Maps

Base maps provide a visual context for presenting your data. Your interaction is limited to selecting which base map to display.

Non-Spatial Data

Non-spatial data in the project is organized into tables. This tabular data can be linked to map layers or be completely independent.

A table contains rows (records) and columns (fields or descriptive attributes).

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>

This section displays a table listing all API keys configured for your organization.

For each key, the table displays the following information:

• Title

• Unique identifier (ID)

• User who created the key

• Creation date

• Expiration date

A contextual menu in each column header allows you to sort, filter, hide, or display attributes according to your needs.

Adding an API Key

1. Click Add Key.

2. Enter a name and expiration date, then choose the role assigned to the key (only Editor and Viewer roles are available). Fields marked with an asterisk (*) are required.

3. Click Create.

A message reminds you that the key is private and will no longer be accessible after the window is closed.

Make sure to copy it immediately using the copy icon if you need to use it elsewhere.

Click OK to complete the creation. The key is then added to the table.

Managing API Keys

To manage an API key, hover over its row to display the contextual menu, then click it to access the available options:

• View information

• Delete

The information view displays:

• Title

• Creator

• Role

• Email address

You can copy the email address using the copy icon.

Deleting an API Key

You can delete API keys that are no longer needed. However, be aware of the implications: a key may own resources such as data sources, projects, layers, or tables.

Before deleting a key, make sure to transfer ownership of its resources to another member of the organization. Otherwise, the resources will be deleted along with the key.

Deletion steps

1. Click the menu and select Delete.

2. Confirm your intention in the dialog box.

3. If the key owns resources, a list of members with the Editor role will be displayed. Select the member to whom the resources will be transferred.

The selected member becomes the owner of all transferred resources. Access permissions associated with the deleted key are removed.

Web Map Service (WMS) and Web Map Tile Service (WMTS) are two standards defined by the Open Geospatial Consortium (OGC). They specify how applications should send requests to obtain maps from compatible servers.

WMS servers use the HTTP protocol to return map images in common raster formats such as PNG, JPEG, or GIF.

Server capabilities are described in an XML document that outlines the supported request types, available layers, supported projections, and other metadata.

WMTS servers, on the other hand, deliver maps as predefined tiles, enabling faster and more efficient rendering, particularly for large-scale navigation.

JMap Cloud can query servers that comply with either the WMS or WMTS standard to create spatial data sources, allowing you to integrate external map layers into your projects.

The settings you need to complete are as follows:

This section displays a table of organization members and includes a button to invite new members to JMap Cloud.

For each member, the table displays:

• Name

• Identifier

• Email address

• Role

• Groups the member belongs to

A contextual menu available when hovering over a member’s name allows you to perform actions such as viewing information, editing properties, or deleting the member.

Another contextual menu in the column header allows you to sort, filter, hide, or display table attributes.

Adding a Member

To invite someone to join your organization:

1. Click Invite Member.

2. Enter the person’s email address.

3. Select the role and groups to assign to the member.

A message confirms that an invitation email has been sent.

If needed, you can copy the invitation link using the copy icon .

Close the window. The invitation will appear in the Invitations tab.

Viewing and Editing Member Information

1. Hover over the member’s name and open the contextual menu.

2. Select Display Information to see details such as name, email, role, and groups.

3. Click Update to update the member’s role or groups.

Deleting a Member

Members with the Administrator or Editor role may own resources such as data sources or projects.

When deleting such a member, you must decide what happens to those resources.

Steps

1. Click Delete.

2. Select Transfer ownership to, then choose another member from the list to receive the resources.

3. Click Delete to confirm.

Effects:

• The member’s access permissions (ACL) are removed.

• The selected member becomes the new owner of the resources.

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

• The member is deleted.

• All resources owned by the member (and their dependencies) are also deleted.

• Associated permissions are removed.

Deleting a member prevents them from signing in to JMap Cloud.

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.

Creating a DS from Tabular Data Files

Creating a data source is done in several steps:

1. File selection

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

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

3. Choose between:

2. Uploading

When uploading a new file, JMap Cloud automatically analyzes its metadata (format, structure, data types, etc.) before displaying the configuration window.

If you choose an existing file, the analysis has already been completed and the configuration window opens immediately.

3. Configuring DS Parameters

For details on the configurable options, refer to the section.

You may also add a description and tags to help filter and organize your data sources. To create new tags, simply type them into the Tags field.

4. Finalizing the DS

Click Create to launch the process. The new data source will appear in the list. Its status will first display as Preparing, then switch to Ready once the process is complete.

Once a data source is created for a file, the file is no longer required as the data is transferred to the JMap Cloud databases. All uploaded files are automatically deleted after 10 days.

File Settings

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

Roles in JMap Cloud define user categories, each associated with a specific set of permissions for accessing and modifying an organization’s resources.

Each organization member is assigned one of the following roles:

• Administrator

• Editor

• Viewer

These roles determine which features are accessible and which sections are visible in JMap Cloud Portal.

Only Administrators and Editors can sign in to JMap Cloud Portal. Viewers interact only with the applications that publish the data configured in the portal.

The diagram illustrates the relationship between these roles.

Administrator

The Administrator is responsible for managing the organization in JMap Cloud Portal, including users, API keys, and organizational settings.

Administrators can:

• Create, modify, and delete API keys

• Configure organization settings

• Invite new members

• Manage member roles (assignment and modification)

All these functions are available in the Organization section. The chapter describes each function in detail.

Administrators can also quickly create API keys directly from the .

Administrators also inherit all Editor privileges.

Editor

The Editor does not have access to administrative functions but is responsible for configuring projects published through JMap NG applications.

Editors can create, configure, modify, and delete the following resources:

• Data sources

• Projects

• Map layers and non-spatial data tables

• Forms

These tasks are performed through the , , , and sections of the portal.

Editors also inherit all Viewer privileges.

Viewer

The Viewer is an end user who accesses data through JMap NG applications and does not have access to JMap Cloud Portal.

Viewers can:

• View projects and their data

• Navigate the map and interact with data (selection, information display, etc.)

• If permissions are granted, edit geometries and/or attributes of a layer or non-spatial data table.

This section allows you to create and manage invitations for people who want to join your organization on JMap Cloud.

A table lists all invitations sent from this tab or from the Members tab, displaying:

• Invitation ID

• Sender email

• Recipient email

• Creation date

• Expiration date

A contextual menu allows you to view details or delete an invitation.

Another menu in the column header allows you to sort, filter, hide, or display columns.

Inviting a Member

1. Click + Invite Member.

2. Enter the recipient’s email address.

3. Select the role (Administrator, Editor, or Viewer) and the groups assigned to the member.

A window confirms that the invitation was sent. You can copy the invitation link using the copy icon .

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

Invitations expire after 7 days.

Viewing or Deleting an Invitation

1. Open the menu on the invitation row.

2. Select Display Information to display details such as:

   • Guest email

Invited Members

The invited user receives an email from JMap Cloud containing:

• The sender’s name

• The invitee’s email address

• The organization name

• An invitation link

By clicking either link, the user is redirected to the Accept Invitation page where they can define a password and .

• If the invited user receives the Administrator or Editor role, they can access JMap Cloud Portal.

• If they receive the Viewer role, they can access projects through JMap NG applications, depending on their permissions.

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.

This feature allows you to filter the features from a data source so that only those meeting specific criteria are included in the layer. This enables you to create multiple layers based on the same data source, each showing a distinct subset of features.

Filtering is done using conditions. Only features that satisfy the defined conditions will be displayed in the layer.

The Filters section, accessible by clicking the icon, allows you to configure the conditions applied to the layer.

Filter operators

The operator filters DS elements to conserve in the layer the elements whose:

equals: attribute value (regardless of its type) is equal to one of the specified values.

does not equal: attribute value (regardless of its type) is different from the selected values.

greater than: attribute value (numeric or date) is greater than the selected value.

greater or equal to: attribute value (numeric or date) is greater than or equal to the selected value.

less than: attribute value (numeric or date) is less than the selected value.

less or equal to: attribute value (numeric or date) is less than or equal to the selected value.

contains: attribute value (text) contains the selected value.

does not contain: 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: attribute value (regardless of its type) is null.

is not null: attribute value (regardless of its type) is not null.

is between: attribute value (numeric or date) is within the range defined by the two entered values.

is not between: attribute value (numeric or date) is not within the range defined by the two entered values.

The Profile and User Settings panel lets you customize your experience in JMap NG.

Access Your Settings

To access the settings, click the User icon in the sidebar to open the Profile and User Settings panel.

Edit Your Profile

Change Your Name

Click the icon next to your name to edit it.

Change Your Password

1. Open the Change password menu.

2. Enter your current password.

3. Enter your new password.

Customize the Interface

Application Theme

Select your preferred theme (light, dark, etc.).

Measurement Units

Select your preferred distance units from the dropdown menu. These units will be applied to the map scale as well as distance and area measurements.

Application Language

Click the icon to display the available languages and change the application language.

Sign Out

Click Sign Out to close your session. You will be redirected to the JMap NG login page.

Close the Panel

Click the arrow to close the Profile and User Settings panel, or click another icon in the sidebar to open a different panel.

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.

Access the Application

You can access JMap NG from any modern web browser (Edge, Google Chrome, Firefox, Safari) using the URL provided by your organization.

First Login

If the app has controlled access, you will receive an email invitation to join your organization on JMap Cloud. To activate your account:

1. Respond to the invitation.

2. Create a password to complete your profile.

3. Log in with your credentials.

Select a Project

Once logged in, the home interface allows you to select the project you wish to view.

The default interface language is based on your web browser’s language.

1. Click the language icon at the bottom to change JMap NG's display language.

2. Use the search field to quickly filter and find your project.

3. Click a project to open it.

The JMap NG version and the connected JMap product (e.g., JMap Cloud) are displayed at the bottom of the page.

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

The Studio interface is accessible from the project menu by selecting Open in Studio.

The following sections describe the available features in detail.

Layers can have different styles: the appearance of features varies based on one or more attributes.

When a layer has multiple styles, the number of configured styles appears on the layer icon. You can display multiple styles simultaneously, and styles may vary depending on the map scale.

Managing Layer Styles

1. Click the layer icon or click the menu icon, then select Styles. The STYLES panel displays the layer styles with their legend.
2. Use the toggle switch to enable or disable each style. The appearance of features changes accordingly.

3. Uncheck one or more classes or categories within a style to hide features belonging to those classes.

4. Click the Expand/Collapse icons to open or close the style card.

5. Click Back to return to the Layers panel.

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 .

The configuration panel for each non-spatial data table provides tools to define the general properties of the table as it will appear in the JMap NG application.

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 JCoreExtension or JAppExtension) 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 JCoreExtension, and a onPanelCreation implementation if implementing JAppExtension.

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 .

Some map features display an information tooltip when you click them.

The tooltip may contain attribute information such as text, hyperlinks (to open documents or videos in their native applications), photos, 360-degree photos, and more.

Sometimes, features from multiple overlapping layers have tooltips. In this case, when you click a feature, the tooltip displays the information for each overlapping feature. The content from the topmost layer is displayed first, followed by the content from the underlying layers. The order of the information in the tooltip reflects the drawing order of the layers.

If you have permission to edit the layer, the Edit icon provides access to the editing functions for which you have permission. Otherwise, this icon is not displayed. See the Edit Data section for more details.

Tooltips are not persistent and are displayed for one feature at a time.

To display a tooltip :

1. Click the feature for which you want to display the tooltip. The tooltip appears automatically.
2. Click a photo to enlarge it and display its subject and description.

   • Use the zoom controls

You can select which layers to display on the map. For a layer to appear, you must first enable the display of the group and subgroups that contain it.

1. Enable the group : Toggle the switch on the group card from Off to On.

   Note: If a group’s display is disabled, its layers will not appear, even if the subgroup display is enabled. Example: In the figure, the display of the ENVIRONMENT group is disabled. Even if the Ecological Interest subgroup is enabled, the group’s layers will not be displayed. The Disabled Display icon appears when a layer’s display is turned off. Example: Road Network.

2. Enable the layer : Click the display icon to enable it. The icon disappears and the layer appears on the map.
3. Disable the display : Hover over the layer card and click the display icon .

Display Based on Scale

Some layers are configured to display only within a specific scale range. Displaying a very large number of small features at a small scale (zoomed out over a large territory) may reduce map readability.

Layers that are not displayed due to scale appear in a lighter color. When you change the scale, the color become darker, indicating that the layer is displayed (if its display is enabled).

You can modify non-spatial data displayed in tables if you have the required permissions.

Create a Record

To create a new record in a table:

1. Click the Add icon to open the form.

2. Enter values for each field in the form.

   Some fields displayed as dropdown lists may include an empty option, allowing you to assign a null value.

   If the form allows it, you can attach documents or URLs by clicking the Add button. The maximum file size is 20 MB.
3. Once the form is complete, click Create to finalize the record. The new record appears in the table.

Modify a Record

To modify a record:

1. Hover over a record to display the Edit icon , then click it.

2. In the Update Record window, modify the desired field values.

3. If necessary:

Delete Records

To delete one or more records:

1. Select the records to delete.

2. Click the Delete icon . A confirmation message appears.

You can export the map in various formats in order to print it or insert it into other documents. Configuration tools are available in the Export / Print panel.

To open the Export / Print panel, click the Export / Print button .

The Export / Print Panel

The panel includes the following configuration options:

Title – Enter the map title. It is displayed in real time in the preview.

Subtitle – Enter the map subtitle. It is displayed in real time in the preview.

Paper Size – Select the paper size from the dropdown list. The layout updates in real time.

Scale – Enter a scale value. The map updates in real time. You can also adjust the scale directly in the map interface.

Orientation – Select the paper orientation from the dropdown list: Portrait or Landscape. The layout updates in real time.

File Type – Select the export format from the dropdown list: PNG, JPEG, or PDF.

Date – Select this option to display the date on the map.

North Arrow – Select this option to display the north arrow on the map.

Scale Bar – Select this option to display the scale bar on the map.

High Resolution – Select this option to export the file in high resolution.

The frame displayed in the center of the map interface represents the area that will be exported. It is fixed, and its dimensions vary depending on the selected paper size and orientation.

Export the Map

1. Configure the desired options in the Export / Print panel.

2. Move the map and adjust its scale so that the desired data appears within the export frame.

3. Click Download to export the map in the selected format.

Non-spatial data is displayed in table format, within the TABULAR DATA group of the Layers panel.

Opening a Table

In the Layers panel, click the table’s menu icon, then select Open Table. The table opens within the map interface.

Table Structure

• Each row represents a record.

• Each column represents a field (attribute).

• Total rows indicates the number of records currently displayed.

Available Functions

• Filtering Records : Use the toggle switches / to enable or disable filters. Only records that match the active filter criteria are displayed.

• Editing (if permitted) : If you have the appropriate permissions, the editing icons and are enabled. See the section for more details.

Closing the Table

Click the Close icon to close the table and return to the map.

The JMap Cloud Portal graphical interface includes the following components.

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:

Each layer card contains information such as the layer name and the configured styles.

To access the available tools, hover over the layer card.

Layer Components

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 locate and select features on the map, for a given postal code.

In the example dataset, we will use the layer "Places", id=6. We will search on the postal code attribute (CODE_POSTA), and return all places having the given postal code.

Example

Try it out in Codepen.io

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

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

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 for quick search

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

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

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. The Value and Label columns appear. All values present in the data are automatically added.

2. Click + to add a row.

3. Enter the value and its label.

You can:

• Remove a value that is not present in the data by clicking the icon

• Delete the entire domain by clicking Delete Value Domain

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

Click to save or to cancel your changes.

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

To create a project:

1. Click Create a new project.

2. Fill in the required project settings (name, description, etc.).

Once created, the project will appear in the Projects section.

In both card and list views, an options menu is available for each project. It allows you to (edit, duplicate, delete, etc.).

Project settings

You can grant permissions to other members, groups, or API keys from JMap Cloud for the projects you own.

There are three levels of permissions, based on user roles. These permissions are hierarchical: the highest level automatically includes the other two.

Granting Permissions

To grant permissions for a project:

1. Click , then select Permissions. The permissions configuration interface opens, showing each member and their associated permissions. A letter indicates each member’s role.

2. To add a new member, open the dropdown in the Add a member section.

3. Select the relevant members, groups, or API keys. You can clear the selection by clicking .

Modifying Permissions

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

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

2. Modify permissions by checking or unchecking the appropriate boxes.

3. To remove all permissions from a member, uncheck all three boxes. If you uncheck Ownership, the Edit permission will automatically become the highest one assigned.

Vector tiles are a highly efficient format for web mapping. The core concept is to divide a project's vector data into tiles, similarly to raster tile systems (e.g., WMTS).

There are several standards for producing vector tiles. Mapbox introduced a format based on Google’s Protocol Buffers encoding ( https://developers.google.com/protocol-buffers). Known as MVT (Mapbox Vector Tiles), this format is widely supported by mapping tools including JMap Cloud, JMap Server, and JMap NG.

A tiling grid is applied to vector data, dividing it into tiles. Each tile can include features from multiple layers. A full set of tiles is generated for each zoom level. In web mapping, there are typically 23 levels:

• Level 0 represents the entire Earth

• Level 23 corresponds to street-level detail

Lower zoom levels use simplified geometry to reduce file size and improve performance.

Vector features (lines, polygons) are clipped at tile boundaries. When a geometry spans multiple tiles, it is split, and each tile stores only its part. The mapping application is responsible for reconstructing the complete geometry.

Feature attributes are embedded in the tiles, allowing dynamic and interactive data usage—for example:

• generating thematic maps on-the-fly

• applying attribute-based filters

Styles are not included within the tiles. Instead, they are defined in a separate JSON file. This allows applications to dynamically style data, eliminating the need to regenerate tiles when styles change.

Vector tiles can be generated on-the-fly or pre-generated and cached, significantly improving server response times and ensuring smooth user experiences.

Vector Tile Generation in JMap Cloud

A JMap Cloud project produces three types of data consumed by client applications:

1. Style JSON File This file accompanies the vector tiles and contains layer definitions, styles, thematics, etc.

2. Vector Tile Set (MVT) These tiles contain the geometry and attributes of non-editable layers. They can be generated:

   • on demand, as users navigate in JMap NG

Performance Factors for Vector Tiles

While vector tiles are generally lighter than raster tiles, several factors can affect tile size and impact JMap NG application performance:

• Number of attributes per layer More attributes increase tile size and load times.

• Layer visibility scales For dense layers, it is recommended to limit their visibility to higher zoom levels. This reduces data volume in low zoom tiles and accelerates tile generation.

• Caching Pre-generating and caching tiles greatly enhances performance.

Managing a Project’s MVT Cache

To manage a project’s vector tile (MVT) cache:

1. Click , then select MVT Cache to open the management interface. This interface includes four sections.

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 .

The Layers panel lets you configure the map displayed in the application. It contains:

• Details of the project layers with tools to control display and selection

• Base maps

• Tabular data

Using the Layers Panel

Select Map Data

1. Click the Layers icon to open the panel. Layer groups are displayed as cards. Each group can be open (displaying subgroups and layers) or closed (displaying only the name).
2. In a group card, click to open it and display the subgroups and layers it contains. Subgroups are indicated by the Subgroup icon , while each layer has its distinctive icon.

3. Click the Group icon to open a subgroup and display its layers. The icon changes to

Access Tabular Data

In the TABULAR DATA group, click the menu icon, then select Open Table to display the table in the interface.

Select a Base Map

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

Base map attributions are displayed at the bottom of the map.

Filter Layers

To quickly find the groups, layers, and tables you're interested in, you can filter the panel content.

1. Click the Filter icon to open the Layer filters function.
2. Enter text in the Layer name field to filter groups, layers, and tables. The panel displays only those whose names contain your search terms.
3. Click the Execute icon

You can create custom maps in JMap NG to save them and share them with other users or external applications.

A custom map reproduces a specific map environment, including layers, styles, scale, measurements, annotations, and selected features.

All operations related to custom maps are performed from the My Maps panel.

To open it, click the My Maps button .

The My Maps Panel

The panel includes the following elements:

1. Add Map – Create a new custom map (see the section).

2. Filter – Filter maps by entering keywords (searches in the title and description).

3. Sort By – Sort maps by creation date or title. Select an option from the dropdown list, then choose ascending or descending order.

You can also edit a map’s title and description directly from its card:

1. Click the title or description to activate editing.

2. Make the desired changes.

3. Click the Save icon to apply the changes or the Discard icon to discard them.

To display a map, click its card in the My Maps panel.

Create a Custom Map

To create a new custom map:

1. Open the My Maps panel.

2. Click Add to open the creation interface.

3. Enter a title in the Title field (required).

Share a Custom Map

To share a custom map:

1. Open the My Maps panel.

2. In the desired map card, click the Share icon to open the sharing options.

Two options are available:

• Share Map – Generates a URL for the custom map. The icon indicates that sharing is enabled.

• Share Map and Copy Link – Generates the URL and automatically copies it to the clipboard. A confirmation message appears. The icon indicates that sharing is enabled.

You can send this link to other users who, depending on their access rights, can open a JMap NG application displaying your custom map (including its measurements, annotations, and selected features).

Disable Sharing

To disable sharing:

1. Click the Share icon to display the sharing options:

   • Stop Sharing – The link will no longer be active.

   • Copy Share Link – Copies the existing share link to the clipboard.

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

Import the library from CDN

To use the JMap NG Core library, simply import the JMap NG Core Javascript library from our CDN link.

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

Make sure the version of the library matches the version of your JMap Server instance.

Set library options

You have to specify options to the library:

More information about startup options

Display the map in a div

Try it out in

Display the map full page

Instead of running JMap NG Core inside a DIV, you can start it directly in the body of the web page for a full page experience.

Try it out in

You can upload files to JMap Cloud to use them later when creating data sources. The Files tab, located in the Data Sources section, provides tools to upload and manage your files.

The content of uploaded files is stored in JMap Cloud’s databases. However, files listed in the Files table are automatically deleted after 10 days.

Files Tab

This tab displays a table of all the files you’ve uploaded. A button is available to let you upload new files.

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.

Creating a Spatial Data Source from Files

Creating an SDS is done in several stages:

1. Selecting the file

Labels are texts associated with map features. They are used to display information about features directly on the map. For example, you can use labels to show city names from a point layer representing urban areas.

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

JMap NG offers several ways to navigate the map and explore your data:

• Search for a specific location

• Search for features in the project (simple search)

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

The Measurements panel contains all measurement tools available in the application.

To open the panel, click the Measurements button . The icon changes color .

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

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