# Vps2Config

Source: https://www.nianticspatial.com/docs/api/kotlin/com.nianticspatial.nsdk.Vps2Config/

Vps2Config
Configuration structure for the VPS2 session.

---

## Declaration

class Vps2Config

## See also

Vps2Session.configure

---

## Properties

| Name | Type | Summary |
| --- | --- | --- |
| anchorDistanceGateMeters | Float | Distance gate in meters for anchor candidate filtering when geo-corrected.Nodes farther than this distance from the device are skipped during anchor localization.When only GPS is available (no geo-correction), the effective gate is 2x this value.Use 0 to apply the default value (100m geo-corrected, 200m GPS-only).Use -1 to disable the distance check entirely.**Default:** 0 (uses native default of 100m geo-corrected / 200m GPS-only) |
| assetTargetingEnterMarginMeters | Float | How far outside a VPS asset's geographic bounds the device can be and still start localizingagainst that asset, in meters.Covers ordinary GPS error, so a device standing just outside an asset still picks it up. Anasset the server published no bounds for is always a candidate. Use 0 to apply the defaultvalue (25m). Use a negative value for no margin, judging the bounds exactly.**Default:** 0f (uses native default of 25m) |
| assetTargetingExitMarginMeters | Float | How far outside its bounds an asset already being localized against is kept, in meters.Larger than [assetTargetingEnterMarginMeters] on purpose: the gap between the two is what stopsa device sitting on the boundary between two assets swapping between them on every positionupdate. A value below the enter margin is raised to it. Use 0 to apply the default value (50m).Use a negative value for no margin.**Default:** 0f (uses native default of 50m) |
| continuousVpsRequestsPerSecond | Float | Number of VPS localization requests per second to send the server while successfullylocalized on a VPS map.**Default:** 0.2f (native default) |
| deviceMapLocalizationFramerate | Int | Number of times per second to attempt localization on available device maps.**Default:** 10 (native default) |
| enableBlurDetection | Boolean | If true, enable the image blur check on the cloud localization path.Advisory only: a frame whose sharpness score is below [minSharpnessScore] produces aFRAME_FLAGGED localization request record (error IMAGE_TOO_BLURRY) so the app can warnthe user, but is still sent for localization, never rejected.**Default:** false (disabled) |
| enableDeviceMapLocalization | Boolean | If true, localization on device maps is enabled.Device maps are created by the on-device mapping feature. They do not providea georeference.**Default:** false (native default) |
| enableGeolocationSmoothing | Boolean | If true, geolocation smoothing is enabled.**Default:** true (native default) |
| enableTemporalFusion | Boolean | If true, successive VPS localizations are temporally fused.Fusion smooths the localization stream, at the cost of latency reacting to a genuine posechange. Turn it off to see raw per-localization output.**Default:** true (native default) |
| enableUniversalLocalization | Boolean | If true, universal localization is enabled.Universal localization provides geographic positioning that works anywhere without requiringpre-scanned maps.**Default:** false (native default is applied if you leave this unset/zeroed). |
| enableVpsDebugger | Boolean | If true, VPS debugger logging is enabled for this session.**Default:** false (native default) |
| enableVpsDebuggerSavingFrameImage | Boolean | If true, attach a small JPEG thumbnail of localize frames to VPS debuggernetwork request events. Requires [enableVpsDebugger].**Default:** false (native default) |
| enableVpsMapLocalization | Boolean | If true, VPS map localization is enabled.VPS maps only exist in pre-scanned areas. Your device must be localized on a VPS map in orderfor VPS anchors to be placed with high accuracy.**Default:** true (native default) |
| initialVpsRequestsPerSecond | Float | Number of VPS localization requests per second to send the server prior to the firstsuccessful localization on a VPS map.**Default:** 1.0f (native default) |
| maxRequestsInTransitPerTarget | Int | Maximum number of concurrent localization requests per target.Limits how many in-flight cloud localization requests can be active for a single targetsimultaneously. Use 0 to apply the default value (2).**Default:** 0 (uses native default of 2) |
| minSharpnessScore | Float | Sharpness threshold below which a frame is flagged as too blurry.Higher scores mean sharper images. Only used when [enableBlurDetection] is true.**Default:** 0.0f (flags nothing, since the score is always non-negative) |
| universalLocalizationRequestsPerSecond | Float | Number of requests per second to send to server for universal localization.**Default:** 1.0f (native default) |
| universalLocalizationRequestTimeoutMs | Int | Timeout in milliseconds for universal localization requests.Responses in uncached areas may take 60+ seconds; subsequent requests are typically under1 second. Use 0 to apply the default value (90000 ms).**Default:** 90000 (90 seconds) |

---