# Scaniverse for Lightship Source: https://www.nianticspatial.com/docs/nsdk/how-to/vps/tooling/lightship_scaniverse/ We are currently running a beta of Scaniverse for Niantic Developers, which seamlessly integrates the Geospatial Browser (GSB) with the award-winning scanning experience in Scaniverse. This significantly streamlines developer workflows around browsing the map, adding locations, and of course scanning: > **Warning:** > > **Legacy Geospatial Browser workflow** > > The Geospatial Browser and its Scaniverse integration are no longer available. These > instructions are retained as a reference for older VPS projects. For current projects, create > and manage Sites in [Scaniverse Web](https://scaniverse.nianticspatial.com/). - We've made the Geospatial Browser (GSB) mobile-friendly so that it can be effectively used within Scaniverse to browse the map, inspect locations, add locations, and request VPS activation - We've replaced the Wayfarer App login flow with a simple QR code that links Scaniverse with your Lightship account - We have adopted Scaniverse's existing UI to power creation and uploading of scans - We've enabled testing localization at VPS-activated locations within Scaniverse - We've integrated our latest improvements to map filtering to make it easier than ever to find the location(s) you are looking for ## Linking Scaniverse with the Geospatial Browser (GSB) Install Scaniverse from the [iOS App Store](https://apps.apple.com/us/app/scaniverse-3d-scanner/id1541433223) or [Google Play Store](https://play.google.com/store/apps/details?id=com.nianticlabs.scaniverse). 1. Log in to your Lightship account on your desktop. Open the **Geospatial Browser (GSB)**, select any location on the map, and then select **View Details**. In the bottom right corner of the location details card, press **Generate QR Code**. A QR code will be displayed. (image: Indicating the QR Code) 2. Open the Camera app on your phone, then scan the QR code and open the Scaniverse link that appears. This will link Scaniverse with your Lightship developer account. 3. When prompted, allow Scaniverse to use your current location. 4. Once you have linked Scaniverse to GSB, you will be able to return to the GSB screen at any time by tapping the **GSB button** in the bottom ribbon of the Scaniverse app. Note that you may unlink Scaniverse from GSB at any time by going to the **Settings** menu and toggling off the **Niantic Developer Mode** option. (image: Indicating the GSB Button) All of the scans you have taken outside of Niantic Developer Mode will remain accessible when linking/unlinking Scaniverse with GSB. ## Browsing the Geospatial Browser Map in Scaniverse 1. Tapping on the **Person** icon will allow you to select your Workspace. 2. The **Upload** button lets you select location scans to upload. Only scans taken in Niantic Developer Mode (using the **Add Scans** or **Test Scan** options) can be uploaded to Niantic for VPS development purposes. 3. The **Plus** button lets you create new locations and test scans. 4. The **Layers** button toggles the satellite view of the map. 5. The **Reticle** button centers the map on your location. 6. Tapping the **Compass** button returns the map to its default orientation. 7. The **Controls** button lets you filter visible map locations based on their size, category, or activation status. 8. The **Magnifying Glass** button lets you to search the map. (image: The GSB Map Layout) Selecting a location on the map will bring up a **Preview** screen. Tap the preview for more details. If you've selected a VPS-activated location, you can tap the **Test VPS** button to verify that localization works. To scan a location, tap its **Add Scans** button. You must be near the location for the Add Scans option to be available. (image: The GSB Map Preview Layout) ## Creating and Uploading Scans To create and upload a scan: 1. The **Record** button is used to start and stop the scanning process. 2. The **Pause** button can be used to temporarily suspend the scanning process if desired. 3. The **Time** display indicates the duration of the current scan. A minimum length of 15 seconds is required for a scan to be viable for upload for VPS development purposes. A scan length of 30-60 seconds is ideal (scans in excess of 60 seconds are split into multiple pieces for processing purposes). (image: The GSB Scan Creation interface) When you have completed a scan, you will be able to inspect a **Preview Mesh** of the scene that you captured. If you are happy with your scan, you can upload it immediately by pressing the **Upload Scan** button or do it later over WiFi by tapping **Upload Later**. If you are not happy with your scan, you can discard it by pressing the **Delete** button. > **Tip:** > > **Important!** > > Because uploading can use a significant amount of data, we recommend waiting until you have WiFi access to upload your scans. ## Scanning Technique Scanned VPS-activated locations should be no larger than a 10-meter diameter around the location. For example, a typical statue would work as a VPS-activated Location, but an entire building will not. We recommend sticking with smaller areas to start (e.g. a desk, statue, or mural). Before scanning, be aware of your surroundings and ensure you have the right to access the location you are scanning. To scan an area with proper technique: 1. Check the area to be scanned and the surroundings of the scanned object to determine if there are any obstacles and to select a scanning route. Make sure to plan the route you intend to use for scanning before starting the procedure. 2. Make sure your camera is in focus. Camera shake can negatively affect 3D reconstruction. Keep your phone as close to your side as possible to avoid blurring. Walk around the object you are scanning instead of standing in one location and moving your phone. 3. Walk at a slow and natural stroll pace. Move yourself slowly and smoothly during scanning. Sudden changes of direction are a definite no-no. Move slowly and smoothly with your feet on the ground. If you are scanning in a darker setting, it's even more important to move slowly and smoothly. Move the phone with you while you are moving. 4. VPS Location should always be the focal point. In order for us to build the map, it's important to focus on the VPS Location and capture the full 360 deg orbit of it. If it is not safe or not possible to get 360 deg coverage, capture as much as you can. 5. Vary your distance/angles (0-10m or 0-35ft). In order for the 3D map to work well in different scenarios, it's important that we capture the environment around the Location and have a variety of different scans. Vary your distance and angles while scanning the Location. Video of recommended VPS Location scanning technique: ```mdx-code-block ``` ## Things to avoid while scanning Consider these guidelines while scanning: 1. Avoid scanning while the surroundings are not safe, e.g. in the middle of the road, or in a playground with children. 2. Avoid scanning while the Location is too far away (>10m or 35ft) or too big to focus your camera on. 3. It is important to keep the Location as your focal point at all times. 4. Avoid pointing your phone at very bright objects, such as fluorescent lights or the sun. 5. Avoid not moving or moving too fast while scanning. Abrupt motions will cause offsets in the reconstruction. 6. If your phone gets hot, let it cool down before scanning. If the temperature of the device rises too high, the performance of the device will be greatly reduced, which will negatively affect the scan. 7. Avoid uploading any scans that look incomplete or not representative of what you're trying to scan. 8. Avoid scanning when it's too dark/there is insufficient lighting