You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/feat-instant-usage.md
+10-2Lines changed: 10 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,13 @@
1
1
# Feature Specification: Instant Usage (0-1 Point Calibration)
2
2
3
3
## 1. Overview
4
-
The "Instant Usage" feature aims to provide immediate value to the user after importing a map, even before they have provided the minimum required two GPS reference points. By making sensible assumptions (e.g., North is up, standard floorplan scale), the app can enable the measurement tool and live position tracking earlier in the workflow.
4
+
The "Instant Usage" feature aims to provide immediate value to the user after importing a map, even before they have provided the minimum required two GPS reference points. By making sensible assumptions (perfect top down view and North is up) and only asking the user to provide a reference scale, the app can enable the measurement tool and live position tracking earlier in the workflow.
5
5
6
6
## 2. Functional Requirements
7
7
8
8
### 2.1 Zero GPS Points
9
9
***Measurement Tool**: Enabled if a manual `referenceDistance` (Set Scale) has been provided.
10
10
***Live Position**: Disabled.
11
-
***Assumptions**: None.
12
11
13
12
### 2.2 One GPS Point
14
13
***Measurement Tool**: Enabled if a manual `referenceDistance` has been provided.
@@ -25,6 +24,15 @@ The "Instant Usage" feature aims to provide immediate value to the user after im
25
24
***Standard Calibration**: Use the existing robust Similarity/Affine/Homography pipeline.
26
25
***Scale Harmonization**: If a manual `referenceDistance` is provided, it can be used to constrain the Similarity fit (Phase 2).
27
26
27
+
### 2.4 Quick Start Flow
28
+
1.**Import Map**: User selects an image (of a map or floorplan).
29
+
2. Ask the user to provide a reference scale so that once he did provide that reference scale he can measure any distances on the image
30
+
3.**Initial Suggestion**: App asks: "Are you on currently on this map? If yes where".
31
+
1.**One-Tap Calibration**: If user says yes ask him to tap their current location on the photo.
32
+
2.**Immediate Live View**: The app immediately starts showing the live GPS position on the photo using the 1-point fallback.
33
+
3.**Refinement**: As the user moves, they can see if the dot follows the map. If not, they add a second point to "pin" the scale and rotation.
0 commit comments