Interactive SVG Map Component

Overview

The possibility to highlight business KPIs with colors on tailored custom maps and to drill down into details from that is a common need in several sectors such as:

  • Retail for stores
  • Public Sector for geographical area
  • Logistic for warehouses
  • Office Space design/allocation
  • and many others

Leveraging an SVG integration, we provide a way to customer to use their own svg maps into Appian SAIL.

Key Features & Functionality

The interactiveSvgMapComponent allows customers to:

  • Provide a custom SVG map image
  • Specify a list of areas as a parameter for which a different color (standard Appian colors or hex code) can be applied, show a custom tooltip, decide the best way to highlight the area on mouse hover, and optionally allow a click event on the area itself
  • Zoom in and out on the map using the mouse, buttons, or icons
  • Pan the map within the component area
  • Use Appian document generation template format to populate a text field in the map image with Appian values
  • As a result, the component will return the index of the selected area (across the ones specified as a parameter), which can be used in SAIL to show the details data related to that area
  • By leveraging the Rich Text Editor image upload connected system, it is also possible to convert the resulting map into a PNG image document for reporting purposes or for use in SAIL interfaces for read-only users.
Anonymous
  • Hi Prashant

    I think the issue are all the comments on top of the files , I suggest you to remove everything before the <SVG> tag and try again, I also suggest you to remove height and width attributes from SVG tag and either control them thru the viewbox attribute or svgViewBox parameter in the component , this allows more flexibility in your interface .

    This is also explained in the documentation within the download package on this page

    I hope this helps

  • Hi,

    I am trying to show a world interactive map using an SVG file downloaded from https://simplemaps.com/resources/svg-world.

    I can see it using one function but not the other. Can anyone help me understand the behaviour?

    Thanks in advance.

  • Hello All.

    I am trying to implement an interactive world map to show selected countries across the world. I have downloaded the SVG file from https://simplemaps.com/resources/svg-world. I can visualize the map in  svgImageMapField but  not in interactiveSvgMapField. Can somebody help?

  • v6.0.3 Release Notes
    • Fixed an error that prevented viewBox parameter to use the minX value to properly position the SVG in the component
  • NEW TRY NOW BUTTON AVAILABLE

    With the "Try Now" button below the Download link you can see the component in action before actually installing it in your cloud instance or local environment

  • Looks like I have different phone layout (I m on Android) btw in your video components stack usually the behavior you are observing should happen when you pan up and down outside the component area, while it should not if you do that within the component, unless there is a different behavior on iphone web engine. May you try on another phone or via browser on the mobile device?

    We overlapped our answer then maybe you need to open a support case

  • Looks like I have different phone layout (I m on Android) btw in your video components stack usually the behavior you are observing should happen when you pan up and down outside the component area, while it should not if you do that within the component, unless there is a different behavior on iphone web engine. May you try on another phone or via browser on the mobile device?

  • Hi  , I attached a video of the behavior I'm experiencing on my iPhone 12. Zooming and pan left/right work just fine. The issue is that when I try to move up or down, the whole page scroll is moving as well.

    EDIT: I tested both an iPhone and an Android. It appears that only the native iOS mobile app has the issue described above. The Android app, and using the web browser on both devices allowed the SVG image to be moved independently of the rest of the page

  • I don't see the issue on mobile you need to hold a finge and move it to pan and  use 2 fingers to zoom in and out

  • Hello,

    We noticed that trying to zoom/pan the SVG component on the native Appian mobile app causes the entire page to scroll. Is it possible to lock the entire screen when attempting to move around the svg image via touch controls?