First app open, explain offline + map download

oleg-rswll commented

2024-01-19 23:30:55 +00:00

Member

Overview
For the average person in the United States and Europe, where cell phone service coverage is really good and online maps are the primary navigation apps, offline maps are not as well known, and downloading maps within an app may be a new concept for many people.

Problem Statement

When opening the app for the first time, there is no explanation for why something else needs to be downloaded, after the app has already been downloaded; this could be a confusing experience. Not having clear information about why downloads are required, detracts average people from using the app for the first time and results in a number of uninstalls right after downloading.
Apps don't typically ask for additional downloads unless they are add-ons or expansion purchases. Asking to download without clarifying, may give the impression that additional modules are necessary just to run the app.

Criteria
Location permission prompt

Update text of the OS prompt for location from [iOS] "Determining your location is necessary for navigation and for saving your recently traveled track" to:
"Location permission is necessary to see your location on the map and for navigation instructions."

Test Connection

Before displaying the download prompt, test the network connection and ensure map are available for download. If not available, display a message:
"Connection cannot be established"

Automatic Download - 1st map

When zero maps have been downloaded (no maps are available on the device), no matter if this is the first launch of the app or not, automatically zoom into the current location and automatically start downloading the map without asking.
Bugs: Under certain conditions, after giving permission to location, does not automatically zoom into the phone's location. 1) When turning off screen after location permission prompt is displayed and then getting back to the app to give permission, it does not zoom in. 2) Giving "Allow Once" permission, but not downloading the map, then getting back to the app, giving permission again, it does not zoom in to the location. 3) Potentially other conditions, needs more testing.

Download progress - 1st map

During download explain offline maps and why a download is needed.
Download In Progress prompt:

"Offline Maps
[country]
[region / metro area]
Downloading
[progress indicator]
Organic Maps uses maps downloaded to your phone for navigation and fast search without a cellular service."

The text "Offline Maps" should be just a little larger than the bold map name.
Remove the download percentage number, too much detail, the progress circle indicator is enough to show progress.
Test spacing required for texts, as different languages need more space than English, for example German or Russian.
The progress circle indicator is 2 wide pixels, change it to 3 pixels to be consistent with other icons.

Download prompt - 2nd map

After the first map was downloaded automatically, the next map download will required the person to press the download button.
Display the following text to explain again the need for downloading:

"Offline Maps
Download to get started
Organic Maps uses maps downloaded to your device for navigation and fast search without a cellular service.

[country]
[state/province] - [area]
xxMB"

Download progress - 2nd map
"Offline Maps
[country]
[region / metro area]
Downloading
[progress indicator]

To download maps for additional regions, zoom in to new areas on the map"

When at least two maps have been downloaded, display the standard message that does not include explanation text.

Design
https://www.figma.com/design/K26gHeLViIbsPAmsHigHk1/Organic-Maps---First-Open?node-id=2-15&t=DbmE56C6BqCkt3h7-1

**Overview** For the average person in the United States and Europe, where cell phone service coverage is really good and online maps are the primary navigation apps, offline maps are not as well known, and downloading maps within an app may be a new concept for many people. **Problem Statement** - When opening the app for the first time, there is no explanation for why something else needs to be downloaded, after the app has already been downloaded; this could be a confusing experience. Not having clear information about why downloads are required, detracts average people from using the app for the first time and results in a number of uninstalls right after downloading. - Apps don't typically ask for additional downloads unless they are add-ons or expansion purchases. Asking to download without clarifying, may give the impression that additional modules are necessary just to run the app. **Criteria** _Location permission prompt_ - Update text of the OS prompt for location from [iOS] "Determining your location is necessary for navigation and for saving your recently traveled track" to: "Location permission is necessary to see your location on the map and for navigation instructions." _Test Connection_ - Before displaying the download prompt, test the network connection and ensure map are available for download. If not available, display a message: "Connection cannot be established" _Automatic Download - 1st map_ - When zero maps have been downloaded (no maps are available on the device), no matter if this is the first launch of the app or not, automatically zoom into the current location and automatically start downloading the map without asking. - Bugs: Under certain conditions, after giving permission to location, does not automatically zoom into the phone's location. 1) When turning off screen after location permission prompt is displayed and then getting back to the app to give permission, it does not zoom in. 2) Giving "Allow Once" permission, but not downloading the map, then getting back to the app, giving permission again, it does not zoom in to the location. 3) Potentially other conditions, needs more testing. _Download progress - 1st map_ - During download explain offline maps and why a download is needed. - Download In Progress prompt: _"**Offline Maps**_ _[country]_ _[region / metro area]_ _Downloading_ _[progress indicator]_ _Organic Maps uses maps downloaded to your phone for navigation and fast search without a cellular service._" - The text "Offline Maps" should be just a little larger than the bold map name. - Remove the download percentage number, too much detail, the progress circle indicator is enough to show progress. - Test spacing required for texts, as different languages need more space than English, for example German or Russian. - The progress circle indicator is 2 wide pixels, change it to 3 pixels to be consistent with other icons. _Download prompt - 2nd map_ - After the first map was downloaded automatically, the next map download will required the person to press the download button. - Display the following text to explain again the need for downloading: _"**Offline Maps**_ _Download to get started_ _Organic Maps uses maps downloaded to your device for navigation and fast search without a cellular service._ [country] [state/province] - [area] xxMB" _Download progress - 2nd map_ _"**Offline Maps**_ _[country]_ _[region / metro area]_ _Downloading_ _[progress indicator]_ _To download maps for additional regions, zoom in to new areas on the map_" - When at least two maps have been downloaded, display the standard message that does not include explanation text. **Design** https://www.figma.com/design/K26gHeLViIbsPAmsHigHk1/Organic-Maps---First-Open?node-id=2-15&t=DbmE56C6BqCkt3h7-1

