> For the complete documentation index, see [llms.txt](https://docs.jmapcloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jmapcloud.io/en/jmap-ng/jmap-ng-developer-documentation.md).

# JMap NG Developer Documentation

This manual is for developers who want to use JMap Cloud NG to create map visualization applications for the web, integrate mapping capabilities into their own web applications, or extend existing JMap Cloud NG tools.

JMap Cloud NG can be embedded in two UI modes, depending on how much of the built-in interface you want to use.

### Minimal UI <a href="#jmap-ng-core" id="jmap-ng-core"></a>

<div data-full-width="false"><figure><img src="/files/rvmT1znZyyIdoawe9tA3" alt="" width="375"><figcaption></figcaption></figure></div>

Use the minimal UI mode when you want to integrate a JMap Cloud map into your own web application and build your own user interface around it.

In this mode, JMap Cloud NG loads the map and exposes its JavaScript [API](https://k2geospatial.github.io/jmapcloud-frontend/jmapcloud-ng-types/latest/modules/JMap_Cloud_NG_Core___API.JMap.html), while avoiding the full JMap Cloud NG application interface. This is the recommended mode for custom web applications that need mapping capabilities but already provide their own layout, navigation, panels, or business workflows.

Minimal UI mode is enabled with the `ui` startup option:

```html
<script>
  window.JMAP_OPTIONS = {
    restBaseUrl: "https://api.jmapcloud.io",
    ui: "minimal"
  }
</script>
```

### Full UI <a href="#jmap-ng-app" id="jmap-ng-app"></a>

<figure><img src="/files/zSPFCJZRKm7dI4p3Fq5w" alt="" width="375"><figcaption></figcaption></figure>

Use the full UI mode when you want a complete ready-to-use JMap Cloud NG application.

In this mode, JMap Cloud NG loads the full interface, including the map, panels, and built-in tools such as layer management, selection, measuring, editing, or exporting. It can still be customized through startup options and extended with JMap Cloud NG extensions.

When using the full UI mode, its javascript API is available under [JMap.Application](https://k2geospatial.github.io/jmapcloud-frontend/jmapcloud-ng-types/latest/modules/JMap_Cloud_NG___API.JMap.Application.html)

Full UI is the default mode. It can also be set explicitly:

```html
<script>
  window.JMAP_OPTIONS = {
    restBaseUrl: "https://api.jmapcloud.io",
    ui: "full"
  }
</script>
```

### Choosing a mode <a href="#jmap-ng-app" id="jmap-ng-app"></a>

Choose `ui: "minimal"` when your application provides its own interface and only needs JMap Cloud NG mapping and API capabilities.

Choose `ui: "full"` when you want to embed or launch the complete JMap Cloud NG application experience.

Both modes use the same `jmapcloud-ng` package and the same startup options mechanism.

### API documentation <a href="#jmap-ng-app" id="jmap-ng-app"></a>

Release notes and API documentation is available [here](https://k2geospatial.github.io/jmapcloud-frontend/jmapcloud-ng/).

The latest version of the JMap Cloud NG Javascript API documentation is available [here](https://k2geospatial.github.io/jmapcloud-frontend/jmapcloud-ng-types/latest/index.html).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.jmapcloud.io/en/jmap-ng/jmap-ng-developer-documentation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.