VpsLocalConstants
Public tunable constants for com.getwemap.sdk.positioning.wemapvpslocal.VpsLocalLocationSource.
Set any value before creating the location source; it is snapshotted into an internal config at construction time.
Properties
Whether the source may automatically switch between the back and front cameras while scanning.
Cluster dominance ratio: the best cluster's score must exceed the runner-up's by this factor for a fix to be accepted. Higher = stricter (fewer, more confident fixes).
Maximum delay between scan attempts, in milliseconds. Even when the user is stationary (so dead reckoning reports no drift), a scan fires at least this often to re-verify the fix.
Minimum device inclination (degrees) required to scan. Frames captured while the phone is tilted toward the floor/ceiling (inclination below this) are skipped, avoiding low-value queries. 90° = phone upright. Mirrors the online VPS source's foreground threshold.
Minimum delay between scan attempts, in milliseconds — the fastest cadence and the loop's poll granularity. Scans do not fire more often than this even while walking quickly. See RESCAN_DISTANCE_METERS for how the effective cadence adapts to movement.
Minimum frame sharpness (variance of the image Laplacian) required to reach inference. Motion-blurred frames below this are skipped before the expensive BoQ step, since they rarely localize. Higher = stricter (demands sharper frames). 0 disables the gate.
Number of top candidates kept after cosine reranking.
Distance, in meters, that pedestrian dead reckoning may carry the position from the last accepted fix before a re-scan is triggered to re-anchor it. Lower = tighter correction (more scans while walking); higher = fewer scans but more accumulated drift between fixes. This is what makes the cadence movement-aware: a walking user re-scans sooner than a stationary one.
Number of keyframes kept by the Hamming shortlist before cosine reranking.
Assumed step length, in meters, used by pedestrian dead reckoning (PDR) to advance the position between discrete VPS fixes. Each detected step moves the position by this distance along the current VPS-anchored heading. Fixed stride (not adaptive); matches the online VPS source's value.
Maximum fraction of low-texture image tiles (0..1) a captured frame may contain and still be sent to inference. Frames above this — blank walls, floors, ceilings — are skipped before the expensive BoQ step, since they rarely localize. 1.0 disables the gate.