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.) as well as the various cartographic applications that can connect to the platform.

The platform is built around containerized, interoperable, and scalable microservices, 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) via JMap Server, 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.

Coming soon.

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.

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.

Coming soon.

You can create data sources (DS) from five types of support:

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

• Non-spatial tabular data files

• WMS/WMTS services

• Vector tile services

• Feature services

The Data sources tab allows you to create and manage the data sources you will use in your projects.

This section displays a table listing the data sources you own, as well as those you have permission to access. For more details on access and resource management, see the section.

Each data source appears as a row in the table. The columns provide the following information:

• Name of the data source

• Source type

• Status

• CRS (Coordinate Reference System)

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

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

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 globally for your organization.

Extensions enabled for your organization can be added to .

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.

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.

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:

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

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.

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.

3. Click Update to save your changes.

   The modification date will appear in the

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.

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.

2. Once confirmed, the project is permanently removed from the Projects 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.

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.

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

To access these functions:

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.

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 section opens, giving you access to all the settings related to the structure and content of the project.

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.

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.

• Set the layer order in the Layers panel of Studio

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,

• 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 name and tags;

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

• Delete: Permanently removes the form.

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

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>

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.

3. Draw the desired area, then click again to finish.

4. Click the confirmation icon to save the extent.

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:

   • New File: to upload a file from your local device.

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.

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 Tabular Data section.

Once the data is added, you can organize and configure the layers as needed.

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

You can switch between these modes using the corresponding icons, and .

In table view, you can sort and filter projects by name or last modified date.

For each project, the following information is displayed:

• Project name

• Number of layers

• Visibility (public or private)

Each project includes an options menu that gives access to the following management functions:

The following sections describe each of these features in more detail.

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

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.

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.

• A polygon layer can hide point or line layers if it’s rendered afterward.

To change the layer order on the map:

1. Click the Layer Order icon to activate the tool.

2. In the Layer Order window, select the layer you want to move by clicking its name or the drag icon (arrows) to its left.

3. Drag the layer to the desired position and drop it.

The map updates automatically to reflect the new order.

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 Focus Mode icon to enable the feature.

2. Click the name of the layer you want to display alone. The layer configuration panel opens, and only that layer is displayed on the map.

3. Click the back arrow to return to the Layers panel. All visible layers are shown again, but Focus mode remains active.

4. Click on another layer to focus on it.

5. To exit Focus mode, click the in the layer configuration panel. The map returns to its default state, displaying all enabled layers.

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.

You can update the data of a vector/raster spatial data source or a non-spatial data source. This process allows you to replace the file that provides data to the data source (DS).

1. Open the Update Interface

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

• upload a new file,

• select an existing file already stored in JMap Cloud.

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

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 spatial data source, 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,

• or use the same data source multiple times within a single project to show different filtered views of the same dataset.

This flexibility enables a customized and targeted presentation of your data while optimizing reuse.

Projects are secure resources: permissions can be assigned to control user access. This allows for precise management of who can view or interact with each project.

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

The following sections describe the steps to create a new project and how to manage the projects you have access to.

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.

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.

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.

2. Click the icon , then drag and drop the layer to the desired position.

The map itself remains unchanged, but the Layers panel reflects the new order.

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.

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

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.

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 settings to configure depend on the data source type. The SD properties and focus mode are available for all data source types. You can configure the style, labels, tooltips, and filters for layers from vector data sources. Only the style is configurable for layers from raster data sources.

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 .

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

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

Roles in JMap Cloud 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

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.

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.

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

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.

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

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.

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

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:

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.

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.

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.

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.

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.

This section displays a table listing all API keys associated with your organization.

For each key, the table shows the following information:

• Title

• Unique identifier (ID)

• Name of the user who created it

• Creation date

• Expiration date

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

Adding an API Key

To add a new API key:

1. Click Create new API key.

2. Enter a name, select an expiration date, and choose a role from the dropdown menu (only Editor and Viewer roles can be assigned to API keys). Fields marked with an asterisk (*) are required.

3. Click Create.

A message will inform you that the key is private and must be kept secret and secure. Once the window is closed, the key cannot be viewed again. Be sure to copy it immediately using the icon if you need it for future use.

Click OK to confirm. The key will now appear in the table.

Managing API Keys

To manage an existing API key hover over the row of the key to reveal the menu, then click it to access the following options:

• View information

• Delete

The information view displays:

• The title

• The creator’s name

• The assigned role

• The email address

You can copy the email address to the clipboard using the icon.

Deleting an API Key

You may delete unused API keys, but be aware of the consequences: a key may own resources such as data sources, projects, layers, and tables.

Before deletion, you should transfer ownership of these resources to another organization member. Otherwise, they will be permanently deleted along with the key.

Deletion steps:

1. Click the menu next to the key, then select Delete.

2. A confirmation message will appear. Confirm your intention to proceed.

3. If the key owns resources, a list of members with the Editor role will be displayed. Select one to transfer resource ownership.

4. If the key does not own any resources, you’ll be asked to confirm the final deletion.

The selected member becomes the new owner of the transferred resources. The key’s access permissions (ACL entries) are removed.

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

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 Roles 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. However, certain management actions are reserved for administrators. Viewers access data exclusively through web mapping applications.

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 .

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:

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

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.

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.

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.

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

For each member, the table shows the following information:

• Name

• Identifier

• Email address

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.

This example shows how to create a custom form. It instantiates a JMap NG App extension that creates a custom form in a panel.

Form UI is only available in JMap NG App, and not in JMap NG Core.

Example

Try it out in

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. introduced a format based on Google’s Protocol Buffers encoding ( ). 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

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

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:

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.

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.

The mouseover is a popup window that is displayed after clicking on features on the map.

If no mouseover content is set in the layer configuration, no popup is displayed when clicking on a feature of that layer.

You can set your own mouseover content programatically in Javascript. For instance, you can add a mouseover on a layer that has no mousoever content in its configuration.

In the following example, the layer "Hydrography", id=3, has no mouseover defined.

We will set a custom mouseover content that:

• Always displays a custom header

In this example, we will locate and select a feature on the map, for a given feature id.

In the example dataset, we will use the layer "Places", id=6, and locate feature with id=33.

We expect to find this feature, select it, then recenter the map around it.

Example

Try it out in

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

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.

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

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 user:

Modifying or Removing Permissions

You can at any time:

• change existing permissions;

• add new users;

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

Steps to manage permissions:

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 from the permissions list:

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

The table includes the following information for each file:

• File name

• Data type (vector, raster, or tabular)

• Format

• Size

• Status

Supported file formats:

• Vector data (compressed .zip file): GeoJSON, SHP, File GeoDatabase, GML, TAB, CSV, DWG, GeoPackage

• Raster data (uncompressed file): GeoTIFF

• Tabular data (compressed .zip file): CSV

You can select one or more files in the table using the checkboxes. When selected, the Delete option becomes available, allowing you to delete multiple files at once.