oleg-rswll commented

2024-01-19 23:42:49 +00:00

Author

Member

assigned to @kirylkaveryn

assigned to `@kirylkaveryn`

biodranik commented

2024-01-19 23:47:53 +00:00

(Migrated from github.com)

Is it for iOS? Is it about the dialog that is seen after a user has:

Enabled location permission.
Location was found and zoomed in.
On WiFi, the zoomed in map starts to download automatically. On cellular there is a download button

?

When and how the clarifying text should be displayed? It should not require any additional actions from a user. What is the proposed UI/UX?

Is it for iOS? Is it about the dialog that is seen after a user has: 1. Enabled location permission. 2. Location was found and zoomed in. 3. On WiFi, the zoomed in map starts to download automatically. On cellular there is a download button ? When and how the clarifying text should be displayed? It should not require any additional actions from a user. What is the proposed UI/UX?

oleg-rswll commented

2024-01-20 01:14:05 +00:00

Author

Member

This is a simple addition of text to an existing message, nothing else changes. The current map download message has no explanation, this text explains why a download is needed. This is for both iOS and Android.

biodranik commented

2024-01-20 05:47:39 +00:00

(Migrated from github.com)

Will it fit on the screen of smaller/older devices?
Will the white dialog's background cover all of the map space? Now the map is visible/usable around it.
Will it be always displayed, even after the first launch, on each zoom-in to the non-downloaded country?

1. Will it fit on the screen of smaller/older devices? 2. Will the white dialog's background cover all of the map space? Now the map is visible/usable around it. 3. Will it be always displayed, even after the first launch, on each zoom-in to the non-downloaded country?

oleg-rswll commented

2024-01-20 18:00:39 +00:00

Author

Member

Will it fit on the screen of smaller/older devices?

As seen on the screenshot, there is more than enough space for all screen sizes. The current message is very small, the new text will make it bigger but still plenty of space.

Will the white dialog's background cover all of the map space? Now the map is visible/usable around it.

This scenario is only for when zero maps have been downloaded, there are no maps at this point, and when the dialog appears, the background area where the map is usually located, is a beige grey area. Not clear what this question is referring to.

Will it be always displayed, even after the first launch, on each zoom-in to the non-downloaded country?

This is for when zero maps are downloaded, no matter if this is the first launch of the app or not. This is about providing information to people about how to get started with the app. It's likely that today when people after downloading the app, first open the app, and they are told to download something else without any explanation, so they just uninstall the app.

![image](/uploads/73d4a07a4a50c034f23a27c18ae70a35/478330bd-e080-4491-8d1b-b12a45ade1b0) > Will it fit on the screen of smaller/older devices? As seen on the screenshot, there is more than enough space for all screen sizes. The current message is very small, the new text will make it bigger but still plenty of space. > Will the white dialog's background cover all of the map space? Now the map is visible/usable around it. This scenario is only for when zero maps have been downloaded, there are no maps at this point, and when the dialog appears, the background area where the map is usually located, is a beige grey area. Not clear what this question is referring to. > Will it be always displayed, even after the first launch, on each zoom-in to the non-downloaded country? This is for when zero maps are downloaded, no matter if this is the first launch of the app or not. This is about providing information to people about how to get started with the app. It's likely that today when people after downloading the app, first open the app, and they are told to download something else without any explanation, so they just uninstall the app.

biodranik commented

2024-01-20 18:12:34 +00:00

(Migrated from github.com)

Not every screen is big, and font size may be also big. The size of the background is likely hard-coded and it may be not easy to automatically resize it for every translation (a French or a German one will take more space, for example).
There are screens smaller than in this screenshot:

