- 03 Apr 2024
- 11 Minutes to read
- Print
- DarkLight
- PDF
Creating and Managing Points of Interest (POIs)
- Updated on 03 Apr 2024
- 11 Minutes to read
- Print
- DarkLight
- PDF
This section explains how to create, edit and manage Point of Interest (POI), POI types, and POI type groups.
Point of Interest (POI)
Points of Interest (POI) are points defined in the 3D coordinate system of a Site that have additional information attached to them.
All POIs have a type, type group, and position. You can also set their name, description, icon, importance, and more. The POI names and descriptions can be set for one or more languages. The content of a POI description can be anything from plain text to embedded iframes. Adding custom data to POIs is useful for interfacing with applications built on top of NavVis IVION.
POI Types and Type Groups
POI types and POI type groups organize the POIs in a site:
Each POI is part of one POI type.
Each POI type is part of one POI type group.
A new site comes with default POI types such as "Stairs" or "Parking", and POI type groups such as "Access" or "Transport". Someone with site administrator privileges can add, delete, or edit types to fit your use case.
In a site, the POI Types menu lists all POI types and type groups in the site. From this menu, you can edit POI types and type groups, and filter which POI types to display.
Creating a POI
In a site, right-click at the location where you want to add a POI and select Create POI.
From the Edit POI dialog, in the Language section, choose the language of the POI's name and description.
From the Edit POI dialog, enter the name of the POI in the Name field.
From the Category drop-down menu, assign the new POI to a POI type.
To set a view for a POI, follow the steps in Setting a View for a POI.
From the View drop-down menu and the Edit drop-down menu, select which user groups can view and edit the POI.
In the description box, type the POI description/content.
To add another language, click the + Add language button in the top right of the dialog. Then, repeat the steps for any other languages the POI should translate to.
Click Save.
Setting a View for a POI
The view set for each POI will be replicated when another user clicks on that POI.
While creating a POI, you have two options under View configuration:
use current view (default)
use closest panoramic image
If you want to customize the POI view, choose use current view. This will save your present view location, angle, and zoom level. Before applying this option make sure to adjust to the exact view you want to set for your POI.
Note: When choosing use current view, make sure to set your view in panorama mode. A customized view set in Point cloud mode will not be transferred to panorama mode.
When editing a POI, a third option appears: Use previously specified view. If selected, when you close the Edit POI dialog, your view settings will be the same. If you want to change the POI's view, click use closest panoramic image or use current view.
Editing a POI
After you have created a POI, you can edit its name, description, and other attributes.
Note: Users belonging to only the EVERYONE group do not have permission to edit POIs but are still able to view them.
Locate the POI you want to edit from the site interface, or by clicking the Search field at the top left of the site and entering the POI name or description.
Select the POI and click Edit in the POI details panel to open the Edit POI dialog.
Important: The user who created the POI must give your user group editing access to edit the POI. A site admin can always edit a POI.
Change the name, category, description, media, or other attributes of the POI.
Click Save after edting any of the settings.
The following settings are available from the Edit POI tab:
Edit POI Tab
Moving a POI
Click Move, located below the rich text editor.
The editing dialog is hidden. Cancel and Save Position buttons appear at the bottom of the POI details panel.
Click in either the 2D Map view or 3D Panorama view where you want to place the POI.
Click Save Position on the POI details panel.
Click Save on the Edit POI dialog.
Attaching Media to a POI: Media such as images or audio files to POIs.
Click Add Media (images, PDF, audio, video).
Select the file you want to upload and upload it.
Note: You can upload files up to 20 MB.
POI Advanced Tab
To access the advanced tab of a POI perform the following:
Locate the POI from the site interface, or by clicking the Search field at the top left of the site and entering the POI name or description.
Select the POI and click Edit in the POI details panel to open the Edit POI dialog.
Click the Advanced tab.
Click Save after edting any of the setting in the Advanced tab.
The following settings are available from the Advanced tab:
Changing the Importance of a POI
The importance attribute in a POI is a priority setting to help determine which POIs should be hidden first while scrolling out of the map. POIs are hidden when their icons crowd too close together. High importance POIs disappear last.
From the Importance drop-down menu, select the new importance level.
Changing a POI Icon:
By default, a POI is displayed with the icon associated with its type. However, you have the option of uploading a custom icon for a POI.
Select the custom icon.
Click Upload icon to upload a new icon from your computer.
Custom icons must be raster images (JPG or PNG) with a size of 32x32, 64x64, 128x128, or 256x256 pixels.
Or, click on the list icon to the left of the Upload icon button to choose a recently uploaded icon.
Or, click Remove custom icon to remove a previously uploaded icon from the POI.
Adding Custom Data to a POI:
Add custom data to a POI, for example, add custom data for an application built on top of NavVis IVION.
In the Custom data field, paste your custom data string into the text field.
Check Visibility
When this is checked any POIs that are obsured, for example by an object or part of a building like a wall, are not displayed. If the checkbox is off, the POI will be visible in panorama mode and point cloud mode at all times.
However, if the POI is selected, it will still display regardless, of this setting. This setting can be turned off with admin rights, refer here.
Adding Custom Attributes to a POI
For example, a custom attribute can be an external system reference to connect a geolocation to a record not stored within NavVis IVION.
From the Custom Attributes area, enter the key in the Key field and the value for the key in the Value field.
Click + next to the fields to add the custom attribute to the POI. They are added beneath the existing fields.
Search for it in the attribute export file (.json recommended) or site/global search.
You can delete the custom attribute for the POI by clicking the delete icon next to the custom attribute.
Moving between POIs
Double-click a visible POI icon to go to the location closest to the POI. This works in the Panorama view.
Click a POI icon in the secondary Map view to open its details panel and move the view to it.
Opening External Links
To limit the chance of POI descriptions being used to spread malicious content, a notification will warn you that you are about to leave NavVis IVION if the POI description contains external links or external content in an IFRAME of the POI before opening the content.
Note: External links are links that are not in the NavVis domain.
Deleting a POI
Delete an individual POI.
Locate the POI you want to delete from the site interface, or by clicking the Search field at the top left of the site and entering the POI name or description.
Click EDIT in the POI details panel to open the Edit POI dialog.
Click Delete at the bottom left of the dialog.
Confirm the deletion.
Adding a New POI Type
Add a new POI Type to a site.
From the site menu, select the POI Types menu.
Click the + at the bottom of a type group.
The Add a New Category dialog will open.
From the Category group drop-down, select the correct group for the POI category.
From Language, choose the language(s) for the name of the POI category.
In the Name field, enter the name(s).
From Icon use the default icon, or click Upload icon, to upload an icon for the type.
This icon will be the default icon for any POIs in that type, so we recommend choosing one. You can choose one of the available icons for the type or upload a new custom icon.
From the Visible from zoom field and the Visible up to zoom field, click the up or down arrow to set the zoom levels of the map at which POIs of this type should be visible. If you want, click the quick copy icons next to the fields to copy the zoom levels.
Click OK to save the new type.
Editing a POI Type
From the main menu in a site, open the POI Types menu.
Find the POI type you want to edit and click the pencil icon next to it.
From the Edit Category dialog, edit the attributes of the POI type.
See also Adding POI Types.
Click OK to save your changes.
Deleting a POI Type
From the main menu in a site, open the POI Types menu.
Find the POI type you want to delete and click the pencil icon next to it.
From the Edit Category Group dialog, click Delete.
Confirm the deletion.
Adding a POI Type Group
From the main menu in a site, open the POI Types menu.
Click the topmost + button.
From Language, choose the language(s) that will be used for the name of the POI type/category group.
From the Name field, enter the name(s) for the POI category group.
If applicable, from the View and Edit drop-down menus, select which user groups can view and edit the POI type group.
Click OK to save the new group type.
Editing a POI Type Group
From the main menu in a site, open the POI Types menu.
Find the POI type group you want to edit and click the pencil icon next to it.
Edit the attributes of the POI type group.
Click OK to save your changes.
Deleting a POI Type Group
Open the POI Types menu.
Find the POI type group you want to delete and click the pencil icon next to it.
Click Delete at the bottom of the editor dialog.
Confirm the deletion of the POI type group, the POI types in that group, and all the POIs of those types.