# Navigation (Navigation) # Overview The **Navigation** module is used to configure and manage maps, products, kiosks, facilities, tracks, shapes, and connectors required for navigation. It allows existing products and kiosks to be placed on a map and provides the required navigation structure between different locations. The Navigation module contains the following sections: - **Map - Used for add particular map.** - **Product - Used for mapping products in map.** - **Kiosk - Used for mapping kiosk in map.** - **Connector - Used to connect by using Escalators, Pillars etc.** - **Facility - Used for add facilites like washroom etc** - **Track - used to add track from one place to another.** - **Shape - Used to Add Shape for 3d Navigation.** - **Config - Used for Global Settings** --- ## Product The **Product** section is used to map existing products onto the selected map. Products must already be created in the system before they can be mapped. ### Purpose Product Mapping is used to display products at their respective locations on the map. For example: ```text Existing Product ↓ Select Map ↓ Select Shape / Map Point ↓ Submit ↓ Product displayed on Map ``` ### Navigation Path ```Modules -> Navigation → Product``` #### Product Mapping Process: 1. Open the Navigation module. 2. Select the Product tab. 3. Select the required product from the product list. 4. Select the required Map. 5. Select the required Shape, if applicable. 6. Select or define the required Map Point. 7. Verify the mapping details. 8. Click Submit. ``` Note: Product Mapping does not create a new product. It maps an already-created product to a location on the selected map. ``` ## Kiosk The Kiosk section works similarly to Product Mapping. The difference is that instead of mapping a product, an existing Kiosk is mapped to the selected map. ### Purpose Kiosk Mapping is used to display the kiosk at its appropriate location on the navigation map. #### Navigation Path ``` Navigation → Kiosk ``` ##### Kiosk Mapping Process 1. Open the Navigation module. 2. Select the Kiosk tab. 3. Select the required kiosk. 4. Select the required Map. 5. Select the required Map Point. 6. Select the appropriate Shape, if applicable. 7. Verify the mapping details. 8. Save/Update the map The kiosk will then be associated with the selected location on the map. ## Connector The Connector section is used to connect different navigation locations and entities. Connectors can be used when navigation needs to move from one location to another through a specific facility or route. ### Navigation Path ``` Navigation → Connector ``` **Available Connector Types** The Connector section can contain connector types such as: - Pillar - Elevator (Lift) - Escalator - Ramp - Staircase - Emergency Staircase - Gate #### Purpose Connectors can represent real-world connections between different locations. **For example**: ``` Location A ↓ Elevator ↓ Location B ``` ## Facility The Facility section is used to create and manage facilities that are available on the map. Facilities can represent different physical facilities or areas that users may need to navigate to. **The Facility configuration is performed in two stages:** - Add Facility Type - Add Facility ### Navigation Path ``` Navigation → Facility ``` #### Add Facility Type Before creating a facility, the required Facility Type must be created. ##### Process: 1. Open the Facility 2. Click Add Facility Type. 3. Enter the required Type. 4. Enable Published if the facility type should be published. 5. Upload the Facility Logo, if required. ***Example*** ``` Type: Stairs Published: Enabled Facility Logo: Uploaded ``` After submission, the facility type will be available for creating facilities. ### Add Facility Once the Facility Type has been created, a facility can be added. #### Process - Open the Facility tab. - Click Add Facility. - Select the required Type. - Enter the Name of the facility. - Select the required Map. - Define the Map Point. - Select the required Shape, if applicable. - Enable Published if required. - Click Submit. ##### Facility Structure ``` Facility Type ↓ Facility ↓ Map ↓ Map Point / Shape ``` **Example** ``` Type: Stairs Name: Stairs Map: Akshit-Map 1 Map Point: X,Y Shape: Selected Shape ``` ``` Important: The Facility Type should be created before adding a Facility. ``` ### Track Configuration The Track section is used to create navigation paths between two points on a map. It is an important part of configuring navigation in VirtuKiosk. #### Navigation Path: ``` Modules → Navigation → Track ``` ##### Add Points Before Creating a Track Before creating a track, you must first add the required points to the map. Navigate to the Map Layout section, where the following options are available: ``` Add Point: Adds a new point to the map. Move Point: Moves an existing point to another location. Delete Point: Removes an existing point from the map. Add / Delete Track: Allows you to create or delete a track between points. ``` #### Steps to Add Points Go to the Track section in navigation modules. Select Add Point. Click on the required locations on the map to create points. Repeat the process until all required points have been added. Verify that the points are positioned correctly. ``` Important: Add the required points before proceeding with track creation. ``` ##### Create a Track After adding the required points, create a track by defining its Start Point and End Point. ##### Steps to Create a Track Navigate to the Map Layout section. Select Add / Delete Track. Select the required Start Point. Select a different End Point. Verify the selected points. Click Submit to save the track. 9.3 Track Information The Track section displays the following information: Field Description Map Name The name of the map associated with the track. Start Point The coordinates of the point where the track begins. End Point The coordinates of the point where the track ends. 9.4 Track Validation The Start Point and End Point must be different. The system does not allow a track to be submitted when both points have the same coordinates. If both points are identical, the following validation message is displayed: Start and End Point must be different Validation Checklist Ensure that the Start Point is selected correctly. Ensure that the End Point is different from the Start Point. Verify that both points belong to the intended map. Confirm that the track is saved successfully. 9.5 Verify the Track After creating the track, verify the following: The track is associated with the correct map. The Start Point and End Point are correct. The selected points are different. The track configuration is saved successfully. The navigation path behaves as expected. Important: Always add the required points before creating a track. Correctly defining the Start Point and End Point helps ensure that the navigation path is configured properly. ##### Steps to Create a Track 1. Navigate to the **Map Layout** section. 2. Select **Add / Delete Track**. 3. Select the required **Start Point**. 4. Select a different **End Point**. 5. Verify the selected points. 6. Click **Submit** to save the track. ## 9.3 Track Information The **Track** section displays the following information: | Field | Description | |---|---| | **Map Name** | The name of the map associated with the track. | | **Start Point** | The coordinates of the point where the track begins. | | **End Point** | The coordinates of the point where the track ends. | ## Track Validation The **Start Point** and **End Point** must be different. The system does not allow a track to be submitted when both points have the same coordinates. If both points are identical, the following validation message is displayed: ```text Start and End Point must be different ``` ### Validation Checklist - Ensure that the **Start Point** is selected correctly. - Ensure that the **End Point** is different from the Start Point. - Verify that both points belong to the intended map. - Confirm that the track is saved successfully. ## Verify the Track After creating the track, verify the following: - The track is associated with the correct map. - The Start Point and End Point are correct. - The selected points are different. - The track configuration is saved successfully. - The navigation path behaves as expected. **Important:** Always add the required points before creating a track. Correctly defining the Start Point and End Point helps ensure that the navigation path is configured properly. # 10. Shape Configuration Navigate to: `Modules → Navigation → Shape` Shapes are used to define specific areas or navigation regions on the map. They are especially important for **3D Navigation** because a shape can be configured with 3D-related properties such as: - Logo - 3D Pin - GLB Model - 3D Pin Rotation - 3D Pin Scale - Active Color - Inactive Color - Active Height - Inactive Height --- # 11. Creating a Shape Navigate to: `Modules → Navigation → Shape` Use the map layout drawing functionality. Select: `Map Layout → Draw` Add the required points around the area that needs to be converted into a shape. ## 11.1 Add Shape Points Click on the map to add points. For example: - Point 1 - Point 2 - Point 3 - Point 4 The points define the boundary of the shape. A minimum of **3 points** should be used to create a proper closed shape. ## 11.2 Close Shape After adding the required points, select: `Close Shape` This completes the shape boundary. > **Important:** **Draw** and **Close Shape** should not be treated as simultaneous actions. Complete the required drawing first and then close the shape. ## 11.3 Undo If an incorrect point is added, use: `Undo` to remove the most recent drawing action. ## 11.4 Duplicate Shape Existing shapes can be duplicated when a similar shape is required. Select: `Duplicate` Then modify the duplicated shape as required. This can save time when multiple shapes have similar configurations. --- # 12. Shape Configuration for 3D Navigation After creating a shape, configure its 3D properties. The shape can contain the following configurations: - Title - Logo - Pin 3D - 3D Pin Rotation - 3D Pin Scale - Active Color - Inactive Color - Active Height - Inactive Height ## 12.1 Title Enter a meaningful name for the shape. Examples: - ATM Area - Gate Area - Entrance - Information Desk ## 12.2 Logo Select the required logo image. The logo should first be uploaded through: `Modules → Files` After uploading the file, it can be selected in the Shape configuration. ## 12.3 Pin 3D The **Pin 3D** option is used for the 3D representation of the shape or navigation point. Select the appropriate 3D asset. ## 12.4 3D Pin Rotation Configure the rotation of the 3D pin according to the required direction. Examples: - Rotation: 0° - Rotation: 90° - Rotation: 180° - Rotation: 270° ## 12.5 3D Pin Scale Configure the size of the 3D pin. The scale should be selected according to the map and visual requirements. --- # 13. Active and Inactive Shape Configuration 3D Navigation provides separate configurations for active and inactive shapes. ## Active Shape The active configuration controls the appearance of a selected or active navigation area. Possible settings include: - Active Color - Active Height ## Inactive Shape The inactive configuration controls the appearance of shapes that are not currently selected. Possible settings include: - Inactive Color - Inactive Height ### Example Configuration - Active Color: Required Color - Active Height: Required Height - Inactive Color: Required Color - Inactive Height: Required Height --- # 14. Bulk Configuration The Shape section provides **Bulk Configuration**. The available options include: - Select One - Custom - Global These options determine where the configuration changes will be applied. ## 14.1 Custom Configuration Select: `Bulk Configuration → Custom` The **Custom** configuration applies the selected changes **only to the current map**. ### Example Suppose there are three maps: - Map 1 - Map 2 - Map 3 If Custom configuration is applied to Map 1, the changes will affect **Map 1 only**. They will not automatically affect Map 2 or Map 3. ### Custom Configuration Flow 1. Select the map. 2. Open Bulk Configuration. 3. Select Custom. 4. Apply the required changes. 5. Verify that the changes apply to the current map only. --- # 15. Global Configuration Select: `Bulk Configuration → Global` The **Global** configuration applies the selected changes across **all available maps**. ### Example Suppose the system contains four maps: - Map 1 - Map 2 - Map 3 - Map 4 If Global configuration is applied, the changes will be applied across all four maps. ### Global Configuration Flow 1. Open Bulk Configuration. 2. Select Global. 3. Apply the required changes. 4. Verify that the changes apply to all maps. > **Important:** Use **Global** carefully because the configuration can affect multiple maps. --- # 16. Custom vs. Global Configuration | Configuration | Scope | |---|---| | **Custom** | Applies changes to the selected/current map only | | **Global** | Applies changes to all maps | ### Example Suppose you have three maps: - Map A - Map B - Map C If you change the shape color using **Custom**, only the selected map will be affected. If you use **Global**, the same configuration will be applied across Map A, Map B, and Map C. --- # 17. Important Shape Configuration Considerations When configuring multiple shapes, verify whether the required change is: - Specific to one map - Required across all maps Use **Custom** when the change is required only for a particular map. Use **Global** when the same configuration should be applied to all maps. This helps avoid unnecessarily modifying other maps. --- # 18. Map Layout The Map Layout provides the main working area for configuring navigation data. The available controls include: - Add Point - Move Point - Delete Point - Add / Delete Track The Map Layout is used for: - Adding map points - Moving points - Deleting points - Creating tracks - Defining navigation paths - Creating shape boundaries --- # 19. Map Layout Options ## Add Point Used to create a new point on the map. `Add Point → Click on Map` ## Move Point Used to change the position of an existing map point. `Move Point → Select Point → Move to Required Location` ## Delete Point Used to remove an existing map point. `Delete Point → Select Point` ## Add / Delete Track Used to create or remove tracks between map points. `Add / Delete Track` This functionality is especially important for navigation routes.