Not every screen is big, and font size may be also big. The size of the background is likely hard-coded and it may be not easy to automatically resize it for every translation (a French or a German one will take more space, for example). There are screens smaller than in this screenshot: ![выява](/uploads/d0b18e2a35a5d4d74ceb600c4de98e07/1fef1646-4830-4492-859a-3cdd63e5bf66)

oleg-rswll commented

2024-01-20 19:32:39 +00:00

Author

Member

Probably no need to auto-resize, just pick one size that fits all languages and if there is extra white space for some languages, no worries.

And the text can be made a bit shorter/tighter.

Probably no need to auto-resize, just pick one size that fits all languages and if there is extra white space for some languages, no worries. And the text can be made a bit shorter/tighter.

oleg-rswll commented

2024-01-20 20:59:53 +00:00

Author

Member

Here's an example on that small screen, without increasing the width of the message.

![image](/uploads/c282496db170e3eadafff80021acf89c/e23631b8-5293-4781-a0f1-5473134dac71) Here's an example on that small screen, without increasing the width of the message.

Jean-BaptisteC commented

2024-01-20 21:31:47 +00:00

Member

This text is not fit if users increase size police.
Here an example with max size police (on phone with big screen)

This text is not fit if users increase size police. Here an example with max size police (on phone with big screen) <img src="/uploads/2698270330912d999880f73d92ad5f01/f095c032-3ac1-4e52-a6f0-9c0478e881a4" height=300 />

oleg-rswll commented

2024-01-20 21:47:23 +00:00

Author

Member

@Jean-BaptisteC based on your screenshot there is currently a problem with increased size font already today. So there needs to be a decision about when the entire app will start supporting these large fonts (not just the Map Download dialogue). Maybe this particular issue is the right time to start taking on this work, or maybe that scope is too large right now and we can keep this issue's scope narrow to address just the informational part.

`@Jean-BaptisteC` based on your screenshot there is currently a problem with increased size font already today. So there needs to be a decision about when the entire app will start supporting these large fonts (not just the Map Download dialogue). Maybe this particular issue is the right time to start taking on this work, or maybe that scope is too large right now and we can keep this issue's scope narrow to address just the informational part.

biodranik commented

2024-01-21 02:06:51 +00:00

(Migrated from github.com)

unassigned @kirylkaveryn

unassigned `@kirylkaveryn`

LinuxinaBit commented

2024-03-27 17:14:09 +00:00

(Migrated from github.com)

mentioned in issue #7707

oleg-rswll commented

2024-06-08 23:25:35 +00:00

Author

Member

mentioned in issue #8214

oleg-rswll commented

2024-06-26 23:44:38 +00:00

Author

Member

changed title from {-Update-} first map download message to {+Explain why map downloads are needed, in+} first map download message

changed title from **{-Update-} first map download message** to **{+Explain why map downloads are needed, in+} first map download message**

oleg-rswll commented

2024-06-27 00:13:11 +00:00

Author

Member

changed title from {-E-}xplain why map downloads are needed{-, in first map download message-} to {+On first map download, e+}xplain why map downloads are needed

changed title from **{-E-}xplain why map downloads are needed{-, in first map download message-}** to **{+On first map download, e+}xplain why map downloads are needed**

oleg-rswll commented

2024-12-24 04:22:13 +00:00

Author

Member

changed title from On first map download, explain {-why-} map downloads{- are needed-} to On first map download, explain {+need for+} map downloads

changed title from **On first map download, explain {-why-} map downloads{- are needed-}** to **On first map download, explain {+need for+} map downloads**

oleg-rswll commented

2025-01-13 19:45:45 +00:00

Author

Member

changed title from On first {-map download, explain need for-} map downloads to On first {+app open, explain offline and+} map downloads

changed title from **On first {-map download, explain need for-} map downloads** to **On first {+app open, explain offline and+} map downloads**

oleg-rswll commented

2025-01-13 19:46:10 +00:00

Author

Member

changed title from {-On f-}irst app open, explain offline and map downloads to {+F+}irst app open, explain offline and map downloads

changed title from **{-On f-}irst app open, explain offline and map downloads** to **{+F+}irst app open, explain offline and map downloads**

oleg-rswll commented

2025-01-13 19:46:24 +00:00

Author

Member

changed title from First app open, explain offline {-and-} map downloads to First app open, explain offline {+++} map downloads

changed title from **First app open, explain offline {-and-} map downloads** to **First app open, explain offline {+++} map downloads**

oleg-rswll commented

2025-01-13 19:46:49 +00:00

Author

Member

changed title from First app open, explain offline + map download{-s-} to First app open, explain offline + map download

changed title from **First app open, explain offline + map download{-s-}** to **First app open, explain offline + map download**

oleg-rswll commented

2025-03-28 07:34:41 +00:00

Author

Member

This would be a good one to do for next release. @kirylkaveryn

👍 1

Rows
Columns

First app open, explain offline + map download #7210