The add-on helps you to enrich your application with visual representation and intuitive manipulation for spatial data. You can use a preferable map provider that meets your needs.

The component integrates spatial types (point, polyline, polygon) from JTS Topology Suite (JTS) — the most popular Java library for working with spatial data.

The add-on supports a traditional multi-layer structure commonly used in professional GIS systems. The layers are represented as structural units of maps.

You can use the following types of layers:


The add-on supports drawing and interactive editing of geo-entities and provides features for geoanalysis: heatmaps and clustering.


This add-on requires the Enterprise subscription. If you don’t have the subscription, see how to get the trial version below.

For automatic installation through Jmix Marketplace, follow instructions in the Add-ons section.

For manual installation, follow the steps below.

  1. Configure access to the premium repository.

    • Add the premium repository to your build.gradle:

      repositories {
          // ...
          maven {
              url = ''
              credentials {
                  username = rootProject['premiumRepoUser']
                  password = rootProject['premiumRepoPass']
    • Add premium repository credentials to ~/.gradle/


      Get the repository credentials from your license key: the first part of the key before dash is the repository user name, the part after dash is the password. For example, if your key is 123456123456-abcdefabcdef, then the user name is 123456123456 and the password is abcdefabcdef.

  2. Add dependencies to your build.gradle:

    implementation 'io.jmix.maps:jmix-maps-starter'
    implementation 'io.jmix.maps:jmix-maps-ui-starter'
    widgets 'io.jmix.ui:jmix-ui-widgets'
    widgets 'io.jmix.maps:jmix-maps-ui-widgets'
  3. Remove implementation 'io.jmix.ui:jmix-ui-widgets-compiled' dependency.

  4. Add compileWidgets task (change paths according to your application base package):

    compileWidgets {
        generate 'maps.ex1.widgets.CustomWidgetSet'
  5. Add jmix.ui.widget-set property to your file (adjust location according to the compileWidgets task above):

    jmix.ui.widget-set = maps.ex1.widgets.CustomWidgetSet

To enable building your project after the Enterprise subscription is expired, it is recommended to set up a Private Artifact Repository while the subscription is still active.

Trial Version

You can get a trial version of the add-on by visiting your profile page. Just click on the Get Enterprise trial button in the Subscriptions section.

Trial versions of commercial add-ons will stop working in 28 days after requesting the trial Enterprise subscription. An application including expired trial add-ons will not run.