Scanning Locations
Scaniverse for Niantic Developers (iOS Beta)
VPS and Geospatial Browser (GSB) currently requires a Pro Plan. These features are not available on the Basic Plan.
Scaniverse for Niantic Developers is available in Beta on iOS devices. Android support is coming soon.
Wayfarer can be used to scan VPS Locations on Android devices.
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:
- We’ve made the Geospatial Browser (GSB) mobile-friendly so that it can be effectively used within a 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 8th Wall 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
8th Wall developers with iOS devices can try out the beta now by following the instructions below.
Linking Scaniverse with the Geospatial Browser (GSB)
Prerequisite: Install Scaniverse from the iOS App Store. Support for Android devices is coming soon. Wayfarer can be used to scan VPS Locations on Android devices.
- Log in to your 8th Wall 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.
-
Scan the QR code with your Camera app. Open the Camera app on your phone, point it at the QR code.
-
Tap on the Scaniverse link that appears. This will link Scaniverse with your 8th Wall developer account. This only needs to be done once.
Make sure to allow www.8thwall.com to use your current location when prompted; this is required for proper operation of the GSB interface.
-
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.
-
All of the scans you have taken outside of Niantic Developer Mode will remain accessible when linking/unlinking Scaniverse with GSB.
Browsing the GSB Map in Scaniverse
-
Tapping on the Person icon will allow you to select your 8th Wall Workspace.
-
Tapping on the Upload button will allow you to select location scans to upload. Note that only scans that originate from Niantic Developer Mode (using the Add Scans or Test Scan options) can be uploaded to Niantic for VPS development purposes.
-
Tapping on the Plus button will allow you to create new locations and test scans.
-
Tapping the Layers button will toggle on the satellite view of the map.
-
Tapping the Reticule button will center the map on your location.
-
Tapping the Compass button will return the map to its default, north-up orientation.
-
The Controls button will allow you to apply filters to the locations that appear on the map based on their size, category, or activation status.
-
The Magnifying Glass button will allow you to search the map.
-
Tapping on the X button will close the GSB and return you to the Scaniverse home screen.
-
Selecting a location on the map will bring up a Preview screen, which can be tapped for more details.
-
If you’ve selected a VPS-activated location, you can tap the Test VPS button to verify that localization works.
-
To create a scan to add to a particular location, tap the Add Scans button of the respective location. Note that you must be near the location in order for the Add Scans option to be available.
Creating and Uploading Scans
-
The Record button is used to start and stop the scanning process.
-
The Pause button can be used to temporarily suspend the scanning process if desired.
-
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).
-
Tapping on the X button will return you to the Scaniverse home screen.
-
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 may choose to upload it immediately by pressing the Upload Scan button.
-
You may also elect to Upload Later if you’d like to use a WiFi connection (recommended).
-
If you are not happy with your scan, you can discard it by pressing the Delete button.
Installing Niantic Wayfarer
In order to scan new VPS Locations or add scans to previously activated Locations, you'll need to install the Niantic Wayfarer app on your phone. Please see below for installation and usage instructions.
iOS
The Niantic Wayfarer App requires iOS 12 or later and an iPhone 8 or later. A LiDAR-capable device is not required.
To install the Niantic Wayfarer App, go to Testflight for Niantic Wayfarer (8th.io/wayfarer-ios) on your iOS device.
Android (Beta)
The Niantic Wayfarer App requires the ARCore package.
To install the Niantic Wayfarer App, go to Niantic Wayfarer (8th.io/wayfarer-android) on your Android device.
Using Niantic Wayfarer
You can add scans to Public Locations as well as create Test Scans with the Niantic Wayfarer App.
Once you have installed the app, login with your 8th Wall credentials by pressing the Login with 8th Wall button.
If you have access to multiple workspaces, select a workspace by pressing the 8th Wall Workspace dropdown on the profile page.
Login Page | Profile Page |
---|---|
On the Map page, select a VPS Location to add a scan to a public Location (1), or select Scan to add a test scan to your workspace (2).
Take a scan of the area using the recommended scanning technique.
Map Page | Scanning Page |
---|---|
Once the scan has been completed, select either public or test, and then upload.
Scan Type | Scan Upload |
---|---|
Processing scans can take 15-30 minutes. Once processed, scans will populate in the geospatial browser.
Issues related to scanning or processing should be directed to support@lightship.dev.
You can find more information on how to use the Wayfarer app in the Lightship documentation.
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. An entire building, however, would not. One face or doorway/entrance into a building might work. 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.
-
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. It is necessary to plan the route you intend to use for scanning before starting the procedure.
-
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.
-
Walk at a slow and natural stroll pace. Move 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 (think crab walk).
-
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° orbit of it. If it is not safe or not possible to get 360° coverage, capture as much as you can.
-
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. It’s important to vary your distance and angles while scanning the Location.
Video of recommended VPS Location scanning technique:
Things to avoid while scanning
-
Avoid scanning while the surroundings are not safe, e.g. in the middle of the road, or in a playground with children.
-
Avoid scanning while the Location is too far away (>10m or 35ft) or too big to focus your camera on.
-
Avoid scanning while you are casually taking a walk or jogging. It is important to keep the Location as your focal point at all times.
-
Avoid pointing your phone at very bright objects such as a fluorescent light or the sun.
-
Avoid not moving or moving too fast while scanning. Abrupt motions will cause offsets in the reconstruction.
-
Avoid scanning if your phone gets too hot. If the temperature of the device rises too high, the performance of the device will be greatly reduced, which will negatively affect the scan.
-
Avoid uploading any scans that look incomplete or not representative of what you're trying to scan.