Migrating from VPS to VPS2

VPS2 unifies the functionality of VPS and WPS under a single session and API surface. This page outlines what changes when migrating from ARDK 3.x to VPS2 in NSDK 4.x.

Geospatial Browser → Scaniverse Web

The Geospatial Browser (GSB), previously used to search for and activate VPS locations, is being retired. Use Scaniverse to manage VPS maps and sites.

See the From Setup to First Localization guide for instructions on creating a Scaniverse account and managing mapped locations.

If you have saved payloads from VPS locations discovered or activated through GSB, those payloads remain valid and can still be used for localization.

The VPS Coverage API remains available for querying VPS locations and anchors near the user at runtime. However, it only returns locations that were created or activated through GSB. VPS locations created on Scaniverse are not supported. It will be replaced by a unified Sites API in a future release.

VPS + WPS Sessions → VPS2 Session

Previously, VPS and WPS required separate session types. In VPS2, all functionality is unified under a single VPS2 session.

VPS2 provides:

• Global geoposition and heading (formerly WPS)
• Map-relative localization (formerly VPS)
• Anchor persistence and sharing
• AR ↔ geoposition coordinate conversion via a transformer

Refer to the VPS2 feature page for a full overview.

Key Behavioral Changes

Anchor Management

Anchor creation, updates, and removal remain conceptually consistent with legacy VPS. However:

• Anchors surface coarse poses even when the device is not localized to a VPS map.
• Anchor state explicitly reflects localization quality (Limited vs Tracked).

See Placing Virtual Content with VPS2 for details.

Geoposition Conversion

Legacy VPS and WPS methods for converting between local AR space and geographic coordinates are replaced by the VPS2 transformer (XRVps2Transformer in Unity / Vps2Transformer in Swift / VPS2Transformer in Kotlin).

All AR ↔ geoposition conversions now require:

1. Retrieving the latest transformer
2. Using that transformer for conversion

See Getting VPS2 Geoposition for details.

On-Device Mapping

The on-device mapping feature set from the original VPS is not available in NSDK 4.0 Beta.