Form filling: Geopoint with no appearance

[alyblenkin]

User stories

Feedback when trying again

1. As a user attempting to get better accuracy by trying again
   I want to see the progress indicator
   So that I know something is actively happening and not “saved” yet

2. Given I’ve clicked “get location”
   When I see the spinner and the button is disabled
   Then I know I need to wait until the location is captured and the button becomes active

3. As a user wanting to get good accuracy
   I want to see feedback on the prompt
   So that I know whether the location accuracy is adequate or not

Displaying accuracy as soon as the location is available

1. As a user wanted to save a location
   When I look at the location dialog
   Then I should see the accuracy as soon as it's available

2. As a user wanted to save a location
   When I look at the location dialog
   I shouldn’t see latitude, longitude, and altitude yet since I do not commonly use them, but I want to know the time taken to capture the location.

Once the location is captured

1. Given I’ve saved the location
   When I look at the container
   Then I should see “<poor|good> location: Accuracy: 14.15m, Latitude: 62.99352, Longitude: 98.61553"
   So that I know it was adequate

Error messages

1. Given I haven’t enabled location permissions
   And the question is required
   When I click submit
   Then I should see a stacked error message

Read-only

1. Would deviate and show inline
   But they still want to know if it’s good accuracy

Designs

Figma

Options:

• Get location
• Save location
• Retry getting location

Notes

Future iterations

• Maybe make the accuracy number larger in the dialog

[latin-panda]

Test plan

• Geopoint is required and the value is null
  • Prevent saving the form and highlight the question as required.
• Geopoint is disabled
  • Shows the question label and the readonly info of coordinates. It cannot change the value
  • Shows only the question label and nothing else when there aren't coordinates. It cannot change the value
• Geopoint has a relevant criteria
  • Shows question label and option to catch location when it becomes relevant.
  • Doesn't show anything when the question is not relevant.
• User wants to retry to get the location
  • Allows changing the question value by getting new location coordinates.
  • Allows canceling and keeping the previous value
  • No autosave on retry
• Geopoint value is correct
  • The value is formatted in the correct order and not missing information: Space-separated list of latitude (decimal), longitude (decimal), altitude (decimal), and accuracy (decimal).
  • The value is null when the question isn't answered.
• Geopoint with no parameter
  • It captures location when default value thresholds are reached: capture-accuracy's default value is 5, and warning-accuracy's default value is 100
  • Autosave
• Geopoint with parameter
  • Sames as Geopoint with no parameter but according to the configured parameters' value
  • Autosave
• Geopoint's capture-accuracy is zero
  • Keep on accessing the location until the user explicitly chooses to capture the point
  • Shows warning if accuracy reaches warning-accuracy
• Geopoint's warning-accuracy is zero
  • Never shows warning
• Geopoint has captured the location
  • It shows Latitude, Longitude, altitude, accuracy, time elapsed
  • Save, cancel and try again buttons works.
• Geopoint has no permission to capture the location
  • Shows basic troubleshooting steps.
• Geopoint UI display
  • Reacts to translation changes
  • Responsive design - should stack elements
  • It flows with other question types (similar styles: color, border, etc.)
  • Cross-browser: Chrome, Firefox, Safari, Chrome for Android, Chrome for iPhone

Sample forms for testing

1-geopoint-zero-accuracy.xlsx
1-geopoint-relevant-disabled.xlsx
1-geopoint-default-required.xlsx
1-geopoint.xlsx