The app is a part of the samples, but also available as pre-built app in the Apple and Google app stores.
The app requires an account. You can register one for free in the Developer Portal.
Map construction works by finding the same Feature Points in multiple images from different viewpoints and estimating the 3D structure of scene by triangulating those feature points.
For more information about the mapping UI, see Using the Mapping App.
It is important to try to cover the target environment from multiple viewpoints and possibly different distances if necessary.
When mapping, our Mapping App will notify you if subsequent images can be connected by matching Feature Points.
Below is an illustration of 9 captured images and how they connect to each other.
Not all spaces can be mapped.
For example, highly reflective surfaces don't have static visual features for map construction.
Another problem is large areas with uniform color with no detectable visual features at all.
To construct a good map, the captured images need to cover the same areas from different angles.
When localizing against a map, the map should contain data from a captured image with a similar viewpoint in it. The captured images don't need to be identical by any means, but should have a roughly similar angle and distance to target.
The more captured images a Feature Point appears in, the better its accuracy will be. The system requires a Feature Point to be found in two captured images, but more will be better.
Small to medium specific locations that when viewed, are enhanced with Augmented Reality content. These locations do not require mapping everything around the user, just the point of interest.
Examples of hotspots are statues, murals and other street art. Also storefronts, pop-up stores and exhibitions boothes and installations for movie marketing campaigns.
When mapping such hotspots, try to cover as much as possible from as many angles as possible. Take a series of images that overlap with each other. If you need to cover a specific part of the hotspot with extra detail, you can take close-ups of that area.
If you need to map a very long area that would be difficult to cover in one arc, you can try to cover it with multiple "mini-arcs" as illustrated below.
You can also take additional images from further away. These will help our SDK to localize to the scene from further away and also will help to connect everything together.
Landmarks like statues are a good example of a hotspot location that can be mapped from all around. To map a statue like this, just take a series of images in one full circle around it.
Try to fit all important visual features in the images. You can map either in landscape or portrait mode. You can also mix orientations if you want to cover some parts with close-ups.
Large indoor spaces can be divided into separate maps for each area or room. This makes it easy to update any areas that may change over time. It also makes is easier to maps individual parts.
To map a single room, map using the "outside-in" method. Take a series of images while moving around the perimeter of the room looking across the space. Remember that you can use either landscape or portrait mode. In smaller rooms, landscape often works very well.
Just try to cover the whole area from as many angles as possible.
You can align multiple maps together in Unity with our Multi Map feature. Not all areas need to be connected in just one map.
If you want to connect many separate areas together in one map, you need to make sure the areas can be connected visually. One way is to create an "image path" from one space to another.
It doesn't matter if you're mapping a small apartment or a shopping mall. The mapping techniques scale with the spaces.
The Y-axis of the map might be correctly pointing up, but rotation around the Y-axis is not constrained and can change between different constructions if you remap the same space.
Using just GPS or the device compass to orient the map is not reliable enough.
This makes it difficult to maintain AR content so we provide a way to accurately define the orientation of the map. With an Anchor Image, you can make sure the map orientation is preserved when remapping a space.
When using the Mapping App, open the Tools Menu in Workspace mode and click Add Anchor Image. A notification should appear when Anchor Image is captured.
When adding the Anchor Image, an image is captured and the device orientation is recorded. The recorded orientation is then used when constructing the map.