Skip to content

Commit 41d5131

Browse files
committed
Update feature specification for Instant Usage: refine assumptions and enhance Quick Start Flow details
1 parent a761f96 commit 41d5131

1 file changed

Lines changed: 10 additions & 2 deletions

File tree

docs/feat-instant-usage.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,13 @@
11
# Feature Specification: Instant Usage (0-1 Point Calibration)
22

33
## 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.
55

66
## 2. Functional Requirements
77

88
### 2.1 Zero GPS Points
99
* **Measurement Tool**: Enabled if a manual `referenceDistance` (Set Scale) has been provided.
1010
* **Live Position**: Disabled.
11-
* **Assumptions**: None.
1211

1312
### 2.2 One GPS Point
1413
* **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
2524
* **Standard Calibration**: Use the existing robust Similarity/Affine/Homography pipeline.
2625
* **Scale Harmonization**: If a manual `referenceDistance` is provided, it can be used to constrain the Similarity fit (Phase 2).
2726

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.
34+
35+
2836
## 3. Technical Implementation
2937

3038
### 3.1 Math Layer (`src/geo/transformations.js`)

0 commit comments

Comments
 (0)