Mondara Map Migration - What To Expect

As part of our Grid View Deprecation process, we will be migrating existing Mondara maps to our new and improved Visualization Canvas maps. Migrating these legacy Mondara maps will ensure a consistent and stable experience for all of our users' mapping needs.

What Are Mondara Maps

Historically, Mondara maps were created when users uploaded geospatial data through our legacy ingress process. A Mondara map consists of a "parent" map layer, which is seen in the catalog, and a hidden "child" dataset layer, which is not. While users can link to and embed Mondara maps at the parent 4x4, the API to that map data is only available from the hidden "child" 4x4. It is also possible for a Mondara map to have multiple child layers if it was uploaded as a multi-layer geospatial dataset. These types of maps were deprecated and have been officially unsupported since July 1, 2020. The complete deprecation roadmap can be found here.

What Happens During Migration

Migrating Mondara maps to Visualization Canvas maps means these assets will now follow the same patterns as all other assets on the platform. All geospatial data is uploaded as a dataset with geospatial columns, and users can create maps or any other kinds of visualizations on top of that data. The previously hidden dataset layer will become visible in the catalog and be treated as a normal dataset, and the parent map layer will turn into a new Visualization Canvas map.

Quick Facts

  • Single layer Mondara maps will become two assets in the catalog (one map and one dataset)
    • The unique identifier (4x4) for the map will not change.
    • The unique identifier (4x4) for the dataset will not change. This dataset was previously hidden and will now be a visible asset by default. If publishers wish, they can hide this dataset post-migration.
    • The dataset will include an Overview Page, consistent with Overview Page for other datasets.
    • The styling of the new map visualization will stay as similar as possible upon migration.
  • Title and Description metadata from the Mondara map will be applied to both the new map and the new dataset.
  • The "Views" count in the catalog associated with the legacy map will be ported to the new map.
  • The "Views" count for the new dataset will start at zero, since that dataset was previously hidden.
  • Existing comments and ratings will be added to the tabular asset associated with the first map layer after migration.
  • Icons configured for the Mondara map, previously located in the Grid View’s “About” tab, will be added to the tabular asset associated with the first map layer after migration.

Multi-layer geospatial datasets (more than one layer in a single file)

  • Multi-layer Mondara maps will be migrated into a single map visualization, with separate datasets for each layer. Each layer will have the same name and description


    • Multi-layer geospatial datasets are no longer supported on import as a single file.
    • Multi-layer map visualizations are still supported through Visualization Canvas maps, by adding multiple datasets as layers to a single map visualization.
    • Any attachments on the map will be set as attachments on the first layer only.
    • The original file saved on the map (the file accessed when you “export original file”) gets added as an attachment on the first layer only.
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request



Please sign in to leave a comment.