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. The following configuration options are available to you:
    • Base map: Select which map to display as a background layer. The default is OpenStreetMap.
    • Map tile URL: If you want to use a different map provider, you can enter the URL here. For example to use Google maps enter the following URL: https://mt2.google.com/vt/lyrs=m@167000000&hl=en-US&x=${x}&y=${y}&z=${z}

    • 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.
      Note: To change these settings at a site level refer 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 the checkbox to Allow IFRAME embedding.
  5. 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.
    Refer to Sending Feedback for information about how to send the feedback.

Enabling Tracking

Follow these steps to enable user tracking.

  1. Go to Instance Settings > Instance Configuration > Functionality.
  2. Check the Enable tracking box.
  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 Enable private mode box.
  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 Enable point loading improvements box.
  3. Click Save.

Reset Instance Password

In the case a user of an instance requires password retrieval, perform the following procedure.

  1. Using your admin credentials log into https://iv.navvis.com/
  2. Go to the instance that needs the password reset.
  3. Click the Reset button in the Instance Management > Reset Instance Password area.

Restart Instance

In the case you need to restart the instance, perform the following procedure.

  1. Using your admin credentials log into https://iv.navvis.com/
  2. Go to the instance that needs to be restarted.
  3. Click the Restart button in the Instance Management > Restart area.
    • No data is lost during restart.
    • Uploads/downloads will be terminated during restart.
    • Jobs (e.g. map generation, etc.) will be terminated.