Importing Maps


DRAFT    This page is not complete.

Synoptic Panel allows you to import multiple maps at once.

Import Local Maps

Explains how to import multiple local maps

Note that Synoptic Panel with free license has a limit of 1 local map per visual.

Import a Remote Map

Explains how to import a map Explain that Dropbox, Google Drive and other similar provider are not allowed, mention CORS setting and that the URL must be reachable by the audience

Note that Synoptic Panel Lite does not support this feature.

Import Remote Maps from a JSON File

Note that Synoptic Panel Lite does not support this feature.

To import multiple remote maps into Synoptic Panel, follow these steps:

  1. Add the visual to your report as specified in the Getting Started section.

  2. Click + Add Map and select the Import URLs element.

    If you have already loaded a map, you can click the + Add button in the Map Editor dialog.

  3. Select the JSON file containing the list of maps you want to import (see below).

Import File Specifications

To automatically import multiple maps in Synoptic Panel, you need to provide a JSON file containing a list of map URLs, plus some additional information for each file. The JSON must have the following structure:

[
    {
        "url": "https://example.com/map1.svg",
        "name": "Map 1",
        "mapSelector": "Store1",
        "drillPath": ["Category"]
    },
    {
        "url": "https://example.com/map2.svg",
        "name": "Map 2",
        "mapSelector": "Store2",
        "drillPath": ["Category", "Sector"]
    },
    ... // Other maps
]

Here is a description of the fields:

  • url: The URL of the map file.
  • name: (Optional) The name of the map. This is the name that will be displayed in the visual. If not provided, the name of the file will be used.
  • mapSelector: (Optional) The value of the column bound as map selector. This is the column that will be used to switch between the maps. See more in the Filtering Maps section.
  • drillPath: (Optional) This is an array of values used to build the Drill Path, which represent the drill level of the visual. This is a useful way to quickly assign different maps to different levels, but requires to know the exact values of the drill path components. See how the drill path is built in the Drill Mode section. If not provided, each imported URL will be assigned to the current drill level.

    Note the Drill Path is displayed as a breadcrumb in the visual header. To define the drillPath value for the import file, you need to concatenate the single elements of the breadcrumb in the same order as they appear in the visual.
    E.g. Category > Sector becomes ["Category", "Sector"].

Provide a sample JSON file with links to our Github repo base on Synoptic Panel tour

Import My Storage Maps

Explains how to import a map + link to My Storage page

Note that only Synoptic Panel with OKVIZ license supports this feature.

Last update: Oct 04, 2024