Configuring Your Instance

This section describes how to edit the settings of your instance. For information on how to manage permissions in your instance refer to Permissions in NavVis IVION.

Configuring Map Appearance

1. Go to the Instance Menu.
   

2. Go to Instance Settings > Instance Configuration > Map Appearance.

   

3. 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}

     The “lyrs“ can be customised as:

     • h= roads only

     • m = standard roadmap

     • p = terrain

     • r = somehow altered roadmap

     • s = satellite only

     • t = terrain only

     • y = hybrid

   • 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.

4. Click Save.

Adding Customizable Content

Follow these steps to add extra information to the about box in your 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.

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.

Enabling 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.

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 needs explicit permission to be able to access a 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.

Note: If you update an existing 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 the checkbox to Enable legacy authentication endpoints /token and /refresh

6. Click Save.

Enabling or Disabling Private Mode

Private mode restricts access to your 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.

Disabling private mode allows all users to access public sites without logging in. To see private sites, you will still need to log in. To make a site public, click the Make site visible for everyone toggle in the edit site menu.

1. Go to Instance Settings > Instance Configuration > Instance Privacy.

2. Check or uncheck the Enable private mode box.

3. Click Save.

Troubleshooting

Download the logs so that you can send them to NavVis IVION support and they can assist with troubleshooting tasks.