Skip to main content

Configuring the Instance

This section describes the configuration options available on the instance level.

Configuring Map Appearance

Follow these steps to configure the appearance of your maps in NavVis IVION.

  1. Go to Instance Settings > Instance Configuration > Map Appearance.
  2. Make the desired changes. The following configuration options are available to you:
    • Base map: choose whether to display OpenStreetMap as a background layer.
    • Map tile zoom bias: adjust the threshold for loading a new tile zoom level depending on the user's zoom level.

    • Maximum map tile zoom level: choose how far your maps can be zoomed in on a scale of 0 (fully zoomed out) to 22 (fully zoomed in).

    • Minimum map tile zoom level: choose how far your maps can be zoomed out on a scale of 0 (fully zoomed out) to 22 (fully zoomed in).

    • Map tile size (px): choose between displaying your maps as 512x512 pixel tiles or 256x256 pixel tiles.

    • Map tile URL: if you want to use a different map provider, you can enter the URL here.

  3. Click Save.

Adding Customized Content

Follow these steps to add extra information to the about box in your NavVis IVION instance.

  1. Go to Instance Settings > Instance Configuration > Customizable Content.
  2. Enter your HTML code in the respective boxes.
    If you want to add an image, for example, use the <img> tag with the URI to the image as a source.
  3. Click Save.

Setting Up Cross-Origin Resource Sharing

Cross-Origin Resource Sharing (CORS) is a mechanism that tells browsers to give a web application running at one origin, access to selected resources from a different origin.

To improve the security of NavVis IVION, any domain with a different origin to that of NavVis IVION needs explicit permission to be able to access a NavVis IVION instance. If, for example, an application hosted on site-a.com embeds NavVis IVION, which is hosted on site-b.com, the application will need to be granted special access.

Follow these steps to specify which domains can send requests to your server.

Note: If you update an existing NavVis IVION instance, access will initially be allowed from any origin through the * wildcard, to avoid breaking any existing integrations. If you want to restrict or deny cross-origin requests, follow the instructions below.
  1. Go to Instance Settings > Instance Configuration > Security.
  2. If you want to deny any cross-origin requests, leave the Security box empty.
  3. Otherwise, enter the exact URL of the origin you want to give access to, including the protocol and, if used, the port. If you enter more than one origin, the URLs need to be on separate lines.
  4. Click Save.

Enabling Email Feedback from Users

Follow these steps to set up the email feedback form.

  1. Go to Instance Settings > Instance Configuration > Email Feedback from Users.
  2. Enter the domain of the email server under Domain of from address.
  3. Enter the email address to which feedback should be sent under Recipient email.
  4. Enter the recipient email's SMTP host server under SMTP server.
  5. If you want to display a privacy statement in the feedback form, enter your HTML code in the box labeled HTML to show the data privacy statement in the feedback form.
  6. If you want to show a consent check box, check Show checkbox with consent and enter a consent text under Consent text for the data privacy statement.
  7. Click Save.

Enabling Tracking

Follow these steps to enable user tracking.

  1. Go to Instance Settings > Instance Configuration > Functionality.
  2. Check the check box Enable tracking.
  3. Enter a JavaScript tracking code under Javascript tracking code for statistics.
  4. Click Save.

Enabling or Disabling Private Mode

Private mode restricts access to your NavVis IVION instance. If private mode is enabled all users need to log in to see any information in the instance. For newly created instances private mode is turned on by default.

Follow these steps to enable or disable private mode:
  1. Go to Instance Settings > Instance Configuration > Instance Privacy.
  2. Check or uncheck the check box Enable private mode.
  3. Click Save.

Disabling Point Loading Improvements

The point loading improvements are enabled by default. Follow these steps to disable the point loading improvements:
  1. Go to Instance Settings > Instance Configuration > Functionality.
  2. Uncheck the check box Enable point loading improvements.
  3. Click Save.